3.6.3 Settings for updating an instance environment

This subsection describes how to update an instance environment.

You must repeat this procedure for each instance environment you wish to update.

Use the jpcconf inst list command to find the instance name; use the jpcconf inst setup command to update the instance environment.

To update an instance environment:

1. Find the instance name.

   Execute the jpcconf inst list command with the service key specified that indicates the PFM - Agent for Enterprise Applications running in the instance environment.

   For example, to check the instance name of PFM - Agent for Enterprise Applications, execute the following command:

   jpcconf inst list -key EAP

   If the specified instance name is o246bciSD500, the command displays o246bciSD500.

2. Check the information to be updated.

   The following table lists and describes the instance environment information that can be updated.

   Table 3‒18: Instance information for PFM - Agent for Enterprise Applications

   Item	Description	Permitted value	Default value
   SID	ID of the SAP system that is to be monitored	Character string (up to 8 bytes)	Previous setting
   SERVER#1	SAP instance name that is to be monitored (the SAP instance name that has a dialog service, and which can be verified by transaction code SM51)	Character string (up to 20 bytes)	Previous setting
   ASHOST#1	Host name of the connection-target application server (the SAP local host name, which can be verified by transaction code SM51)	Character string (up to 100 bytes)	Previous setting
   SYSNR	System number of the SAP system	Numeric characters (up to 2 bytes)	Previous setting
   CLIENT	Client name to which the SAP user belongs (system number assigned to the connection-target dialog instance)	Numeric characters (up to 3 bytes)	Previous setting
   USER	SAP user name#2	Character string (up to 12 bytes)	Previous setting
   EXTPWD	Whether an extended password is to be used to connect to the SAP system	Y or N Y: Use an extended password. N: Do not use an extended password.	Previous setting
   PASSWD	Password of the SAP user#2	When an extended password is used: Up to 40 single-byte characters When an extended password is not used: Up to 8 single-byte characters	Previous setting (the value is not displayed)
   DELAYCONNECT	Timing of the connection to the SAP system	Y or N: Y: Connect to the SAP system only when performance data is collected. The Agent Collector service is started regardless of the operating status of the SAP system at the time of connection establishment. N: Connect to the SAP system when the Agent Collector service starts. The Agent Collector service is not started if the SAP system is not active at the time of connection establishment.	Previous setting

   #1

   To use the remote monitoring function, you have to set both the SAP instance name to be monitored and the host name of the SAP system.

   #2

   For details about SAP users and passwords, see 3.1.5(2) Creating SAP users that are to be used by PFM - Agent for Enterprise Applications.

3. If the PFM - Agent for Enterprise Applications service is active for the instance environment that is to be updated, stop it.

   If the service is still active for the instance environment that is to be updated when you execute the jpcconf inst setup command, a confirmation message is displayed to enable you to stop the service. If you stop the service, update processing resumes; if you do not stop the service, update processing is canceled.

4. Execute the jpcconf inst setup command, in which you have specified the service key and instance name of the PFM - Agent for Enterprise Applications for the instance environment that you wish to update.

   For example, if you are updating the instance environment for the PFM - Agent for Enterprise Applications with instance name o246bciSD500, execute the command as follows:

   jpcconf inst setup -key EAP -inst o246bciSD500

   Although you can use any instance name in PFM - Agent for Enterprise Applications, to simplify management we recommend that you use an instance name that identifies the SAP system that is to be monitored. Normally, a name in the format host-name_SAP-system-ID_system-number is assigned to an instance for an SAP system.

   Note that no underscore (_) is allowed in the jpcconf inst setup command. For example, if the instance name of SAP system is o246bci_SD5_00, specify o246bciSD500 as the instance name of PFM - Agent for Enterprise Applications.

5. Update the instance information for SAP system.

   Enter the information shown in Table 3-18 in accordance with the command's instructions. The current settings are displayed (except for the value of passwd). To use a displayed value, press the Enter key. When all entries are completed, the instance environment is updated.

6. Restart the services in the updated instance environment.

   For details on how to start and stop services, see the chapter that describes starting and stopping services in the JP1/Performance Management User's Guide. For details about the commands, see the chapter that describes commands in the manual JP1/Performance Management Reference.

To Page Top