3.4.2 Unsetup procedure

Unset up the logical host environment. The unsetup procedure depends on the virtual environment to be monitored. The icon [Figure] or indicates an unsetup item required for the indicated virtual environment.

There are unsetup procedures for the executing node and for the standby node. Perform unsetup at the executing node first and then at the standby node.

The icon [Figure] indicates an item that must be unset up from the executing node; the icon indicates an item that must be unset up from the standby node. The icon indicates an item that may require unsetup depending on the environment that is used, or an optional unsetup item that is available for changing the default setting.

This subsection explains how to unset up PFM - RM for Virtual Machine.

Organization of this subsection

(1) Stopping programs and services from the cluster software
(2) Bringing the shared disk online
(3) Deleting the port number setting
(4) Unsetting up the logical host of PFM - RM for Virtual Machine
(5) Unsetting up the logical hosts of other Performance Management programs
(6) Exporting the logical host environment definition file
(7) Copying the logical host environment definition file to the standby node
(8) Taking the shared disk offline
(9) Importing the logical host environment definition file
(10) Deleting the PFM - RM registration from the cluster software
(11) Deleting the settings from PFM - Manager
(12) Deleting the LPAR Manager management command for Hitachi Compute Blade logical partitioning feature

(1) Stopping programs and services from the cluster software

From the cluster software, stop the Performance Management programs and services that are active at the executing node and the standby node. For details about how to stop programs and services, see the cluster software documentation.

To Page Top

(2) Bringing the shared disk online

Confirm that the shared disk is online. If the shared disk is not online, bring it online using a cluster software operation or volume manager operation.

To Page Top

(3) Deleting the port number setting

This procedure is required only if you set up port numbers using the jpcconf port command during setup in an environment that uses a firewall.

For details about how to delete port numbers, see the chapter that explains installation and setup in the JP1/Performance Management Planning and Configuration Guide, and the chapter that explains configuration and operations in a cluster system in the JP1/Performance Management User's Guide.

To Page Top

(4) Unsetting up the logical host of PFM - RM for Virtual Machine

The procedure for unsetting up the logical host follows.

Note:: If you delete the logical host environment while the shared disk is offline, only the settings of the logical host residing on the physical host are deleted, and folders and files on the shared disk are not deleted. In this case, you need to bring the shared disk online and manually delete the jp1pc folder from the environment folder.

To unset up the logical host:

Confirm the logical host settings by executing the jpcconf ha list command.

Execute the command as follows.
```
jpcconf ha list -key all -lhost jp1-halvm
```
Before unsetting up the logical host environment, check the current settings. Check items such as the logical host name and the shared disk path.
Delete the information about the virtual environment monitored by PFM - RM for Virtual Machine.

Execute the command as follows.
```
jpcconf target unsetup -key RMVM -lhost jp1-halvm -inst inst1 -target targethost1
```
When the jpcconf target unsetup command is executed, the virtual environment monitored by the logical host is no longer monitored.
Delete the instance environment of PFM - RM for Virtual Machine.

Execute the command as follows.
```
jpcconf inst unsetup -key RMVM -lhost jp1-halvm -inst inst1
```
Executing the jpcconf inst unsetup command deletes the settings for starting the logical host instance. Additionally, the instance file is deleted from the shared disk.
Delete the logical host environment of PFM - RM for Virtual Machine by executing the jpcconf ha unsetup command.

Execute the command as follows.
```
jpcconf ha unsetup -key RMVM -lhost jp1-halvm
```
Executing the jpcconf ha unsetup command deletes the settings for starting PFM - RM for Virtual Machine on the logical host. Also, the files for the logical host are deleted from the shared disk.
Use the jpcconf ha list command to confirm the logical host settings.

Execute the command as follows.
```
jpcconf ha list -key all
```
Confirm that PFM - RM for Virtual Machine has been deleted from the logical host environment.

To Page Top

(5) Unsetting up the logical hosts of other Performance Management programs

Besides PFM - RM for Virtual Machine, if there are other Performance Management programs that need to be unset up from the same logical host, unset them up at this time.

For details about the unsetup procedure, see the chapter that explains configuration and operations in a cluster system in the JP1/Performance Management User's Guide, or the chapter that explains operations in a cluster system in each PFM - RM manual.

To Page Top

(6) Exporting the logical host environment definition file

After you have deleted PFM - RM for Virtual Machine from the logical host, export the environment definitions to a file.

Performance Management uses a method that matches the environment of the standby system to that of the executing system by exporting and importing the environment definitions. When the environment definitions (from which the Performance Management definition has been deleted) exported from the executing node are imported onto the standby node, they are compared with the standby node's existing environment definitions (which includes the Performance Management definition prior to its deletion). The difference (the part that was deleted from the executing node) is identified, and the environment definition for Performance Management is deleted.

To export the logical host environment definition file:

Export the logical host environment definitions by executing the jpcconf ha export command.

Output the definition information of the logical host environment for Performance Management to a file. You can use any desired export file name. For example, to export the logical host environment definitions to the lhostexp.txt file, execute the command as follows.
```
jpcconf ha export -f lhostexp.txt
```

To Page Top

(7) Copying the logical host environment definition file to the standby node

Copy the logical host environment definition file exported in (6) Exporting the logical host environment definition file from the executing node to the standby node.

To Page Top

(8) Taking the shared disk offline

Using a cluster software operation or volume manager operation, take the shared disk offline to complete the task. If you plan to continue using the shared disk, there is no need to take it offline.

To Page Top

(9) Importing the logical host environment definition file

Import the export file copied from the executing node onto the standby node in order to commit the file to the standby node. At the standby node, there is no need to take the shared disk offline during the import operation.

To import the logical host environment definition file:

Import the logical host environment definitions by executing the jpcconf ha import command.

Execute the command as follows.
```
jpcconf ha import -f lhostexp.txt
```
When the command is executed, the settings are changed to match the standby node environment to the content of the export file. As a result, the setting for starting the PFM - RM for Virtual Machine instance of the logical host is deleted. If the Performance Management programs of other logical hosts have been unset up, those settings are also deleted. If a fixed port number was set up using the jpcconf port command during setup, it is deleted as well.
Confirm the logical host settings by executing the jpcconf ha list command.

Execute the command as follows.
```
jpcconf ha list -key all
```
Confirm that the command displays the same content that was displayed when the jpcconf ha list command was executed at the executing node.

To Page Top

(10) Deleting the PFM - RM registration from the cluster software

Delete the settings for the PFM - RM for Virtual Machine instance of the logical host from the cluster software. For details about how to delete the settings, see the cluster software documentation.

To Page Top

(11) Deleting the settings from PFM - Manager

From PFM - Web Console, log into PFM - Manager and delete the definition related to the PFM - RM for Virtual Machine instance that is being unset up.

To delete the settings:

If you have stopped the PFM - Manager services from the cluster software as described in 3.4.2(1) Stopping programs and services from the cluster software, use the cluster software to start the PFM - Manager services. For details about how to start the services, see the cluster software documentation.
Delete the agent from PFM - Web Console.
Delete the agent information of PFM - Manager.

For example, if PFM - Manager is running on the logical host jp1-hal and PFM - RM for Virtual Machine is running on the logical host jp1-halvm, specify the following and then execute the command:
```
jpctool service delete -id service-ID -host jp1-halvm -lhost jp1-hal
```
For service-ID, specify the service ID of the agent to be deleted.
Restart the PFM - Manager services.

For details about how to start a service, 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.

In order to update the PFM - Web Console host to reflect the deletion of service information, synchronize the agent information of the PFM - Manager host and that of the PFM - Web Console host. Use the jpctool service sync command to synchronize the agent information.

To Page Top

(12) Deleting the LPAR Manager management command for Hitachi Compute Blade logical partitioning feature

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

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

To Page Top