3.4.2 Unsetup procedure
Unset up the logical host environment. The unsetup procedure depends on the virtual environment to be monitored. The icon
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 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
-
(4) Unsetting up the logical host of PFM - RM for Virtual Machine
-
(5) Unsetting up the logical hosts of other Performance Management programs
-
(7) Copying the logical host environment definition file to the standby node
-
(10) Deleting the PFM - RM registration from the cluster software
-
(1) Stopping programs and services from the cluster software
![[Figure]](GRAPHICS/ZU04008.GIF)
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.
(2) Bringing the shared disk online
![[Figure]](GRAPHICS/ZU04007.GIF)
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.
(3) Deleting the port number setting
![[Figure]](GRAPHICS/ZU12001.GIF)
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.
(4) Unsetting up the logical host of PFM - RM for Virtual Machine
![[Figure]](GRAPHICS/ZU04007.GIF)
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.
(5) Unsetting up the logical hosts of other Performance Management programs
![[Figure]](GRAPHICS/ZU12001.GIF)
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.
(6) Exporting the logical host environment definition file
![[Figure]](GRAPHICS/ZU04007.GIF)
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
(7) Copying the logical host environment definition file to the standby node
![[Figure]](GRAPHICS/ZU04008.GIF)
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.
(8) Taking the shared disk offline
![[Figure]](GRAPHICS/ZU12001.GIF)
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.
(9) Importing the logical host environment definition file
![[Figure]](GRAPHICS/ZU04008.GIF)
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.
(10) Deleting the PFM - RM registration from the cluster software
![[Figure]](GRAPHICS/ZU04008.GIF)
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.
(11) Deleting the settings from PFM - Manager
![[Figure]](GRAPHICS/ZU04008.GIF)
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.
(12) Deleting the LPAR Manager management command for Hitachi Compute Blade logical partitioning feature
![[Figure]](GRAPHICS/ZU04008.GIF)
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\