5.6.2 Unsetup procedure in a cluster system (for UNIX)

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 [Figure] 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 all the Performance Management programs and services running on the executing and standby nodes.

For details about how to stop programs and services, see the cluster software documentation.

To Page Top

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

To Page Top

(3) Releasing the port number settings

This procedure is required only if the jpcconf port define 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 JP1/Performance Management Planning and Configuration Guide and the chapter that describes configuration and operation of cluster systems in the JP1/Performance Management User's Guide.

To Page Top

(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:
```
jpcconf ha list -key all -lhost logical-host-name
```
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.
Execute the jpcconf target unsetup command to delete information about the monitoring host for PFM - RM for Platform.

Execute the following command:
```
jpcconf target unsetup -key RMPlatform -lhost logical-host-name -inst instance-name -target monitoring-target-name
```
The jpcconf target unsetup command excludes the specified monitored host on the logical host as a monitoring target.
Execute the jpcconf inst unsetup command to delete the instance environment for PFM - RM for Platform.

Execute the following command:
```
jpcconf inst unsetup -key RMPlatform -lhost logical-host-name -inst instance-name
```
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.

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.
Execute the jpcconf ha unsetup command to delete the logical host environment for PFM - RM for Platform.

Execute the following command:
```
jpcconf ha unsetup -key RMPlatform -lhost logical-host-name
```
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.
Execute the jpcconf ha list command to check the logical host settings.

Execute the following command:
```
jpcconf ha list -key all
```
Make sure that PFM - RM for Platform has been deleted from the logical host environment.

To Page Top

(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 JP1/Performance Management User's Guide. Also see the chapter that describes cluster system operation in each PFM - RM manual or PFM - Agent manual.

To Page Top

(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
```
This example shows execution in the interactive mode, but you can also execute the jpcconf ha export command in the non-interactive mode. For details about this command, see the chapter that describes commands in the manual JP1/Performance Management Reference.

To Page Top

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

To Page Top

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

To Page Top

(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 keep the shared disk mounted 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:
```
jpcconf ha import -f lhostexp.txt
```
This example shows execution in the interactive mode, but you can also execute the jpcconf ha import command in the non-interactive mode. For details about this command, see the chapter that describes commands in the manual JP1/Performance Management Reference.

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 define command during the setup, it is also released.
Execute the jpcconf ha list command to check the logical host settings.

Execute the following command:
```
jpcconf ha list -key all
```
Make sure that the displayed information is the same as when the jpcconf ha list command is executed at the executing node.

To Page Top

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

To Page Top

(11) Deleting the settings from PFM - Manager

From PFM - Web Console, log in to PFM - Manager and delete the settings related to the PFM - RM for Platform that you want to unsetup.

To delete the settings from PFM - Manager:

Start the PFM - Manager service.

If the PFM - Manager service was stopped in 5.6.2(1) Terminating from the cluster software, use the cluster software to start the PFM - Manager service. For details about how to start the service, see the cluster software manual.
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:
```
jpctool service delete -id service-ID -host jp1-halrmp -lhost jp1-hal
```
In service-ID, specify the service ID of the agent that is to be deleted.
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 JP1/Performance Management User's Guide.
Apply the service information of PFM - Manager host.

To apply the deletion of the service information to the PFM - Web Console host, synchronize the agent information between the PFM - Manager host and the PFM - Web Console host. To synchronize the agent information, use the jpctool service sync command.

To Page Top