17.2.8 Deleting logical hosts

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
(2) JP1/AJS3 - Agent
(3) Environment setting parameters

(1) JP1/AJS3 - Manager

To delete the JP1/AJS3 - Manager logical host:

Stop the JP1/AJS3 service.

Stop the processes related to the JP1/AJS3 services on the physical host and all logical hosts. If processes for using additional JP1/AJS3 functions such as the definition pre-check function are running, also stop such processes.

For details about the command that stops processes related to the JP1/AJS3 services, see 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.
Execute the ajsshmdel command to delete the information about the shared memory.

The ajsshmdel command is located in /opt/jp1ajs2/bin/ajsshmdel.

If the shell is sh, the command line is as follows:

ajsshmdel -all>/dev/null 2>&1

If the shell is csh, the command line is as follows:

ajsshmdel -all>&/dev/null
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 host information from the common definition information.

To do this, execute the jbsunsetcnf -i -h logical-host-name command of JP1/Base. For details about the jbsunsetcnf command, see the JP1/Base User's Guide.

If you want to delete only the common definition information for JP1/AJS3 on logical hosts without deleting JP1/Base, execute the following commands to delete the information:

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 no information has been set when you execute the above commands, the following message might appear. If the message appears, ignore it.

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 execute the jbsunsetcnf command, the logical host information for JP1/Base, JP1/IM, and JP1/AJS3 is deleted. However, the shared files and shared directories on the shared disk are not deleted, and must be deleted manually.

Perform this step on either the primary node or secondary node.
Change the common definition information on the JP1/AJS3 physical host so that cluster operation is not set.

If you have deleted all logical hosts, change the common definition information 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) Environment setting parameters below.
```
jajs_config -k "definition-key" "parameter-name"=value
```
Cautionary note:

The jajs_config command must be executed for each definition key.
If the JP1_HOSTNAME environment variable has been set, delete it.

To Page Top

(2) JP1/AJS3 - Agent

To delete the JP1/AJS3 - Agent logical host:

Stop the JP1/AJS3 service.

Stop the processes related to the JP1/AJS3 services on the physical host and all logical hosts. If processes for using additional JP1/AJS3 functions such as the definition pre-check function are running, also stop such processes.

For details about the command that stops processes related to the JP1/AJS3 services, see 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.
Delete the logical host information from the common definition information.

To do this, execute the jbsunsetcnf -i -h logical-host-name command of JP1/Base. For details about the jbsunsetcnf command, see the JP1/Base User's Guide.

If you want to delete only the common definition information for JP1/AJS3 on logical hosts without deleting JP1/Base, execute the following commands to delete the information:
```
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 no information has been set when you execute the above commands, the following message might appear. If the message appears, ignore it.
```
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 execute the jbsunsetcnf command, the logical host information for JP1/Base, JP1/IM, and JP1/AJS3 is deleted. However, the shared files and shared directories on the shared disk are not deleted, and must be deleted manually.

Perform this step on either the primary node or secondary node.
Change the common definition information on the JP1/AJS3 physical host so that cluster operation is not set.

If you have deleted all logical hosts, change the common definition information 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) Environment setting parameters below.
```
jajs_config -k "definition-key" "parameter-name"=value
```
Cautionary note:

The jajs_config command must be executed for each definition key.
If the JP1_HOSTNAME environment variable has been set, delete it.

To Page Top

(3) Environment setting parameters

Table 17‒6: Environment setting parameters to set when deleting JP1/AJS3 - Manager and JP1/AJS3 - Agent logical hosts
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.

To Page Top