5.4.2 Unsetup procedure in a cluster system

(a) Stopping services from the cluster software

Stop the Performance Management programs and services that are running on the executing nodes from the cluster software. For details about how to stop the programs and services, see the cluster software documentation.

(b) Bringing the shared disk online

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

(c) Deleting the port number settings

This procedure is required only when 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 delete port numbers, see the chapter that describes installation and setup in Windows and the chapter that describes operations in a cluster system in the JP1/Performance Management Planning and Configuration Guide.

(d) Unsetting up the logical host of PFM - Agent for Platform

To unset up the logical host of PFM - Agent for Platform:

Note:

If a logical host environment is deleted while the shared disk is offline, the logical host settings are deleted from the physical host, but the folders and files are not deleted from the shared disk. In such cases, you must bring the shared disk online and then manually delete the jp1pc folder under the environment folder.

1. Execute the jpcconf ha list command to check the logical host settings.

   Execute the command as follows:

   jpcconf ha list -key all -lhost jp1-halaop

   You must check the current settings before you unset up the logical host environment. Check information such as the logical host name and the shared disk path.

2. Execute the jpcconf ha unsetup command to delete the logical host information for PFM - Agent for Platform.

   Execute the command as follows:

   jpcconf ha unsetup -key Windows -lhost jp1-halaop

   For details about the jpcconf ha unsetup command, see the chapter that explains commands in the manual JP1/Performance Management Reference.

   The jpcconf ha unsetup command deletes the settings for starting PFM - Agent for Platform on the logical host. This command also deletes files for the logical host from the shared disk.

3. Execute the jpcconf ha list command to check the logical host settings.

   Execute the command as follows:

   jpcconf ha list -key all

   Make sure that PFM - Agent for Platform has been deleted from the logical host environment.

(e) Unsetting up the logical host of other Performance Management programs

If you have other PFM - Agent programs to be unset up from the same logical host (in addition to PFM - Agent for Platform), they must be unset up at this time.

For details about the unsetup procedure, see the chapter that describes operations in a cluster system in the JP1/Performance Management User's Guide or in the applicable PFM - Agent manual.

(f) Exporting the logical host environment definition file

After you have deleted PFM - Agent for Platform from the logical host, you must export the environment definition 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.

The Performance Management definitions from before the deletion still exist on the standby node. When environment definitions exported from the executing node are imported to the standby node, Performance Management compares the definitions, and then automatically deletes the differences from the standby node. Thus, you do not have to delete the environment definitions from the standby node.

To export the logical host environment definition file:

1. Execute the jpcconf ha export command to export the logical host environment definition.

   Execute the command as follows:

   jpcconf ha export -f lhostexp.txt

   Although the above example shows interactive execution, you can also execute the jpcconf ha export command non-interactively. For details about the jpcconf ha export command, see the chapter that explains the commands in the manual JP1/Performance Management Reference.

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

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

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

(a) Stopping services from the cluster software

Stop the Performance Management programs and services that are running on the standby nodes from the cluster software. For details about how to stop the programs and services, see the cluster software documentation.

(b) Importing the logical host environment definition file

Import the export file copied from the executing node, onto the standby node to apply the file to the standby node. Note that there is no need to take the shared disk online on the standby node during the import operation.

To import the logical host environment definition file:

1. Execute the jpcconf ha import command to import the logical host environment definition.

   Execute the command as follows:

   jpcconf ha import -f lhostexp.txt

   Although the above example shows interactive execution, you can also execute the jpcconf ha import command non-interactively. For details about the jpcconf ha import command, see the chapter that explains the commands in the manual JP1/Performance Management Reference.

   This command changes settings to make the environment for the standby node the same as in the export file. As a result, the settings for starting PFM - Agent for Platform on the logical host are deleted. If you have unset up other Performance Management programs on the logical host, these settings are also deleted. If fixed port numbers were set by using the jpcconf port define command during setup, they are also deleted.

2. Execute the jpcconf ha list command to check the logical host settings.

   Execute the command as follows:

   jpcconf ha list -key all

Make sure that the displayed information is the same as when the jpcconf ha list command is executed on the executing node.