3.4.2 Procedure for canceling the setup for the UNIX edition

(1) Canceling the setup for a monitoring target

To cancel the setup for a monitoring target, first check the name of the monitoring target, and then use the PFM - RM host to delete the monitoring target.

To check the name of a monitoring target, use the jpcconf target list command. To delete a configured monitoring target, use the jpcconf target unsetup command.

Note

There is no need to stop PFM - RM for Platform services while you are deleting a monitoring target.

To delete a monitoring target:

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

   The names of all monitoring targets are displayed:

   Targets:
   targethost1
   targethost2
   Groups:
   All

2. Delete the desired monitoring target.

   Execute the jpcconf target unsetup command with the service key that indicates PFM - RM for Platform, the instance name, and the name of the monitoring target specified:

   jpcconf target unsetup -key RMPlatform -inst inst1 -target targethost1

   When the jpcconf target unsetup command in this example terminates normally, targethost1 will no longer be a monitoring target.

   Important

   If you delete the monitoring targets by executing the jpcconf target unsetup command, the service information is automatically deleted from PFM - Manager; therefore, there is no need to execute the jpctool service delete command. The service information is deleted from PFM - Manager at the following times:

   • If you execute the jpcconf target unsetup command while both PFM - Manager and the PFM - RM service to be deleted are running, PFM - RM requests PFM - Manager to delete the service information, and PFM - Manager deletes the service information.

   • If you execute the jpcconf target unsetup command while both PFM - Manager and the PFM - RM service to be deleted are stopped, PFM - Manager deletes the service information when the PFM - RM service starts and connects to PFM - Manager.

   To apply the deletion of the monitoring target to the PFM - Web Console host, you must execute the jpctool service sync command to synchronize the agent information between the PFM - Manager host and the PFM - Web Console host.

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

   Canceling the setup for a monitoring target does not delete the directories and files listed below. You must delete these directories and files manually.

   • /opt^#/jp1pc/agt7/agent/instance-name/targets/monitoring-target-name

   • /opt^#/jp1pc/agt7/agent/instance-name/log/target_monitoring-target-name_nn

   #

   If you use a logical host for operation, replace opt with environment-directory.

To Page Top

(2) Canceling an instance environment setup

To cancel the setup for an instance environment, first check the name of the instance, and then delete the instance environment. Execute deletion of an instance environment at the PFM - RM host. To check the name of an instance, use the jpcconf inst list command. To delete a configured instance environment, use the jpcconf inst unsetup command.

To delete an instance environment:

1. Check the name of the instance.

   Execute the jpcconf inst list command with the service key that indicates PFM - RM for Platform specified.

   jpcconf inst list -key RMPlatform

   For example, if the set instance name is inst1, the command displays inst1.

2. If any services of PFM - RM for Platform are running in the instance environment, stop all of them.

   For details about how to stop services, see the chapter that describes starting and stopping Performance Management in the JP1/Performance Management User's Guide.

3. Delete the instance environment.

   Execute the jpcconf inst unsetup command with the service key that indicates PFM - RM for Platform and the instance name specified.

   For example, if the set instance name is inst1, specify the command as follows:

   jpcconf inst unsetup -key RMPlatform -inst inst1

   This example shows execution in the interactive mode, but you can also execute the jpcconf inst unsetup command in the non-interactive mode. For details about this command, see the chapter that describes commands in the manual JP1/Performance Management Reference.

   When the jpcconf inst unsetup command terminates normally, the directories configured as the instance environment and the service ID are deleted.

   Important

   Canceling the setup of an instance environment might not delete the service information that is displayed by the jpctool service list command. In this case, use the jpctool service delete command on the host where PFM - Manager is installed to delete the service information.

   To apply the deletion of the instance environment to the PFM - Web Console host, you must execute the jpctool service sync command to synchronize the agent information between the PFM - Manager host and the PFM - Web Console host.

   In such a case, use the jpctool service delete command at the host where PFM - Manager is installed to delete the service information. After the command executes, restart the PFM - Manager service. The following shows a specification example:

   • Instance name: inst1

   • Host name: lhost1

   • Service ID of the Remote Monitor Collector service: 7A1inst1[lhost1]

   • Service ID of the Remote Monitor Store service: 7S1inst1[lhost1]

   • Service ID of the Group Agent service: 7S1inst1[All@lhost1]

   jpctool service delete -id 7?1inst1[lhost1] -host lhost1

   jpctool service delete -id 7?1inst1[*@lhost1] -host lhost1

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

To Page Top