2.9.2 Specifying environment information for cluster operation

(a) Evaluating the configuration of directories and files

Evaluate according to the system operation guidelines the directory and file configuration items shown in the following table.

Table 2‒25: Directory and file configuration evaluation items

Type of directory or file	Creation criterion
Directory for temporary files	S or L
Directory for the spool	S
Directory for system execution logs	S or L
Directory for traces	L
System environment file	L
Job environment file	S or L
Job definition script	S or L
File referenced from job definition scripts	S or L
Other	S or L

(b) Specifying environment information on the physical hosts

Specify the environment information for JP1/Advanced Shell on the physical hosts of the active and standby servers. For details about the specification of environment information, see 2.6 Specifying environment information for JP1/Advanced Shell.

(c) Specifying environment information on the logical host

Specify the environment information for JP1/Advanced Shell on the logical host of the active server.

To specify the environment information on the logical host:

1. Create the directories needed for execution.

   According to the directory configuration evaluated in (a) Evaluating the configuration of directories and files, create the following directories required for running JP1/Advanced Shell on the shared disk or logical disk:

   • Directory for temporary files

   • Directory for the spool

   • Directory for system execution logs

   • Directory for traces

   The following explains how to create directories:

   • When creating the directories on the shared disk

     Create the directories on the shared disk in such a manner that the active server can access the shared disk.

   • When creating the directories on the local disk

     Create the directories on the local disks of both the active and standby servers.

2. Specify the environment file.

   You must specify the settings required for each logical host in the system environment file of JP1/Advanced Shell. To do this, specify the environment setting parameters for each logical host between the lhost_start and lhost_end conditional parameters. For details about the lhost_start and lhost_end conditional parameters, see lhost_start and lhost_end parameters (define a set of parameters applicable only to a specified logical host) in 7.4 Conditional parameters.

   To run JP1/Advanced Shell in a logical host environment, specify at least the following parameters in the system environment file:

   • Parameters for the directories required for running JP1/Advanced Shell

     According to the directory configuration evaluated in (a) Evaluating the configuration of directories and files, specify in the system environment file the directories created in step 1. Specify these directories in the system environment file only, so that they are swapped when system switchover occurs. Do not specify them in job environment files. For details about the parameters for directories required for running JP1/Advanced Shell, see 2.6.19 Creating the directories required for JP1/Advanced Shell.

   • Parameters for the user-reply functionality

     If you will be using the user-reply functionality in a logical host environment, specify in the system environment file the appropriate parameters for the user-reply functionality for the logical host.

     For details about the parameters for the user-reply functionality, see 2.8.1 Specifying the environment files to use the user-reply functionality.

   An example of the settings in the system environment file with physical and logical hosts specified are shown below. In this example, /shdsk1/lhost001 and /shdsk2/lhost002 are directories on the shared disk, and /lhost001, /lhost002, and /phost are directories on the local host.

   ###
   ### Settings common to both physical and logical hosts
   ###
    
   #-adsh_conf USERREPLY_JP1EVENT_INTERVAL   500
    
   ###
   ### Settings for each of the physical and logical hosts
   ###
    
   #### specify parameter for only logical host (lhost001).
   #-adsh_conf lhost_start                   lhost001
   #-adsh_conf LOG_DIR                       "/shdsk1/lhost001/log"
   #-adsh_conf SPOOL_DIR                     "/shdsk1/lhost001/spool"
   #-adsh_conf TEMP_FILE_DIR                 "/shdsk1/lhost001/temp"
   #-adsh_conf TRACE_DIR                     "/lhost001/trace"
   #-adsh_conf HOSTNAME_JP1IM_MANAGER        IMlhost001
   #-adsh_conf USERREPLY_WAIT_MAXCOUNT       5
   #-adsh_conf lhost_end
    
   #### specify parameter for only logical host (lhost002).
   #-adsh_conf lhost_start                   lhost002
   #-adsh_conf LOG_DIR                       "/shdsk2/lhost002/log"
   #-adsh_conf SPOOL_DIR                     "/shdsk2/lhost002/spool"
   #-adsh_conf TEMP_FILE_DIR                 "/shdsk2/lhost002/temp"
   #-adsh_conf TRACE_DIR                     "/lhost002/trace"
   #-adsh_conf HOSTNAME_JP1IM_MANAGER        IMlhost002
   #-adsh_conf USERREPLY_WAIT_MAXCOUNT       5
   #-adsh_conf lhost_end
    
   #### specify parameter for physical host.
   #-adsh_conf phost_start
   #-adsh_conf LOG_DIR                       "/phost/log"
   #-adsh_conf SPOOL_DIR                     "/phost/spool"
   #-adsh_conf TEMP_FILE_DIR                 "/phost/temp"
   #-adsh_conf TRACE_DIR                     "/phost/trace"
   #-adsh_conf HOSTNAME_JP1IM_MANAGER        IMphost001
   #-adsh_conf USERREPLY_WAIT_MAXCOUNT       10
   #-adsh_conf phost_end

3. Register the user-reply functionality's management service for the logical hosts (Windows only).

   To use the user-reply functionality in a logical host environment, you must register the user-reply functionality's management service for the logical hosts on both the active and standby servers. You can use the adshmsvcd and adshmsvce commands to register the user-reply functionality's management service. To register the service for a logical host, execute the command with the -install and -lhostname options specified.

   When the command terminates normally, the registered service is displayed in the Services administrative tool.

   For example, to use lhost001 as a logical host in the execution environment of the active server, execute the following command:

   adshmsvce -install -lhostname lhost001

   If the command terminates normally, AdshmSvcE_ lhost001 is displayed in the Services administrative tool.

4. Check the file configuration on the active and standby servers.

   According to the file configuration evaluated in (a) Evaluating the configuration of directories and files, perform the following tasks:

   • For the files to be created on the local disk

     The configuration of the files to be referenced and the file contents must be identical between the active and standby servers. Copy the files created on the local disk of the active server, such as the system environment file created in step 2. Specify the environment file, to the same path on the standby server.

   • For the files to be created on the shared disk

     Create the files so that the active server can access them on the shared disk.

     Important note

     For the created files, set the permissions so that they can be accessed from both the active and standby servers. If access permissions are granted to a specific user or group, you must specify the same user name and user ID (UID) or the same group name and group ID (GID) on both the active and standby servers.

(a) Registering into the cluster software

In Windows, register into the cluster software the service with the name shown in the following that has been registered as a service for the logical host:

Name	Service name
AdshmSvcE_logical-host-name	User-reply functionality's management service

For details about how to register the service, see the applicable cluster software's documentation. After you have registered the user-reply functionality's management service into the cluster software, use the cluster software to start and stop the service.

(b) Specifying the start and stop sequence

To run the user-reply functionality's management service on the logical host, the shared disk and logical IP address must be available. The start and stop sequence depends on the linked JP1-series products.

• When the logical host is started

  1. Allocate the shared disk and logical IP address and enable them.

  2. Start the services of the linked JP1-series products (except JP1/AJS).^#

  3. Start the user-reply functionality's management service.

  4. Start the services of JP1/AJS.

• When the logical host is terminated

  1. Stop the services of JP1/AJS.

  2. Stop the user-reply functionality's management service.

  3. Stop the services of the linked JP1-series products (except JP1/AJS).^#

  4. Release the allocation of the shared disk and the logical IP address.

#

For details about the start and stop sequence among the services of the linked JP1-series products, see the individual product manuals.

(a) Registering into the cluster software

The following table provides the information needed for registering the user-reply functionality's management daemon into the cluster software.

Table 2‒26: Functions to be registered in to the cluster software and the commands used by each function

Function to be registered	Description
Start	Starts the user-reply functionality's management daemon. Command to be used adshmdctl Example adshmdctl -h logical-host-name start Checking the result of starting the daemon Use the operation monitoring described below to check the result of starting the user-reply functionality's management daemon; do not use the return code.
Stop	Stops the user-reply functionality's management daemon. Command to be used adshmdctl Example adshmdctl -h logical-host-name stop Checking the result of stopping the daemon Use the operation monitoring described below to check the result of stopping the user-reply functionality's management daemon; do not use the return code.
Operation monitoring	Monitors the user-reply functionality's management daemon to check if it is running normally. Command to be used adshmdctl Example adshmdctl -h logical-host-name status Checking the result of operation monitoring The following explains the return code: Return code = 0 (running) The user-reply functionality's management daemon is running normally. Return code = 1 (stopped) The user-reply functionality's management daemon is stopped for some reason. Treat this status as an error.

For details about the adshmdctl command, see adshmdctl command (starts and stops the user-reply functionality management daemon) (UNIX only) in 8. Commands Used During Operations.

Important note

If the user-reply functionality's management daemon is terminated without releasing the shared memory due to some error, the next startup will fail. If this occurs, take appropriate action according to the information provided in Function in adshmdctl command (starts and stops the user-reply functionality management daemon) (UNIX only) in 8. Commands Used During Operations.

(b) Specifying the start and stop sequence

To run the user-reply functionality's management daemon on the logical host, the shared disk and logical IP address must be available. The start and stop sequence depends on the linked JP1-series products.

• When the logical host is started

  1. Allocate the shared disk and logical IP address and enable them.

  2. Start the daemons and services of the linked JP1-series products (except JP1/AJS).^#

  3. Start the user-reply functionality's management daemon.

  4. Start the services of JP1/AJS.

• When the logical host is terminated

  1. Stop the services of JP1/AJS.

  2. Stop the user-reply functionality's management daemon.

  3. Stop the daemons and services of the linked JP1-series products (except JP1/AJS).^#

  4. Release the allocation of the shared disk and the logical IP address.

#

For details about the start and stop sequence among the services of the linked JP1-series products, see the individual product manuals.