3.6.2 Updating an instance environment

This subsection describes how to change an instance environment of PFM - RM for Platform while the Performance Management system is running.

Organization of this subsection

(1) In Windows
(2) In UNIX

(1) In Windows

To update an instance environment, check the instance name, and then update individual instance environment settings. Use the PFM - RM host to set individual instance environment settings.

Use the following table to check the information to be updated beforehand.

Table 3‒34: Instance environment settings for PFM - RM for Platform (for Windows)
No.	Item name	Description	Setting	Default
1	`UseCommonAccount`^#	Specifies whether to use common account information.	Specify one of the following values: `Y`: Use `N`: Do not use	Previous setting
2	`Interval`	Specifies the collection interval for the collection process.	Specify a value in the range from 60 to 3,600 (seconds).
3	`Std_Category`	Specifies whether the collection process is to collect basic information (`PI` and `PI_CPU` records).	Specify one of the following values: `Y`: Collect `N`: Do not collect
4	`Disk_Category`	Specifies whether the collection process is to collect disk information (`PI_PDSK` and `PI_LDSK` records).	Specify one of the following values: `Y`: Collect `N`: Do not collect
5	`Network_Category`	Specifies whether the collection process is to collect network information (`PI_NET` record).	Specify one of the following values: `Y`: Collect `N`: Do not collect
6	`Ps_Category`	Specifies whether the collection process is to collect process information (`PD_APS`, `PD_ASVC`, `PD_APP2`, `PD_APPC`, and `PD_APPD` records).	Specify one of the following values: `Y`: Collect `N`: Do not collect
7	`RMHost_User`^#	Specifies the user account used at the PFM - RM host.	From 1 to 256 bytes of characters are permitted. The tab character is not permitted.
8	`RMHost_Password`^#	Specifies the password for the account used at the PFM - RM host. The characters entered in this item are not displayed on the screen. If you enter this password, you are prompted to re-enter the same password.	From 1 to 256 bytes of characters are permitted. The tab character is not permitted.
9	`RMHost_Domain`^#	Specifies the domain name to which the account used at the PFM - RM host belongs. There is no need to specify this item if the account belongs to a work group.	From 0 to 256 bytes of characters are permitted. The tab character is not permitted.
10	`SSH_Client`	Specifies an absolute path for the execution module (`plink.exe`) of the SSH client (PuTTY). Even if the file path contains a space, there is no need to enclose the file path in double quotation marks (`"`). There is no need to specify this item if all of the monitored hosts in the instance are running Windows.	From 0 to 256 bytes of characters are permitted. The tab character is not permitted.
11	`Perl_Module`	Specifies an absolute path for the execution module (`perl.exe`) of Perl (ActivePerl). Even if the file path contains a space, there is no need to enclose the file path in double quotation marks (`"`). There is no need to specify this item if all of the monitored hosts in the instance are running Windows.	From 0 to 256 bytes of characters are permitted. The tab character is not permitted.
12	`Log_Size`	Specifies the maximum size of one agent log file.	Specify a value in the range from 1 to 32 (megabytes).

#: These items are not displayed, depending on the environment or settings. For details about the conditions and input values that prevent these items from being displayed, see Table 3-11.

To check the name of an instance, use the jpcconf inst list command. To update an instance environment, use the jpcconf inst setup command.

To update multiple instance environments, repeat the procedure described below.

To update an instance environment:

Check the name of the instance.

Execute the jpcconf inst list command with the service key that indicates PFM - RM for Platform specified.
```
jpcconf inst list -key RMPlatform
```
For example, if the set instance name is inst1, the command displays inst1.
If any services of PFM - RM for Platform are running in the instance environment that you want to update, stop all of them.

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

If a service of the instance environment that is to be updated is running during execution of the jpcconf inst setup command, a confirmation message is displayed to enable you to stop the service. When you stop the service, the update processing resumes. If you do not stop the service, the update processing is canceled.
Execute the jpcconf inst setup command with the service key that indicates PFM - RM for Platform and the instance name specified.

For example, to update an instance environment whose instance name is inst1, execute the following command:
```
jpcconf inst setup -key RMPlatform -inst inst1
```
This example shows execution in the interactive mode, but you can also execute the jpcconf inst setup command in the non-interactive mode.

For details about how to execute this command in the non-interactive mode, see 3.1.4(2) Setting up an instance environment.

If you execute the jpcconf inst setup command in the non-interactive mode, the procedure in step 4 is not required.
Update the instance environment for PFM - RM for Platform.

Enter the applicable items listed in Table 3-34 Instance environment settings for PFM - RM for Platform (for Windows) according to the command's instructions. The current settings are displayed. To not change a displayed value, press the Enter key. When all entries have been made, the instance environment is updated.
Restart the services for the updated instance environment.

For details about how to start services, see the chapter that describes starting and stopping Performance Management 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

(2) In UNIX