Job Management Partner 1/Performance Management - Agent Option for Virtual Machine Description, User's Guide and Reference

[Contents][Glossary][Index][Back][Next]

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 - Agent host.

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

Table 2-9 PFM - Agent 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
VM_Host Specifies the host name of the virtual environment to be monitored. Character string not exceeding 256 bytes. Note that the following character cannot be used:
  • Tab character
 Previous setting
Security Specifies whether to use SSL for communicating with the virtual environment to be monitored. {0|1}
0: SSL is not used.
1: SSL is used.
Because Hyper-V does not support SSL, 0 is always set, even if 1 is specified.		 Previous setting
Port Specifies the port number to use for communicating with the virtual environment to be monitored. 0-65535
If 0 is specified, the following value is used according to the Security setting:

Security=0 (SSL is not used.)
HTTP's default port number 80

Security=1 (SSL is used.)
HTTPS's default port number 443
 Previous setting
UserID# Specifies the user ID for connecting to the virtual environment to be monitored. Character string not exceeding 256 bytes. Note that the following character cannot be used:
  • Tab character
 Previous setting
Password Specifies the password for connecting to the virtual environment to be monitored. 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
Domain Specifies the domain name to be used for connecting the virtual environment to be monitored. Character string not exceeding 256 bytes. Note that the following character cannot be used:
  • Tab character
If the PFM - Agent host does not belong to a domain (such as when it runs in a workgroup), leave this item blank.		 (None)
HostUserID Specifies the user ID of the PFM - Agent host. Character string not exceeding 256 bytes. Note that the following character cannot be used:
  • Tab character
 (None)
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
 (No password)
HostDomain Specifies the domain name of the PFM - Agent host. Character string not exceeding 256 bytes. Note that the following character cannot be used:
  • Tab character
If the PFM - Agent host does not belong to a domain (such as when it runs in a workgroup), leave this item blank.		 (None)
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
Store Version Specifies the Store version to be used. Cannot be changed Previous setting

#
When the virtual environment to be monitored is VMware, the account that is specified must have at least read-only permissions for VMware roles. For details about how to specify permissions, see the VMware documentation.

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-10 Instance information items that can be updated for each virtual environment

Item Virtual environment
VMware Hyper-V
VM_Host Y Y
Security Y N
Port Y N
UserID Y Y
Password Y Y
Domain N Y
HostUserID Y Y
HostPassword Y Y
HostDomain Y Y
Log_Size Y Y

Legend:
Y: Can be updated
N: Updating is not necessary because the setting has no effect on the PFM - Agent 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 - Agent for Virtual Machine, and then execute the jpcconf inst list command.
     
jpcconf inst list -key VM
    If the instance name that was set is vm-host, vm-host is displayed.

  2. If any PFM - Agent 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 Job Management Partner 1/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 - Agent 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 vm-host, specify the following and then execute the command:
     
jpcconf inst setup -key VM -inst vm-host

  4. Update the instance information of PFM - Agent for Virtual Machine.
    Enter the items listed in Table 2-9 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 Job Management Partner 1/Performance Management User's Guide.

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

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2009, 2010, Hitachi, Ltd.