jpcconf ha unsetup
- Organization of this page
Format
jpcconf ha unsetup -key service-key -lhost logical-host-name
Function
The jpcconf ha unsetup command deletes a Performance Management logical host environment.
This command can be executed only for a Performance Management product that supports logical host operation. PFM - Manager supports logical host operation. For details about the logical host operation of a particular PFM - Agent or PFM - RM, see the chapter in the relevant PFM - Agent or PFM - RM manuals that describes cluster system operations.
Hosts that can execute the command
-
PFM - Manager
-
PFM - Agent
-
PFM - RM
Execution permission
- In Windows:
-
User with Administrators permissions
- In UNIX:
-
User with root user permissions
Installation directory
- In Windows:
installation-folder\tools\
- In UNIX:
/opt/jp1pc/tools/
Arguments
-key service-key
Specifies the service key of the Performance Management program whose logical host environment is to be deleted. A product name can also be specified when the product name display functionality is enabled.
You can specify the following in service-key:
-
all: Specifies all Performance Management services set up on the specified logical host.
-
Manager or mgr: Specifies the PFM - Manager services (including the Action Handler service).
-
Service key of a PFM - Agent or PFM - RM service: Deletes a particular PFM - Agent or PFM - RM service (including the Action Handler service). For details about the service key of the PFM - Agent or PFM - RM service, see the naming rules described in the appendix of the JP1/Performance Management Planning and Configuration Guide.
act (service key of the Action Handler service) cannot be specified.
When one of the following values is specified for the service key, the logical host environment settings for the Performance Management program service are displayed:
-
Manager or mgr
-
Service key of the PFM - Agent service
-
Service key of the PFM - RM service
Specifying all in service-key deletes the logical host environment for all Performance Management services set up on the specified logical host. Specifying the service key of a Performance Management product that does not support logical host operation results in an error.
If this command is executed to delete all Performance Management services that have been set up on the specified logical host, the logical host environment including the Action Handler service is deleted automatically.
-lhost logical-host-name
Specifies the host name of the logical host environment to be deleted.
If the specified logical host name has not been set up, an error results.
To check the logical host environments that have been set up, use jpcconf ha list -key all.
Notes
-
Because the logical host environment file is deleted from a shared disk, before you execute this command to delete a logical host environment you must place the shared disk online (mount the disk in UNIX). If the command cannot access the shared disk, it will delete only the logical host settings information and the Windows service.
-
Before you execute this command, stop all Performance Management services, including the physical host and each logical host on the node.
-
If command execution is interrupted by pressing the Ctrl + C keys or by a signal, a predefined return value is not returned. Therefore, you should ignore the return value when the command was interrupted by the Ctrl + C keys or by a signal.
-
When you delete the logical host environment of PFM - Manager, the setting of the health check function (enabled or disabled) of PFM - Manager in the physical host environment inherits the setting that existed before the logical host environment was created.
-
When you delete the logical host environment of PFM - Manager, the monitoring suspension settings for the physical host environment inherit the settings that existed before the logical host environment was created.
Return values
0 |
The command terminated normally. |
Other values |
The command terminated abnormally. |
Usage example
This example deletes the logical host environment for the PFM - Manager whose logical host name is jp1-ha1:
jpcconf ha unsetup -key Manager -lhost jp1-ha1