2.2.2 Unsetup procedure

This subsection explains how to unset up PFM - RM for Virtual Machine. The unsetup procedure depends on the virtual environment to be monitored. The icon [Figure] indicates an unsetup item required for the indicated virtual environment.

Organization of this subsection

(1) Deleting a monitoring target
(2) Unsetup of the instance environment
(3) Deleting settings from PFM - Manager
(4) Deleting the LPAR Manager management command for logical partitioning feature

(1) Deleting a monitoring target

To delete a monitoring target, you need to first confirm the name of the monitoring target and then delete the monitoring target on the PFM - RM host. To confirm the name of the monitoring target that you want to delete, use the jpcconf target list command. To delete the monitoring target, use the jpcconf target unsetup command.

You do not need to stop the PFM - RM for Virtual Machine service when deleting a monitoring target.

To delete a monitoring target:

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

Execute the jpcconf target list command by specifying the service key and the instance name that identify the target PFM - RM for Virtual Machine instance.
```
jpcconf target list -key RMVM -inst inst1
```
The names of hosts monitored by the instance are displayed.
```
Targets:
targethost1
targethost2
Groups:
All
```
Delete the objective monitoring target.

Execute the jpcconf target unsetup command by specifying the service key, instance name, and monitoring target name that identify the target PFM - RM for Virtual Machine instance.
```
jpcconf target unsetup -key RMVM -inst inst1 -target targethost1
```
When the jpcconf target unset command terminates normally, targethost1 is no longer monitored.

Notes:

If you use the jpcconf target unsetup command to delete a monitoring target, service information is automatically deleted from PFM - Manager. Therefore, you do not need to execute the jpctool service delete command. The following describes when service information is deleted.

• If the jpcconf target unsetup command is executed while the services of PFM - Manager and the target PFM - RM for Virtual Machine instance are running, the instance requests PFM - Manager to delete service information. Service information is deleted at this time.

• If the jpcconf target unsetup command is executed while the service of PFM - Manager or the target PFM - RM for Virtual Machine instance is not running, service information is deleted at the following time: when the service of PFM - RM for Virtual Machine is restarted and connected to PFM - Manager.
For the PFM - Web Console host to recognize that an instance environment has been deleted, execute the jpctool service sync command to synchronize the agent information on the PFM - Manager host and the PFM - Web Console host.

Note that the folder and files shown below are not deleted when a monitoring target is deleted. Delete these folder and files manually.

installation-folder^#\agt8\agent\instance-name\targets\monitoring-target-name

installation-folder^#\agt8\agent\instance-name\log\VM_Type_monitoring-target-nameN

#: If you use PFM - RM for Virtual Machine on a logical host, replace installation-folder with the environment-folder\jp1pc.

To Page Top

(2) Unsetup of the instance environment

To unset up the instance environment, first confirm the instance name and then delete the instance environment. Delete the instance environment from the PFM - RM host. To confirm the instance name, use the jpcconf inst list command. In addition, to delete an instance environment that has been created, use the jpcconf inst unsetup command.

To delete an instance environment:

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
 (jpcinslist agt8)
```
If the instance name that was set is inst1, inst1 is displayed.
If any PFM - RM for Virtual Machine services in the instance environment are active, 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.
Delete the instance environment.

Specify the service key indicating the PFM - RM for Virtual Machine and the instance name, and then execute the jpcconf inst unsetup command. If the instance name that was set is inst1, specify the following:
```
jpcconf inst unsetup -key RMVM -inst inst1
 (jpcinsunsetup agt8 -inst inst1)
```
When the jpcconf inst unsetup command terminates normally, the folders, service IDs, and Windows services that were created as the instance environment are deleted.
Important
Even when you unset up the instance environment, the service information that can be displayed using the jpctool service list command is not deleted. You use the jpctool service delete command to delete the service information.

To get the PFM - Web Console host to recognize that an instance environment has been deleted, execute the jpctool service sync command. This synchronizes the agent information on the PFM - Manager host and the PFM - Web Console host.

A specification example follows.
- Instance name: inst1
- Host name: host03
- Remote Monitor Collector service service ID: 8A1inst1[host03]
- Remote Monitor Store service service ID: 8S1inst1[host03]
- Group Agent service service ID: 8Ainst1[All@host03]
  
  jpctool service delete -id 8?1inst1[host03] -host host03
  
  jpctool service delete -id 8?1inst1[*@host03] -host host03
For details about commands, see the chapter that explains commands in the manual JP1/Performance Management Reference.

To Page Top

(3) Deleting settings from PFM - Manager

From PFM - Web Console, log into PFM - Manager and delete the definitions related to the PFM - RM for Virtual Machine instance that you want to unset up.

To delete settings from PFM - Manager:

Delete the agent from PFM - Web Console.
Delete the agent information of PFM - Manager.

For example, to delete the service information of the PFM - RM for Virtual Machine instance of the host targethost1, specify the following and execute the command:
```
jpctool service delete -id service-ID -host targethost1
```
For service-ID, specify the service ID of the agent you want to delete.
Restart the PFM - Manager service.

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.
Apply the service information of the PFM - Manager host.

To get the PFM - Web Console host to recognize that the service information has been deleted, synchronize the agent information on the PFM - Manager host with the information on the PFM - Web Console host. To synchronize agent information, use the jpctool service sync command.

To Page Top

(4) Deleting the LPAR Manager management command for logical partitioning feature

Delete the HvmSh command (HvmSh.exe) from the management tool for logical partitioning feature, which has been copied to the following folder during setup:

installation-folder\agt8\plugin\jpcagt5virtage.d\

To Page Top