Job Management Partner 1/Performance Management - Remote Monitor for Platform Description, User's Guide and Reference
Cancel the setup of the logical host environment.
This procedure must be performed at both the executing node and the standby node. Cancel the setup at the executing node first and then at the standby node.
Note that
indicates the items to be executed at the executing node,
indicates the items to be executed at the standby node, and
indicates the following setup items:
- Setup items that are required depending on the environment in use
- Setup items for changing the default settings
The following subsections describe how to cancel the setup of PFM - RM for Platform.
- Organization of this subsection
- (1) Terminating from the cluster software
- (2) Mounting the shared disk
- (3) Releasing the port number settings
- (4) Canceling setup of the logical host for PFM - RM for Platform
- (5) Canceling setup of the logical host for 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) Unmounting the shared disk
- (9) Importing the logical host environment definition file
- (10) Releasing the registration of PFM - RM for Platform from the cluster software
- (11) Deleting the settings from PFM - Manager
(1) Terminating from the cluster software
Use the cluster software to stop the Performance Management programs and services that are running at the executing and standby nodes.
For details about how to stop programs and services, see the cluster software documentation.
(2) Mounting the shared disk
Make sure that the shared disk is mounted.
If the shared disk is not mounted, use a program such as the cluster software or a volume manager to mount it.
- Note
- If the shared disk is unmounted but the environment directory on the logical host whose setup is to be canceled contains the jp1pc directory and there are files under the jp1pc directory, the setup cancellation is performed without unmounting the shared disk. In this case, perform the following procedure:
- Use the tar command to archive the jp1pc directory that is located in the environment directory on the logical host whose setup is to be canceled on the local disk.
- Mount the shared disk.
- If the environment directory on the logical host whose setup is to be canceled does not exist on the shared disk, create an environment directory.
- Expand the tar file in the environment directory on the logical host whose setup is to be canceled on the shared disk.
- Unmount the shared disk.
- Delete all files and directories under the jp1pc directory that is located in the environment directory on the logical host whose setup is to be canceled on the local disk.
(3) Releasing the port number settings
This procedure is required only when the jpcconf port command was used to set port numbers during setup in an environment that uses a firewall.
For details about how to release port numbers, see the chapter that describes installation and setup in the Job Management Partner 1/Performance Management Planning and Configuration Guide and the chapter that describes configuration and operation of cluster systems in the Job Management Partner 1/Performance Management User's Guide.
(4) Canceling setup of the logical host for PFM - RM for Platform
This subsection describes how to cancel the setup of the logical host.
If a logical host environment is deleted while the shared disk is in offline status, the logical host settings are deleted from the physical host, but the directories and files are not deleted from the shared disk. In such a case, you must place the shared disk online and manually delete the jp1pc directory under the environment directory.
To cancel the setup of the logical host for PFM - RM for Platform:
- Execute the jpcconf ha list command to check the logical host settings.
Execute the following command:
You must check the current settings before you cancel the setup of the logical host environment. Check such information as the name of the logical host and the path to the shared disk.
jpcconf ha list -key all -lhost logical-host-name
- Execute the jpcconf target unsetup command to delete information about the monitoring host for PFM - RM for Platform.
Execute the following command:
The jpcconf target unsetup command excludes the specified monitored host on the logical host as a monitoring target.
jpcconf target unsetup -key RMPlatform -lhost logical-host-name -inst instance-name -target monitoring-target-name
- Execute the jpcconf inst unsetup command to delete the instance environment for PFM - RM for Platform.
Execute the following command:
The jpcconf inst unsetup command deletes the settings for starting the instance of the logical host. It also deletes files for the instance from the shared disk.
jpcconf inst unsetup -key RMPlatform -lhost logical-host-name -inst instance-name
- Execute the jpcconf ha unsetup command to delete the logical host environment for PFM - RM for Platform.
Execute the following command:
The jpcconf ha unsetup command deletes the settings for starting PFM - RM for Platform on the logical host. It also deletes files for the logical host from the shared disk.
jpcconf ha unsetup -key RMPlatform -lhost logical-host-name
- Execute the jpcconf ha list command to check the logical host settings.
Execute the following command:
Make sure that PFM - RM for Platform has been deleted from the logical host environment.
jpcconf ha list -key all
(5) Canceling setup of the logical host for other Performance Management programs
If you are also canceling from the same logical host the setup of Performance Management programs other than PFM - RM for Platform, do so at this stage.
For details about the procedure for canceling the setup, see the chapter that describes configuration and operation of cluster systems in the Job Management Partner 1/Performance Management User's Guide. Also see the chapter that describes cluster system operation in each PFM - RM manual or PFM - Agent manual.
(6) Exporting the logical host environment definition file
After you have deleted the logical host environment for PFM - RM for Platform, export the environment definition to a file.
Performance Management achieves a matching environment in the executing and standby nodes by importing and exporting environment definitions. When the environment definition exported from the executing node (definition from which the Performance Management definition has been deleted) is imported to the standby node, the system compares it with the environment definition existing in the standby node (definition that still contains the Performance Management definition) to determine the differences (the portion deleted at the executing node) and then deletes the Performance Management environment definition.
To export the logical host environment definition file:
- Execute the jpcconf ha export command to export the logical host environment definition.
Output the logical host environment definition information for Performance Management to an export file. You can assign any name to the export file. For example, to export the logical host environment definition to the lhostexp.txt file, execute the following command:
jpcconf ha export -f lhostexp.txt
(7) Copying the logical host environment definition file to the standby node
Copy from the executing node to the standby node the logical host environment definition file that was exported in (6) Exporting the logical host environment definition file.
(8) Unmounting the shared disk
Unmount the file system and finish the procedure.
If you will be using the shared disk after this procedure is completed, there is no need to unmount the file system.
(9) Importing the logical host environment definition file
Import to the standby node the export file that was copied from the executing node. At the standby node, there is no need to unmount the shared disk during the import processing.
To import the logical host environment definition file:
- Execute the jpcconf ha import command to import the logical host environment definition.
Execute the following command:
This command changes settings in such a manner that the environment for the standby node becomes the same as in the export file. As a result, the settings for starting PFM - RM for Platform on the logical host are deleted. If you have canceled the setup of other Performance Management programs on the logical host, those settings are also deleted. If a fixed port number was set by the jpcconf port command during the setup, it is also released.
jpcconf ha import -f lhostexp.txt
- Execute the jpcconf ha list command to check the logical host settings.
Execute the following command:
Make sure that the displayed information is the same as when the jpcconf ha list command is executed at the executing node.
jpcconf ha list -key all
(10) Releasing the registration of PFM - RM for Platform from the cluster software
From the cluster software, delete the settings related to PFM - RM for Platform on the logical host.
For details about how to delete the settings, see the cluster software documentation.
(11) Deleting the settings from PFM - Manager
Use PFM - Web Console to log on to PFM - Manager and delete the definitions related to the PFM - RM for Platform whose setup is being canceled.
To delete the settings from PFM - Manager:
- From PFM - Web Console, delete the agent.
- Delete the agent information from PFM - Manager.
For example, if PFM - Manager is running on logical host jp1-hal and PFM - RM for Platform is running on logical host jp1-halrmp, execute the following command:
In service-ID, specify the service ID of the agent that is to be deleted.
jpctool service delete -id service-ID -host jp1-halrmp -lhost jp1-hal
- Restart the PFM - Manager service.
For details about how to start services, see the chapter that describes startup and termination of Performance Management in the Job Management Partner 1/Performance Management User's Guide.
- Restart PFM - Web Console.
To apply the deletion of service information to PFM - Web Console, you must restart PFM - Web Console after restarting the PFM - Manager service.
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.