8.2.8 Deleting logical hosts
In Windows, if you want to delete a logical host, you must do so on both the primary and secondary nodes. The following describes how to delete a logical host.
Most of the procedures described in this subsection must be performed on both the primary and secondary nodes. Procedures to be performed on only one node or only under certain conditions are noted accordingly.
- Organization of this subsection
(1) JP1/AJS3 - Manager
To delete the JP1/AJS3 - Manager logical host:
-
Stop the JP1/AJS3 service.
Stop all JP1/AJS3 services on the physical host and all logical hosts.
-
Uninstall the database environment set up on the logical host.
Execute the ajsembdbuninstl command to uninstall the database environment set up on the logical host. If you delete the logical host without also uninstalling the database environment, you will be no longer able to uninstall the database environment. For details about the ajsembdbuninstl command, see ajsembdbuninstl in 2. Commands Used during Setup in the manual JP1/Automatic Job Management System 3 Command Reference.
The command is executed in the following format:
ajsembdbuninstl -mh logical-host-name
-
Delete the logical hosts for JP1/Base.
For details about how to delete the logical hosts, see the JP1/Base User's Guide.
- Cautionary note:
-
To delete only the JP1/AJS3 logical host information without deleting the JP1/Base logical host, perform the following procedure:
1. Delete the JP1/AJS3 logical host service.
Execute the following command to delete the logical host service:
sc delete JP1_AJS2_logical-host-name
The sc command is a Windows command. For details about the sc command, see the Microsoft documentation.
2. Delete the environment setting parameters related to the logical host.
Execute the following commands to delete these parameters:
jbsunsetcnf -i -h logical-host-name -c JP1AJS2
jbsunsetcnf -i -h logical-host-name -c JP1NBQAGENT
jbsunsetcnf -i -h logical-host-name -c JP1NBQMANAGER
jbsunsetcnf -i -h logical-host-name -c JP1NBQCLIENT
jbsunsetcnf -i -h logical-host-name -c JP1NBQNOTIFY
jbsunsetcnf -i -h logical-host-name -c JP1AOMMANAGER
jbsunsetcnf -i -h logical-host-name -c JP1AOMAGENT
jbsunsetcnf -i -h logical-host-name -c JP1AJSMANAGER
jbsunsetcnf -i -h logical-host-name -c JP1AJS2COMMON
jbsunsetcnf -i -h logical-host-name -c JP1QLAGENT
If a command attempts to delete a parameter that does not exist and the following message is output, ignore the message:
KAVA0405-I The specified string-specified-in-the-c-option does not exist [logical-host-name]. Processing Stops.
-
Delete the shared files and directories on the shared disk.
When you delete the logical hosts, the logical host information and services for JP1/Base, JP1/IM, and JP1/AJS3 are also deleted. However, the shared files and shared folders on the shared disk are not deleted, and must be deleted manually.
Perform this step on either the primary node or the secondary node that can access the shared disk.
-
Change the environment setting parameter on the JP1/AJS3 physical host so that cluster operation is not set.
If you have deleted all logical hosts, change the environment setting parameter on the JP1/AJS3 physical host so that cluster operation is not set. Note that, after deleting all logical hosts, if you immediately rebuild logical hosts without starting the physical host even once, this step is unnecessary.
To do this, execute the following command to set the environment setting parameters described in (3) below.
jajs_config -k definition-key "parameter-name"=value
- Cautionary note:
-
The jajs_config command must be executed for each definition key.
-
Delete the JP1_HOSTNAME environment variable.
(2) JP1/AJS3 - Agent
To delete the JP1/AJS3 - Agent logical host:
-
Stop the JP1/AJS3 service.
Stop all JP1/AJS3 services on the physical host and all logical hosts.
-
Delete the logical hosts for JP1/Base.
For details about how to delete the logical hosts, see the JP1/Base User's Guide.
- Cautionary note:
-
To delete only the JP1/AJS3 logical host information without deleting the JP1/Base logical host, perform the following procedure:
1. Delete the JP1/AJS3 logical host service.
Execute the following command to delete the logical host service:
sc delete JP1_AJS2_logical-host-name
The sc command is a Windows command. For details about the sc command, see the Microsoft documentation.
2. Delete the environment setting parameters related to the logical host.
Execute the following commands to delete these parameters:
jbsunsetcnf -i -h logical-host-name -c JP1AJS2
jbsunsetcnf -i -h logical-host-name -c JP1NBQAGENT
jbsunsetcnf -i -h logical-host-name -c JP1NBQCLIENT
jbsunsetcnf -i -h logical-host-name -c JP1NBQNOTIFY
jbsunsetcnf -i -h logical-host-name -c JP1AOMAGENT
jbsunsetcnf -i -h logical-host-name -c JP1AJS2COMMON
jbsunsetcnf -i -h logical-host-name -c JP1QLAGENT
If a command attempts to delete a parameter that does not exist and the following message is output, ignore the message:
KAVA0405-I The specified string-specified-in-the-c-option does not exist [logical-host-name]. Processing Stops.
-
Delete the shared files and directories on the shared disk.
When you delete the logical hosts, the logical host information and services for JP1/Base, JP1/IM, and JP1/AJS3 are also deleted. However, the shared files and shared folders on the shared disk are not deleted, and must be deleted manually.
Perform this step on either the primary node or the secondary node that can access the shared disk.
-
Change the environment setting parameter on the JP1/AJS3 physical host so that cluster operation is not set.
If you have deleted all logical hosts, change the environment setting parameter on the JP1/AJS3 physical host so that cluster operation is not set. Note that, after deleting all logical hosts, if you immediately rebuild logical hosts without starting the physical host even once, this step is unnecessary.
To do this, execute the following command to set the environment setting parameters described in (3) below.
jajs_config -k definition-key "parameter-name"=value
- Cautionary note:
-
The jajs_config command must be executed for each definition key.
-
Delete the JP1_HOSTNAME environment variable.
(3) Environment setting parameters
|
Definition key |
Environment setting parameter |
Value |
|---|---|---|
|
[JP1_DEFAULT\JP1NBQAGENT\Process] |
IsHA |
dword:00000000 |
|
[JP1_DEFAULT\JP1NBQCLIENT\Process] |
IsHA |
dword:00000000 |
|
[JP1_DEFAULT\JP1NBQMANAGER\Process]# |
IsHA |
dword:00000000 |
|
[JP1_DEFAULT\JP1NBQNOTIFY\Process] |
IsHA |
dword:00000000 |
- #:
-
Because this is a JP1/AJS3 - Manager environment setting parameter, change the setting only in JP1/AJS3 - Manager. You do not need to change this setting in JP1/AJS3 - Agent.
For details about these environment parameters, see 20.5 Setting up the job execution environment.