3.6.3 Updating a monitoring target

This subsection describes how to update a monitoring target 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 a set monitoring target, you must first check the name of the monitoring target, and then update the monitoring target. Use the PFM - RM host to set the monitoring target.

Before you perform this operation, check the information to be updated. The following table lists and describes the information that can be updated.

Table 3‒35: Monitoring target settings for PFM - RM for Platform (for Windows)
No.	Item	Description	Setting	Default value
1	`Target` `Host`	Specifies the resolvable host name where the monitoring target is run. This information is used for collection of performance data and health checking. It is also used as the event host name when JP1/IM is linked.	From 1 to 32 bytes of alphanumeric characters and the hyphen (-) are permitted. A name beginning with a hyphen (-) is not permitted. The host name must be unique within the instance.	Previous setting
2	`UseCommonAccount`^#	Specifies whether to use common account information.	Specify one of the following values: `Y`: Use `N`: Do not use	Previous setting
3	`TargetType`	Specifies the method to use when connecting to the monitored host. The setting differs depending on whether the monitored host is running Windows or UNIX. For health check monitoring, the value should be `icmp`.	The values listed below can be set. You cannot change these settings. `wmi`: WMI (when the monitored host is running Windows) `ssh`: SSH (when the monitored host is running UNIX) `icmp`: Health check monitoring	Initial setting
4	`User^#`	Specifies the user who connects to the monitored host.	From 1 to 256 bytes of characters are permitted. The following character is not permitted: Tab	Previous setting
5	`Password^#`	Specifies the password needed to connect to the monitored host. The password is not displayed on the screen. If you set a password, you must enter it twice. There is no need to specify this item if the monitored host is running UNIX.	From 0 to 256 bytes of characters are permitted. The following character is not permitted: Tab
6	`Domain^#`	Specifies the domain name to which the monitored host belongs. There is no need to specify this item if the monitored host belongs to a work group. There is no need to specify this item if the monitored host is running UNIX.	From 0 to 256 bytes of characters are permitted. The following character is not permitted: Tab
7	`Private_Key_File^#`	Specifies an absolute path for the name of the private key file used in the SSH public key method. 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 the monitored host is running Windows.	From 0 to 256 bytes of characters are permitted. The following character is not permitted: Tab
8	`Port^#`	Specifies the port number of the SSH server on the monitored host. This item is not used if the monitored host is running Windows. In this case, leave the default value.	1 to 65,535

#: 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-17.

To check the name of a monitoring target, use the jpcconf target list command. To check the settings for a monitoring target, use the jpcconf target display command. To update a monitoring target, use the jpcconf target setup command.

Note: There is no need to stop services of PFM - RM for Platform while you are updating a monitoring target.

To update multiple monitoring targets, repeat the procedure described below.

To update a monitoring target:

To check the name of the monitoring target, execute the jpcconf target list command with the service key that indicates PFM - RM for Platform and the instance name specified:
```
jpcconf target list -key RMPlatform -inst inst1
Targets:
targethost1
targethost2
Groups:
All
```
To check the settings for the monitoring target, execute the jpcconf target display command with the service key that indicates PFM - RM for Platform, the instance name, and the monitoring target name specified.

For example, if you want to check the settings for the monitoring target whose name is targethost1, execute the following command:
```
jpcconf target display -key RMPlatform -inst inst1 -target targethost1
```
Execute the jpcconf target setup command with the service key that indicates PFM - RM for Platform, the instance name, and the monitoring target name specified.

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

For details about how to execute this command in the non-interactive mode, see 3.1.4(3) Setting the monitored host.

If you execute the jpcconf target setup command in the non-interactive mode, the procedure in step 4 is not required.
To update the PFM - RM for Platform monitoring target, enter the applicable items listed in Table 3-35 Monitoring target 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 monitoring target is updated.

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

To Page Top

(2) In UNIX