Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/Base User's Guide


5.4.3 Setup

To operate JP1/Base in a cluster system, you must set up a physical host environment (for primary and secondary nodes) and a logical host environment (for primary and secondary nodes). The setup procedure is shown in the following figure.

Figure 5‒7: Setup procedure for a cluster system (In Windows)

[Figure]

Organization of this subsection

(1) Setup on the primary node

To set up the physical and logical hosts on the primary node:

  1. Set user management function for the physical host.

    Specify this option if you want to run an authentication server on the physical host. For details on the user management function, see 8.1 User management setup (in Windows).

  2. Set the logical host.

    Setting up through GUI

    1. Execute installation-folder\bin\jp1bshasetup.exe.

    Figure 5‒8: Settings for Base Cluster System dialog box

    [Figure]

    2. In the Settings for Base Cluster System dialog box, click Logical Host Settings for Primary Node System.

    Figure 5‒9: Logical Host Settings for Primary Node System dialog box

    [Figure]

    In this dialog box, specify the name of the logical host for which the information is being created, and a folder on the shared disk in which to create shared folders and shared files.

    The shared folders and shared files are created in the specified-folder\jp1base\ folder. Before you specify these items, be sure to mount the shared disk.

    3. Click the Next button.

    Figure 5‒10: Logical Host Settings for Primary Node System dialog box (confirmation window)

    [Figure]

    You can check the settings in the confirmation window of the Logical Host Settings for Primary Node System dialog box. If the settings are correct, click Finish.

    This completes all the settings except the communication protocol for the event service.

    4. Set up the authentication server on the logical host.

    By default, the authentication servers for the logical host are the same as those set for the physical host. You can use the GUI to set authentication servers different from those for the physical host. For details, see 8.1.1 Specifying the authentication servers to use.

    Set up by using commands

    Execute the command as follows: Create a shared folder and shared files on a shared disk to set up the authentication server.

    jbs_setup_cluster -h node0 -d d:\node0 -a node0

    For details on the jbs_setup_cluster command, see jbs_setup_cluster (Windows only) in 15. Commands.

  3. Set up user management for the logical host.

    Specify this option if you want to run an authentication server on the logical host.

    Set up by using the GUI

    1. From the Windows Start menu, choose Programs, JP1_Base, and then setup.

    2. In the Select Logical Host dialog box, select the logical host for which you want to set up user management.

    Set up by using commands

    1. Register the JP1 user (only when using the logical host as the authentication server).

    Make sure that the authentication server is active, and then execute the following command to register a JP1 user:

    jbsadduser -h logical-host-name JP1-user-name

    To check the registered JP1 user, execute the following command:

    jbslistuser -h logical-host-name

    2. Register the user mapping information in the common definition information.

    The user mapping definition file (jp1BsUmap.conf) resides in the following location:

    shared-folder\jp1base\conf\user_acl\jp1BsUmap.conf

    After editing the file (jp1BsUmap.conf), execute the following command to register the user mapping definition information:

    jbsmkumap -h logical-host-name

    To check the registered user mapping information, execute the following command:

    jbsgetumap -h logical-host-name

    3. Set JP1 user operating permissions (only when using the logical host as the authentication server).

    The user permission level file (JP1_UserLevel) is located in the following directory:

    shared-folder\conf\user_acl\JP1_UserLevel

    After editing this file (JP1_UserLevel), execute the jbsaclreload command to apply the settings.

    For details on the user management function, see 8.1 User management setup (in Windows).

  4. Change the JP1/Base communication protocol.

    Change the communication protocol for JP1/Base on physical and logical hosts as required.

    For details on whether changing the communication protocol is required and how to do so, see 6. JP1/Base Communication Settings According to Network Configurations.

    Notes on operating authentication servers in a cluster system:

    The settings files for authentication servers are stored in the following folder:

    shared-folder\jp1base\conf\user_acl\

    If you are using a secondary authentication server, you must copy the settings files from the primary authentication server to the secondary authentication server. Note that the copy destination varies depending on whether you use the secondary authentication server in a cluster system:

    When using a cluster system:

    shared-folder\jp1base\conf\user_acl\

    When not using a cluster system:

    installation-folder\conf\user_acl\

    After copying the settings files, execute the following command to apply the settings. You need to specify the -h option only if you use the secondary authentication server in a cluster system.

    jbs_spmd_reload -h logical-host-name

This completes JP1/Base setup on the primary node.

If any of the programs that require JP1/Base (JP1/IM, JP1/AJS, or JP1/Power Monitor) are installed, you must complete the failover settings for these programs. For details, see the Job Management Partner 1/Integrated Management - Manager Configuration Guide, Job Management Partner 1/Integrated Management - Manager Administration Guide, Job Management Partner 1/Automatic Job Management System 2 Planning and Administration Guide, Job Management Partner 1/Automatic Job Management System 3 System Design (Configuration) Guide, Job Management Partner 1/Automatic Job Management System 3 System Design (Work Tasks) Guide, Job Management Partner 1/Automatic Job Management System 3 Administration Guide, and the Job Management Partner 1/Power Monitor Description, User's Guide and Reference.

(2) Setup on the secondary node

To set up the physical and logical hosts on the secondary node:

Before you start setup on the secondary node, make sure that you complete the setup tasks for JP1/Base and the programs that require JP1/Base (JP1/IM, JP1/AJS, or JP1/Power Monitor) on the primary node.

  1. Set user management function for the physical host.

    Specify this option if you want to run an authentication server on the physical host. For details on the user management function, see 8.1 User management setup (in Windows).

  2. On the primary node, execute the jbsgetcnf command.

    Execute the following command on the primary node: This command saves the common definition information to the backup file.

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

    Note that the logical host name must be correctly specified with lower or upper case as specified when the logical host was set up.

  3. Copy the backup file to the secondary node.

  4. On the secondary node, execute the jbssetcnf command:

    Execute the following command on the secondary node: In backup-file-name, specify the backup file created by the jbsgetcnf command.

    jbssetcnf backup-file-name
  5. Set the logical host.

    Setting up through GUI

    1. Execute installation-folder\bin\jp1bshasetup.exe.

    2. In the Settings for Base Cluster System dialog box, click Logical Host Settings for Secondary Node System.

    In the Logical Host Settings for Secondary Node System dialog box, select the logical host name assigned to the primary node.

    Figure 5‒11: Logical Host Settings for Secondary Node System dialog box

    [Figure]

    3. Click the Next button.

    Figure 5‒12: Logical Host Settings for Secondary Node System dialog box (confirmation window)

    [Figure]

    You can check the settings in the confirmation window of the Logical Host Settings for Secondary Node System dialog box. If the settings are correct, click the Finish button.

    Set up by using commands

    Execute the command as follows:

    jbs_setup_cluster -h node0

    For details on the jbs_setup_cluster command, see jbs_setup_cluster (Windows only) in 15. Commands.

  6. Change the communication protocol of JP1/Base.

    Change the communication protocol of JP1/Base on physical hosts as required. This setting is not required on logical hosts.

    For details on whether changing the communication protocol is required and how to do so, see 6. JP1/Base Communication Settings According to Network Configurations.

This completes JP1/Base setup on the secondary node.

(3) Disabling Dr. Watson error notification (primary and secondary nodes) (Windows Server 2003 or Windows XP only)

The display of the Dr. Watson message box for reporting an application error might prevent failovers from occurring. As this might prevent JP1/Base from failing over successfully, you must disable the box display.

Note that disabling error notification might affect information acquisition when an application error occurs.

To disable Dr. Watson error notification:

  1. From the command prompt, enter drwtsn32 -i to enable settings for Dr. Watson.

    This command installs Dr. Watson as the default application debugger.

  2. From the Start menu, choose Run.

  3. Type drwtsn32 in the text box and click the OK button.

  4. In the Dr. Watson dialog box, clear the Visual Notification check box.

  5. Click the OK button.

(4) Disabling Microsoft error reporting (primary and secondary nodes) (Windows Server 2003 or Windows XP only)

In Windows, when an application error occurs, a dialog box appears for reporting the error to Microsoft. The display of this dialog box might prevent failovers from occurring. You must therefore disable such error reporting.

To disable Microsoft error reporting:

In Windows Server 2003
  1. In the Control Panel, double-click System.

  2. In the System Properties dialog box, select the Advanced tab and then click Error Reporting.

  3. In the Error Reporting dialog box, select the Disable error reporting radio button and then clear the But notify me when critical errors occur check box.

  4. Click the OK button.