2.4.3 Updating monitoring targets

To update a monitoring target, check the name of the monitoring target, and then update the information about the monitoring target. Set the new information about the monitoring target on the PFM - RM host.

The table below lists and describes the information items that can be updated. Check the items that you want to change beforehand.

Table 2‒14: Setting items for a monitoring target of PFM - RM for Virtual Machine
Item	Explanation	Value that can be set	Default value
`Target Host`	Specifies the host name of a monitoring-target physical server. Make sure that the host name can resolve to an IP address.^#1 The specified value is used for collection of performance information and for health checks. For linkage with JP1/IM or NNM, the specified value is also used as the event host name.	A character string that is 32 bytes long and consists of only single-byte alphanumeric characters and hyphens (`-`) can be specified. However, a value that begins with a hyphen (`-`) cannot be specified. Make sure that you specify a value that is unique within the instance.^#2	Previous setting
`VM_Host`	Specifies the host name of a monitoring-target physical server. Specify this item if the destination host has already been created with a name that cannot be specified for `Target` `Host`. The specified value is used for collection of performance information. If no value is specified for this item, the value specified by `Target` `Host` is used to perform collection of performance information.	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 communication with the monitoring-target physical server.	`{0\|1}` `0`: SSL is not used. SSL is used. SSL is unavailable with Hyper-V or KVM. If `1` is specified in such a case, the system assumes that `0` is specified.	Previous setting
`Port`	Specifies the port number that is used for communication with the monitoring-target physical server.	`0`-`65535` For VMware: If `0` is specified, the port number that will be used differs depending on the `Security` value: `Security` = `0` (do not use SSL): `80` (HTTP default port number) `Security` = `1` (use SSL): `443` (HTTPS default port number) For KVM: If `0` is specified, `22` (SSH default port number) will be assumed.	Previous setting
`UserID`	Specifies the user ID that is used to connect to the monitoring-target physical server.^#3	Character string not exceeding 256 bytes. Note that the following character cannot be used: Tab character	Previous setting
`Password`	Specifies the password that is used to connect to the monitoring-target physical server. The character string entered for this item is not displayed. This item requires you to enter a value twice. If the monitoring target uses VMware and you specify a password that includes special characters, make sure that you specify a sanitized string.	Character string not exceeding 256 bytes. Note that the following character cannot be used: Tab character	Previous setting
`Domain`	Specifies the name of the domain that the monitoring-target physical server belongs to. If the server belongs to a work group, you do not need to specify this item. If the monitoring target uses VMware or KVM, you do not need to specify this item.	Character string not exceeding 256 bytes. Note that the following character cannot be used: Tab character	Previous setting
`Private_Key_File`	Specifies the absolute path name of the private key file that is used for SSH public key encryption. 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

#1

The first thing you must do before you can perform collection of performance information and do health checks is to ensure that the PFM - RM host name can resolve to an IP address. To use the JP1/IM linkage facility, the JP1/IM host name must be resolvable to an IP address. To use the OpenView linkage facility, the PFM - Manager and NNM host names must be resolvable to IP addresses.

#2

The string All, which is a reserved word for group agents, cannot be used.

#3

If the monitoring-target virtual environment uses VMware, the account you specify must have a Read-only or a higher VMware role. For details about how to specify the role settings, see the VMware documentation.

For the permission required for the account to be specified if the monitoring-target virtual environment uses Hyper-V, see the notes in 2.5.2 For Hyper-V.

If the monitoring-target virtual environment uses KVM, always log in as superuser. For details about how to specify settings after login and notes, see 2.5.3 For KVM.

Note that the items that must be specified during setup of a monitoring target differ depending on the virtual environment. Therefore, the items that can be updated also differ depending on the virtual environment. The following table shows the updatable items for each virtual environment.

Table 2‒15: Updatable items of a monitoring target for each virtual environment
Item	Virtual environment
Item	VMware	Hyper-V	KVM
`Target Host`	Y	Y	Y
`VM_Host`	Y	Y	Y
`Security`	Y	--	--
`Port`	Y	--	Y
`UserID`	Y	Y	Y
`Password`	Y	Y	--
`Domain`	--	Y	--
`Private_Key_File`	--	--	Y

Legend:

Y: Can be updated

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

To check the name of the monitoring target that you want to update, use the jpcconf target list command. To update the monitoring target, use the jpcconf target setup command.

The following procedure shows how to update a monitoring target. To update multiple monitoring targets in an instance environment, repeat the procedure. To update a monitoring target:

Check the name of the monitoring target that you want to update.

To display the names of monitoring targets for instance inst1, execute the jpcconf target list command by specifying the service key that indicates PFM - RM for Virtual Machine.
```
jpcconf target list -key RMVM -inst inst1
```
If the only monitoring target that is set is targethost1, the command displays targethost1.
Execute the jpcconf target setup command by specifying the name of the monitoring target that you want to update, as well as the service key of PFM - RM for Virtual Machine and the instance name.

For example, to update monitoring target targethost1 of instance inst1, execute the following command:
```
jpcconf target setup -key RMVM -inst inst1 -target targethost1
```
Update the information about the monitoring target of PFM - RM for Virtual Machine.

Specify values for the items indicated in Table 2-14. The current value is displayed for each item in the initial status. To accept the displayed value, just press the return key. When all entries are completed, the monitoring target is updated.

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

To Page Top