Hitachi

JP1 Version 11 JP1/Performance Management - Agent Option for Service Response Description, User's Guide and Reference


6.4.2 Unsetting up PFM - Agent for Service Response

Unsetup the logical host environment. This subsection describes the unsetup procedures for the executing node and the standby node. Unsetup the executing node first, and then the standby node.

The following describes the procedures for unsetting up PFM - Agent for Service Response.

Note:

You must stop all services of the Performance Management programs running on the executing and standby nodes where you are unsetting up PFM - Agent. For details about how to stop services, see the chapter that describes construction and operation in a cluster system in the JP1/Performance Management System Configuration and User's Guide.

Organization of this subsection

(1) Unsetting up the logical host environment on the executing node

You unsetup the logical host environment for PFM - Agent for Service Response on the executing node.

(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 using a cluster software operation or volume manager operation.

(c) Deleting 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 delete port numbers, see the chapter that describes installation and setup for Windows and the chapter that describes operations in a cluster system in the JP1/Performance Management Planning and Configuration Guide.

(d) Unsetting up PFM - Agent for Service Response in a logical host environment

To unsetup PFM - Agent for Service Response in a logical host environment:

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 a case, you must bring the shared disk online and 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 -host jp1-halsr

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

  2. Execute the jpcconf ha unsetup command to delete the logical host environment for PFM - Agent for Service Response.

    Execute the command as follows:

    jpcconf ha unsetup -key SR -host jp1-halsr

    The jpcconf ha unsetup command deletes the settings for starting PFM - Agent for Service Response on the logical host. It also deletes files related 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 Service Response has been deleted from the logical host environment.

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

At this point, unsetup other Performance Management programs from the same logical host (in addition to unsetup PFM - Agent for Service Response).

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

After you have deleted PFM - Agent for Service Response 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

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 part deleted at the executing node). The system then deletes the Performance Management environment definition.

To export the logical host environment definition:

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

    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 definition to the lhostexp.txt file, execute the following command:

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

(2) Unsetting up the logical host environment on the standby node

Copy the file you exported from the executing node to the standby node, and then unsetup the logical host environment on the standby node. Note that the shared disk does not need to be online when you do this.

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

  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 in such a way that the environment for the standby node becomes the same as in the export file. As a result, the settings for starting PFM - Agent for Service Response on the logical host are deleted. If you have unsetup other Performance Management programs on the logical host, these settings are also deleted.

    If fixed port numbers were set up using the jpcconf port command during setup, they are also deleted.

  2. Execute the jpcconf ha list -key all 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 jpcconf ha list is executed at the executing node.

(3) Deleting registration from the cluster software

Delete the settings related to PFM - Agent for Service Response from the cluster software on the logical host.

For details about how to delete the settings, see the cluster software documentation.

(4) Canceling the connection-target PFM - Manager

To cancel the connection-target PFM Manager, you need to first delete the service information of the PFM - Agent for Service Response that is connected to the PFM - Manager in question.

For details about how to delete service information, see the section describing how to delete service information in the chapter that explains installation and setup (in Windows) in the JP1/Performance Management Planning and Configuration Guide.

To change the connection target to another PFM - Manager, see 6.3.4(3)(c) Setting up PFM - Manager for the connection destination of PFM - Agent for Service Response.