Job Management Partner 1/Performance Management - Agent Option for Enterprise Applications Description, User's Guide and Reference

4.4.3 In SAP NetWeaver 2004 or earlier (in Windows)

Organization of this subsection

(1) Flow of tasks for uninstallation and unsetup of PFM - Agent for Enterprise Applications

(2) Canceling the setup of PFM - Agent for Enterprise Applications

(3) Uninstalling

(1) Flow of tasks for uninstallation and unsetup of PFM - Agent for Enterprise Applications

The following figure shows the flow of tasks for uninstalling and canceling the setup of a PFM - Agent for Enterprise Applications that is running in a cluster system.

Figure 4-13 Flow of tasks for uninstalling and canceling the setup of a PFM - Agent for Enterprise Applications that is running on a logical host in a cluster system (in Windows)

(2) Canceling the setup of PFM - Agent for Enterprise Applications

This subsection explains how to cancel the setup of a logical host environment. There are separate setup cancellation procedures for the executing node and the standby node. First perform the procedure for the executing node, and then perform the procedure for the standby node.

The following describes the procedures for canceling the setup of PFM - Agent for Enterprise Applications.

Note

You must stop all services of the Performance Management programs running at the executing and standby nodes where setup is to be canceled. For details about how to stop services, see the chapter that describes configuration and operation in a cluster system in the Job Management Partner 1/Performance Management User's Guide.

(a) Canceling the setup of the logical host environment at the executing node

You must first cancel the setup of the logical host environment for PFM - Agent for Enterprise Applications at the executing node.

n Placing the shared disk online

Make sure that the shared disk is in online status. If it is not online, use a program such as the cluster software or a volume manager to place it online.

n Releasing the port number settings

This procedure is required only when the jpcconf port (jpcnsconfig 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 and the chapter that describes configuration and operations in a cluster system in the Job Management Partner 1/Performance Management Planning and Configuration Guide.

n Canceling the setup of PFM - Agent for Enterprise Applications 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 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 PFM - Agent for Enterprise Applications in a logical host environment:
Execute the jpcconf ha list -key all (jpchasetup list) command to check the logical host settings.
Execute the following command:
jpcconf ha list -key all -lhost jp1-halr3 (jpchasetup list -lhost jp1-halr3)
 
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 shared disk path.
Delete the instance environment for PFM - Agent for Enterprise Applications.
Execute the following command:
jpcconf inst unsetup -key EAP -lhost jp1-halr3 -inst o246bci_SD5_00 (jpcinsunsetup agtm -lhost jp1-halr3 -inst o246bci_SD5_00)
 
The jpcconf inst unsetup (jpcinsunsetup) command deletes the settings needed to start an instance at the logical host. It also deletes the files associated with the instance from the shared disk.
Execute the jpcconf ha unsetup (jpchasetup delete) command to delete the logical host environment for PFM - Agent for Enterprise Applications.
Execute the following command:
jpcconf ha unsetup -key EAP -lhost jp1-halr3 (jpchasetup delete agtm -lhost jp1-halr3)
 
The jpcconf ha unsetup (jpchasetup delete) command deletes the settings needed to start PFM - Agent for Enterprise Applications on the logical host. It also deletes the files associated with the logical host from the shared disk.
Execute the jpcconf ha list -key all (jpchasetup list) command to check the logical host settings.
Execute the following command:
jpcconf ha list -key all (jpchasetup list)
 
Make sure that PFM - Agent for Enterprise Applications has been deleted from the logical host environment.
n Canceling the setup of logical host environments for other Performance Management programs

If you are canceling the setup of PFM - Agents other than PFM - Agent for Enterprise Applications from the same logical host, do so at this stage.

For details about the procedure for canceling such a setup, see the chapter that describes configuration and operations in a cluster system in the Job Management Partner 1/Performance Management User's Guide or the chapter that describes operations in a cluster system in the applicable PFM - Agent manual.

n Exporting the logical host environment definition

Once you have deleted PFM - Agent for Enterprise Applications from the logical host, you must export the environment definition to a file.

Performance Management achieves a matching environment in both the executing system and the standby system 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 parts deleted at the executing node) and then deletes the Performance Management environment definition.

To export the logical host environment definition:
Execute the jpcconf ha export (jpchasetup 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 (jpchasetup export -f lhostexp.txt)
n 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 exported as described in Exporting the logical host environment definition in 4.4.3(2)(a) Canceling the setup of the logical host environment at the executing node.

n Placing the shared disk offline

Use a program such as the cluster software or a volume manager to place the shared disk in offline status and then finish the procedure. If you will be using the shared disk after the procedure, there is no need to place it offline.

(b) Canceling the setup of the logical host environment at the standby node

Copy the file exported from the executing node to the standby node and then cancel the setup of the logical host environment at the standby node. At the standby node, there is no need to place the shared disk in online status during the setup cancellation procedure.

To cancel the setup of the logical host environment at the standby node:
Execute the jpcconf ha import (jpchasetup import) command to import the logical host environment definition.
Execute the following command:
jpcconf ha import -f lhostexp.txt (jpchasetup import -f lhostexp.txt)
 
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 - Agent for Enterprise Applications on the logical host are deleted. If you have canceled the setup of other Performance Management programs on the logical host, their settings are also deleted.
If fixed port numbers were set by the jpcconf port (jpcnsconfig port) command during setup, they are also released.
Execute the jpcconf ha list -key all (jpchasetup list) command to check the logical host settings.
Execute the following command:
jpcconf ha list -key all (jpchasetup list)
 
Make sure that the displayed information is the same as when jpcconf ha list -key all (jpchasetup list) is executed at the executing node.
(c) Unregistering PFM - Agent for Enterprise Applications from the cluster software

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

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

(d) Deleting the settings from PFM - Manager

Use PFM - Web Console to log on to PFM - Manager and delete the definitions related to the PFM - Agent for Enterprise Applications 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 - Agent for Enterprise Applications is running on logical host jp1-halr3, execute the following command:
jpctool service delete -id service-ID -host jp1-halr3 -lhost jp1-hal (jpcctrl delete service-ID host=jp1-halr3 lhost=jp1-hal)
For 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 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.

(3) Uninstalling

Uninstall PFM - Agent for Enterprise Applications.

The uninstallation procedure is the same as for non-cluster systems. For details, see 2.2.3 Uninstallation procedure.

Notes

When you uninstall PFM - Agent for Enterprise Applications, stop all services of the Performance Management programs at the node where PFM - Agent for Enterprise Applications is to be uninstalled.

If you uninstall PFM - Agent for Enterprise Applications without deleting the logical host environment, the environment directories might remain. In such a case, delete the environment directories.

[Contents][Back][Next]

[Trademarks]