4.9.1 Updating an instance environment
When you update an instance environment in a cluster system, you first check the logical host name and the name of the instance that you want to update. You update the instance information on the executing node.
Before you change an information item, see the sections below in advance:
For details about Oracle instance information, see your Oracle documentation.
Use the jpcconf ha list command to check the logical host name and the instance name. To update an instance environment, use the jpcconf inst setup command.
Updating an instance environment involves the steps described below. To update multiple instance environments, repeat the procedure for each instance environment.
-
Check the logical host name and the instance name.
Execute the jpcconf ha list command specified with the service key that indicates the PFM - Agent for Oracle in the instance environment that is to be updated:
For example, if you want to check the logical host name and instance name of PFM - Agent for Oracle, execute the following command:
- Windows:
-
jpcconf ha list -key Oracle
- UNIX:
-
jpcconf ha list -key Oracle
For example, if you execute the command in the system with logical host name jp1_Ora and instance name Ora1, the command will list the following information:
-
If the PFM - Agent for Oracle service is active in the instance environment that is to be updated, use the cluster software to stop the service.
-
If the shared disk is unmounted when you stop the service, use the cluster software or the volume manager to mount it.
-
Execute the jpcconf inst setup command specified with the service key and the instance name that indicate the PFM - Agent for Oracle in the instance environment that is to be updated.
For example, if you are updating the instance environment with logical host name jp1_Ora and instance name Ora1, execute the following command:
- Windows:
-
jpcconf inst setup -key Oracle -lhost jp1_Ora -inst Ora1
- UNIX:
-
jpcconf inst setup -key Oracle -lhost jp1_Ora -inst Ora1
-
Update the instance information for Oracle.
In Windows, enter the information shown in 2.4.2 Updating an instance environment in accordance with the command's instructions. In Unix, enter the information shown in 3.4.2 Updating an instance environment in accordance with the command's instructions. The current settings are displayed (except for the value of oracle_passwd). To use the displayed value, press the Enter key. When you have finished entering information, the instance environment is updated.
-
Use the cluster software to restart the service in the updated instance environment.
For details about the starting the service, see the chapter on starting and stopping Performance Management in a cluster system in the JP1/Performance Management User's Guide.
- Notes:
-
-
If you want to change an item that cannot be updated, delete the instance environment and then re-create it.
-
To change an account for monitoring Oracle, use the following procedure:
1. Delete the objects created by the account you want to change.
2. Register new objects after you change the account.
Performance data is not deleted when an account is changed.
For details about how to delete objects, see the following sections:
Windows: see 2.2.2(1)(b) Deleting the objects registered in the Oracle Database
UNIX: see 3.2.2(1)(b) Deleting the objects registered in the Oracle Database
For details about how to register objects, see the following sections:
Windows: see 2.1.4(4)(b) Registering objects in the Oracle Database
UNIX: see 3.1.4(4)(b) Registering objects in the Oracle Database
-
For details about the commands used in this procedure, see the chapter on the commands in the manual JP1/Performance Management Reference.