6.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) Mounting the shared disk

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

Note:

Even if the shared disk is unmounted, if the environment directory for the logical host to be unset up contains the jp1pc directory under which files are stored, setup has been performed without mounting the shared disk. In this case, use the following procedure:

1. Use the tar command to archive the jp1pc directory in the specified environment directory for the logical host to be unset up on the local disk.

2. Mount the shared disk.

3. If the environment directory for the logical host to be unset up does not exist on the shared disk, create the environment directory.

4. Expand the tar file to the environment directory for the logical host to be unset up on the shared disk.

5. Unmount the shared disk.

6. Delete the files under the jp1pc directory in the environment directory for the logical host to be unset up on the local disk.

(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 UNIX 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 when the shared disk is not mounted, the logical host settings are deleted from the physical host, but the directories and files are not deleted from the shared disk. In such cases, you must mount the shared disk, and then manually delete the jp1pc directory under the environment directory.

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 UNIX -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 import 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) Unmounting the shared disk

Using a cluster software operation or volume manager operation, unmount the shared disk to complete the task. If you intend to continue using the shared disk you unmounted, there is no need to perform the unmount operation again.

(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 mount the shared disk 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.