Hitachi

JP1 Version 12 JP1/Performance Management - Remote Monitor for Virtual Machine Description, User's Guide and Reference


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‒11: 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

Offset

Specifies the offset value for starting data collection.

1 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, VCI, PODI, POCI, and PODD records) to a temporary performance information file.

# For the PODI and POCI records, CPU-related fields are output.

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, VMI, PODI, POCI, and PODD records) to a temporary performance information file.

#: For the PODI and POCI records, memory-related fields are output.

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, VLDI, VDKD, PODI, POCI, and PODD records) to a temporary performance information file.

#: For the PODI and POCI records, disk-related fields are output.

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, VNI, PODI, POCI, and PODD records) to a temporary performance information file.

#: For the PODI and POCI records, network-related fields are output.

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_Type

Specifies the type of the SSH client.

Either of the following strings (lowercase):

  • putty

    plink.exe of PuTTY is used as the SSH client.

  • windows

    ssh.exe of OpenSSH (which comes with Windows Server 2019) is used as the SSH client.

Previous setting

SSH_Client

Specifies the absolute path of the execution module (plink.exe or ssh.exe) of the SSH client (PuTTY or OpenSSH). . 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‒12: Instance information items that can be updated for each virtual environment

Item

Virtual environment

VMware

Hyper-V

KVM

Docker environment

Podman environment

logical partitioning feature

VM_Type

N

N

N

N

N

N

Interval

Y

Y

Y

Y

Y

Y

Offset

Y

Y

Y

Y

Y

Y

Std_Category

Y

Y

Y

Y

Y

Y

Cpu_Category

Y

Y

Y

Y

Y

Y

Memory_Category

Y

Y

Y

Y

Y

Y

Disk_Category

Y

Y

Y

Y

Y

Y

Network_Category

Y

Y

Y

Y

Y

Y

HostUserID

Y

Y

Y

Y

Y

--

HostPassword

Y

Y

Y

Y

Y

--

HostDomain

Y

Y

Y

Y

Y

--

SSH_Type

--

--

Y

--

Y

--

SSH_Client

--

--

Y

--

Y

--

Log_Size

Y

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:

  1. 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.

  2. 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.

  3. 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
  4. 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.

  5. 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.