Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Configuration Guide


8.2.3 Procedure for setting up a cluster system environment (in Windows version of JP1/AJS3 - Agent)

To set up a cluster system environment in JP1/AJS3 - Agent, define the items described in 8.2.1 Environment setup items for a cluster system on both the primary and secondary nodes. Stop all JP1 services before performing this definition operation.

The following figure provides an overview of setting up the environment.

Figure 8‒5: Overview of setting up the environment (JP1/AJS3 - Agent)

[Figure]

Organization of this subsection

(1) Tasks required on the primary node

To set up a cluster system environment for JP1/AJS3 - Agent on the primary node:

  1. Perform the JP1/Base tasks required on the primary node.

    For details about the JP1/Base tasks, see the JP1/Base User's Guide.

    When you use jp1hosts2 information, use the physical merge mechanism to apply the jp1hosts2 information set in the physical host to the logical host. For details about the physical merge mechanism, see the JP1/Base User's Guide.

    Note that, when starting the physical and logical hosts concurrently, you must set the IP address of the physical host in the jp1hosts information on the physical and logical hosts or in the jp1hosts2 information on the physical host.

    Note that you might also need to set the jp1hosts or jp1hosts2 information in other cases, depending on the network configuration or the operating environment. Specify the necessary settings by referring to the notes on cluster system operation and the procedure for setting the jp1hosts or jp1hosts2 information in the JP1/Base User's Guide.

  2. Setup JP1/AJS3 - Agent on the physical host.

    Set up JP1/AJS3 - Agent on the physical host.

    For details, see 3. Setup.

  3. Execute the jajs_setup_cluster command to set up the logical host, and create the shared files and folder on the shared disk.

    The following shows the format of the jajs_setup_cluster command you execute:

    jajs_setup_cluster -h logical-host-name [-d shared-folder-name]
    • For the -h option, specify the logical host name set in JP1/Base.

    • The -d option must be specified during setup of the primary node environment. For this option, specify a folder on the shared disk in which the shared folder and files will be created. As the shared folder, specified-folder-name\jp1ajs2\ is created, and the definition files on the local disk (files in JP1/AJS3-installation-folder\conf\) are copied to the folder that is created. Before you execute the command, make sure that the shared disk is mounted. If the -d option is omitted, the secondary node environment is set up.

  4. To use queueless jobs, perform the necessary setup, as described below.

    Execute the following command:

    ajsqlsetup -h logical-host-name

    For details about the ajsqlsetup command, see ajsqlsetup in 4. Commands Used for Special Operation in the manual JP1/Automatic Job Management System 3 Command Reference.

    Cautionary note:

    Executing the ajsqlsetup command causes the files needed for queueless job execution to be created on the shared disk. Because the files are then checked, make sure that the shared disk is mounted before you attempt to execute this command.

  5. Specify the settings for restricting connection sources.

    If the setting for whether the connection source restriction function is enabled or the IP addresses permitted to connect are different from those on the physical host, set restrictions for connection sources on the logical host.

    If the setting for restricting connection sources is the same on the physical and logical host, you do not need to specify this setting on the logical host.

    For details about how to set the connection source restriction function, see 21.2 Restricting connections to JP1/AJS3.

  6. Change the value of the environment setting parameter EventServerName on the logical host.

    If a physical host name is specified in FQDN format for the environment setting parameter EventServerName on the physical host, change the value of the logical host's parameter EventServerName to a logical host name in FQDN format.

    For details about the environment setting parameter EventServerName, see 6.3.17 Setting the event server name in the system using DNS.

This completes the tasks required on the primary node.

Cautionary note:

Setup must be performed on each logical host.

(2) Tasks required on the secondary node

To set up a cluster system environment for JP1/AJS3 - Agent on the secondary node:

  1. Set up JP1/Base and JP1/AJS3 - Agent on the physical host.

    Set up JP1/Base and JP1/AJS3 - Agent on the physical host.

    For details, see 3. Setup.

  2. After completing the JP1/Base, JP1/AJS3, and JP1/IM tasks on the primary node, save the common definition information to the primary node and then set up the common definition information on the secondary node.

    After completing these tasks on the primary node, execute the jbsgetcnf command on the primary node to save the common definition information. Copy the backup file to the secondary node, specify the backup file as an argument of the jbssetcnf command, and then execute the command. The commands to be executed are as follows:

    On the primary node:

    jbsgetcnf -h logical-host-name > backup-file-name

    On the secondary node:

    jbssetcnf backup-file-name

  3. Perform the JP1/Base tasks required on the secondary node.

    For details about the JP1/Base tasks, see the JP1/Base User's Guide.

    When you use jp1hosts2 information, use the physical merge mechanism to apply the jp1hosts2 information set in the physical host to the logical host. For details about the physical merge mechanism, see the JP1/Base User's Guide. Also, in the physical host on the secondary node, set the jp1hosts2 information that has the same content as the jp1hosts2 information in the physical host on the primary node.

    Note that, when starting the physical and logical hosts concurrently, you must set the IP address of the physical host in the jp1hosts information on the physical and logical hosts or in the jp1hosts2 information on the physical host.

  4. Execute the jajs_setup_cluster command to set up the logical host.

    The following shows the format of the jajs_setup_cluster command you execute:

    jajs_setup_cluster -h logical-host-name

    For the -h option, specify the logical host name set in JP1/Base.

  5. To use queueless jobs, perform the necessary setup, as described below.

    Execute the following command:

    ajsqlsetup -h logical-host-name

    For details about the ajsqlsetup command, see ajsqlsetup in 4. Commands Used for Special Operation in the manual JP1/Automatic Job Management System 3 Command Reference.

This completes the tasks required on the secondary node.

Cautionary note:

Setup must be performed on each logical host.