2.4.2 Updating an instance environment

To update an instance environment, confirm the instance name and then update the instance information. You specify instance information from the PFM - RM host.

Use the following table to confirm the information you need to update.

Table 2‒12: PFM - RM for Virtual Machine instance information
Item	Explanation	Value that can be set	Default value
`VM_Type`	Specifies the type of virtual environment to be monitored.	Cannot be changed	Previous setting
`Interval`	Specifies the collection process execution interval.	60 through 3,600 (units: seconds)	Previous setting
`Std_Category`	Specifies whether the collection process outputs the basic information (PI, VI, and VM records) to a temporary performance information file.	Either of the following values: `Y`: Outputs the information. `N`: Does not output the information.	Previous setting
`Cpu_Category`	Specifies whether the collection process outputs the CPU information (HCI and VCI records) to a temporary performance information file.	Either of the following values: `Y`: Outputs the information. `N`: Does not output the information.	Previous setting
`Memory_Category`	Specifies whether the collection process outputs the memory information (HMI and VMI records) to a temporary performance information file.	Either of the following values: `Y`: Outputs the information. `N`: Does not output the information.	Previous setting
`Disk_Category`	Specifies whether the collection process outputs the disk information (HPDI, VPDI, HLDI, and VLDI records) to a temporary performance information file.	Either of the following values: `Y`: Outputs the information. `N`: Does not output the information.	Previous setting
`Network_Category`	Specifies whether the collection process outputs the network information (HNI and VNI records) to a temporary performance information file.	Either of the following values: `Y`: Outputs the information. `N`: Does not output the information.	Previous setting
`HostUserID`	Specifies the user ID of the PFM - RM host.	Character string not exceeding 256 bytes. Note that the following character cannot be used: Tab character	Previous setting
`HostPassword`	Specifies the password for the user ID that was specified in `HostUserID`. The characters entered for this item are not displayed on the screen. When you enter a value for this item, the system will ask you to re-enter the value.	Character string not exceeding 256 bytes. Note that the following character cannot be used: Tab character	Previous setting
`HostDomain`	Specifies the name of the domain that the PFM - RM host belongs to. This specification is unnecessary if the host belongs to a work group.	Character string not exceeding 256 bytes. Note that the following character cannot be used: Tab character	Previous setting
`SSH_Client`	Specifies the absolute path of the SSH client (PuTTY) execution module (`plink.exe`). You do not need to enclose the path name in double quotation marks (`"`) even if it includes spaces.	Character string not exceeding 256 bytes. Note that the following character cannot be used: Tab character	Previous setting
`Log_Size`	Specifies the maximum size of a file for the collected log.	`1`-`32` (megabytes) A value of 16 or greater is recommended.	Previous setting
`UseVcpuMax`	Specifies which is to be used as the CPU resource clock frequency: the frequency assigned to the virtual machine or the clock frequency of the physical CPU. To use the frequency assigned to the virtual machine, specify `Y`. To use the frequency of the physical CPU, specify `N`.	`{Y\|N}`	Previous setting

The items that need to be specified during instance environment setup depend on the virtual environment to be monitored. This also applies to the items that can be updated. The table below shows whether the items can be updated for each virtual environment.

Table 2‒13: Instance information items that can be updated for each virtual environment
Item	Virtual environment
Item	VMware	Hyper-V	logical partitioning feature	KVM	Docker environment
`VM_Type`	N	N	N	N	N
`Interval`	Y	Y	Y	Y	Y
`Std_Category`	Y	Y	Y	Y	Y
`Cpu_Category`	Y	Y	Y	Y	Y
`Memory_Category`	Y	Y	Y	Y	Y
`Disk_Category`	Y	Y	Y	Y	Y
`Network_Category`	Y	Y	Y	Y	Y
`HostUserID`	Y	Y	--	Y	Y
`HostPassword`	Y	Y	--	Y	Y
`HostDomain`	Y	Y	--	Y	Y
`SSH_Client`	--	--	--	Y	--
`Log_Size`	Y	Y	Y	Y	Y
`UseVcpuMax`	Y	--	--	--	--

Legend:

Y: Can be updated

N: Cannot be updated

--: Updating is not necessary because the setting has no effect on the PFM - RM for Virtual Machine operation

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

The procedure for updating the instance environment is as follows. To update multiple instance environments, repeat this procedure.

To update the instance environment:

Confirm the instance name.

Specify the service key indicating PFM - RM for Virtual Machine, and then execute the jpcconf inst list command.
```
jpcconf inst list -key RMVM
```
If the instance name that was set is inst1, inst1 is displayed.
If any PFM - RM for Virtual Machine services are active for the instance environment you are updating, stop them.

For details about how to stop services, see the chapter that explains startup and termination of Performance Management in the JP1/Performance Management User's Guide.

If the instance environment you are updating is active when you try to execute the jpcconf inst setup command, a confirmation message is displayed and you can stop the service. If you stop the service, the updating process continues. If you do not stop the service, the updating process stops.
Specify both the service key indicating PFM - RM for Virtual Machine and the instance name, and then execute the jpcconf inst setup command.

To update an instance environment in which the instance name is inst1, specify the following and then execute the command:
```
jpcconf inst setup -key RMVM -inst inst1
```
Update the instance information of PFM - RM for Virtual Machine.

Enter the items listed in Table 2-12 as instructed by the command. The current settings are displayed. If you choose not to change the displayed value, simply press the Enter key. Once all information has been input, the instance environment is updated.
Restart the service(s) of the updated instance environment.

For details about how to start services, see the chapter that explains startup and termination of Performance Management in the JP1/Performance Management User's Guide.

For details about commands, see the chapter that explains commands in the manual JP1/Performance Management Reference.

To Page Top