Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/Integrated Management - Manager Configuration Guide

6.2.2 Installing and setting up the logical host (new installation and setup)

This subsection describes the new installation and setup of the logical host for JP1/IM - Manager. It also describes the setup of JP1/Base because JP1/Base must be set up on the same logical host.

Before you start the procedure, check the following information about the cluster system.

Table 6‒7: Items to be checked before you install and set up the logical host (Windows)

Item to be checked

Description

Logical host name

Name of the logical host that executes JP1

Logical IP address

IP address that corresponds to the logical host name

Shared folder

Folder on the shared disk that stores a set of files for the JP1 execution environment on the logical host

Additionally, make sure that these items satisfy the prerequisites described in 6.1.2 Prerequisites for cluster operation.

Once you have finished checking the above items, you are ready to start the installation and setup.

Note that logical host names are case sensitive. Specify the logical host names set in JP1/Base in the correct form, including case. If you set up and install a logical host after specifying an incorrect logical host name, delete the IM databases and the logical host, and then install and set up the logical host again. For details about how to delete IM databases and logical hosts, see 6.2.6 Deleting the IM databases and logical host.

Organization of this subsection

(1) Installing

Install JP1/IM - Manager and JP1/Base on the local disk of both the primary server and the secondary server.

To install:

  1. Install JP1/Base.

  2. Install JP1/IM - Manager.

Use an installation folder and disk that have the same names on the primary server and the secondary server.

Do not install these programs on the shared disk.

To Page Top

(2) Setting up the physical host environment

At each server, set up the physical host environment for JP1/Base and JP1/IM - Manager.

To set up the physical host environment:

  1. Set up the physical host environment for JP1/Base.

  2. Set up the physical host environment for JP1/IM - Manager.

For details about how to set up JP1/Base, see the Job Management Partner 1/Base User's Guide.

The setup procedure for JP1/IM - Manager is the same as for non-cluster operation. See 1. Installation and Setup (for Windows). If you will not be using JP1/IM - Manager at the physical host, there is no need to perform this setup.

To Page Top

(3) Setting up the logical host environment (primary node)

(a) Preparations for setup

To prepare for setup:

  1. Make sure that the services of JP1/IM and JP1/Base are stopped.

    Make sure that the services of JP1/IM and JP1/Base are stopped on the physical host and all logical hosts. If JP1/IM - MO is used, also stop the JP1/IM - Message Optimizer service of JP1/IM - MO on the connection source.

  2. Make sure that the shared disk is available.

(b) Setting up JP1/Base

To set up JP1/Base:

  1. Set up the logical host for JP1/Base (primary node).

    For details about the procedure, see the Job Management Partner 1/Base User's Guide.

  2. Set up a command execution environment for JP1/Base.

    Execute the jcocmddef command to set up a command execution environment for JP1/Base. For details about the jcocmddef command, see the Job Management Partner 1/Base User's Guide.

(c) Setting up JP1/IM - Manager

This subsection explains the following settings:

  • Setting JP1/IM - Manager (Central Console)

  • Setting JP1/IM - Manager (Central Scope)

  • Setting JP1/IM - Manager (IM Configuration Management)

  • Setting JP1/IM - Manager (IM database)

Note that the setup of JP1/IM - Manager (Central Scope), JP1/IM - Manager (IM Configuration Management), and JP1/IM - Manager (IM database) is optional. If you do not use these products, there is no need to set them up.

■ Setting JP1/IM - Manager (Central Console)

To set JP1/IM - Manager (Central Console):

  1. Open the setup window for the logical host of JP1/IM - Manager (Central Console).

    When you execute Console-path\bin\jp1cohasetup.exe, the following window appears.

    Figure 6‒6: Window for setting the logical host (primary node)

    [Figure]

  2. Click the Logical Host Settings for Primary Node System button.

    The following window appears.

    Figure 6‒7: Window for setting the logical host (primary node)

    [Figure]

    Specify the logical host name and file folder.

    • Logical host name

      The logical host names created in JP1/Base are displayed. Select the logical host name.

    • File folder

      Specify a folder on the shared disk. A set of JP1/IM - Manager files for the logical host is created under specified-folder-name\jp1cons\.

    After you have specified the above information, click the Next button.

  3. Check the settings.

    The following window appears.

    Figure 6‒8: Window for setting the logical host (primary node)

    [Figure]

    Check the settings. If the settings are correct, click the Finish button.

    To achieve correct failover operation, customize the environment settings for JP1/IM - Manager (Central Console) for the logical host.

  4. Setting re-execution of automated actions.

    Execute the following command to set re-execution of automated actions in the event of failover:

    jcoimdef -r { EXE | OUTPUT | OFF } -h logical-host-name

    You can set the re-execution of the actions for any of the following statuses at failover:

    • Waiting to be sent

    • Waiting to be sent (being canceled)

    • Waiting to be sent (failed to be canceled)

    • Sending

    • Sending (being canceled)

    • Sending (failed to be canceled)

    • Queuing

    • Queuing (being canceled)

    • Queuing (failed to be canceled)

    • Running

    • Running (being canceled)

    • Running (failed to be canceled)

    If you specify EXE, the actions will be re-executed. If you specify OUTPUT, a list of actions will be output to a file. If you specify OFF, the actions will not be performed. Specify this setting according to your evaluation during the system design. This setting is optional.

    For details about the jcoimdef command, see jcoimdef in 1. Commands in the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.

■ Setting JP1/IM - Manager (Central Scope)

This subsection describes the setting procedure for using JP1/IM - Manager (Central Scope). The windows displayed for this setting are the same as for JP1/IM - Manager (Central Console) except for the title bar that displays Central Scope.

To set JP1/IM - Manager (Central Scope):

  1. Open the window for setting the logical host for JP1/IM - Manager (Central Scope).

    Execute Scope-path\bin\jp1cshasetup.exe.

  2. Click the Logical Host Settings for Primary Node System button.

    In the Logical Host Settings for Primary Node System window, specify the logical host name and file folder.

    • Logical host name

      The logical host names created in JP1/Base are displayed. Select the logical host name.

    • File folder

      Specify a folder on the shared disk. A set of JP1/IM - Manager files for the logical host is created under the specified-folder-name\jp1scope\ folder.

    After you have specified the above information, click the Next button.

  3. Check the settings.

    When the confirmation window appears, check the settings. If the settings are correct, click the Finish button.

■ Setting JP1/IM - Manager (IM Configuration Management)

This subsection describes the setting procedure for using JP1/IM - Manager (IM Configuration Management). The windows displayed for this setting are the same as for JP1/IM - Manager (Central Console) except for the title bar that displays Configuration Management.

To set JP1/IM - Manager (IM Configuration Management):

  1. Open the window for setting the logical host for JP1/IM - Manager (IM Configuration Management).

    Execute the Manager-path\bin\imcf\jp1cfhasetup.exe command.

  2. Click the Logical Host Settings for Primary Node System button.

    In the Logical Host Settings for Primary Node System window, specify a logical host name and a file folder.

    • Logical host name

      The name of the logical host created in JP1/Base appears. Select this name.

    • File folder

      Specify a folder on the shared disk. The files for JP1/IM - Manager on the logical host are created under the specified-folder-name\jp1imm\ folder,.

    After you have specified the above information, click the Next button.

  3. Check the settings.

    When the confirmation window appears, check the settings. If the settings are correct, click the Finish button.

■ Setting JP1/IM - Manager (IM database)

This subsection describes the setting procedure for using JP1/IM - Manager (IM database). If you want to use the IM Configuration Management database to manage system hierarchies (IM configurations), you need to create an IM database.

To set JP1/IM - Manager (IM database):

  1. Edit the cluster setup information file.

    Prepare a cluster setup information file that contains information about the size of the database area required for creating the IM databases and the database storage directory.

    For details about the settings in the cluster setup information file, see Cluster setup information file (jimdbclustersetupinfo.conf) in 2. Definition Files in the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.

  2. Execute the jcodbsetup command to create an integrated monitoring database.

    jcodbsetup -f cluster-setup-information-file-name -h logical-host-name -c online [-q]

    Use arguments to specify the cluster setup information file name, logical host name, and setup type.

    • cluster-setup-information-file-name (-f option)

      Specify the name of the cluster setup information file that was created in step 1.

    • logical-host-name (-h option)

      Specify the logical host name that was set up at the primary server.

      As the logical host name, specify the logical host name set in JP1/Base in the correct form, including case. For details about how to set up JP1/Base, see 6.2.2(3)(b) Setting up JP1/Base.

    • Setup type (-c option)

      Specify the setup type (online) of the active host.

      When you specify online, mount the shared disk and permit the logical host to access it.

    For details about the jcodbsetup command, see jcodbsetup in 1. Commands in the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.

  3. Execute the jcoimdef command to enable the integrated monitoring database.

    jcoimdef -db ON -h logical-host-name

    For details about the jcoimdef command, see jcoimdef in 1. Commands in the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.

  4. Execute the jcfdbsetup command to create an IM Configuration Management database.

    jcfdbsetup -f cluster-setup-information-file-name -h logical-host-name -c online [-q]

    Use arguments to specify the cluster setup information file name, logical host name, and setup type.

    • cluster-setup-information-file-name (-f option)

      Specify the name of the cluster setup information file that was created in step 1.

    • logical-host-name (-h option)

      Specify the logical host name that was set up at the primary server.

      As the logical host name, specify the logical host name set in JP1/Base in the correct form, including case. For details about how to set up JP1/Base, see 6.2.2(3)(b) Setting up JP1/Base.

    • Setup type (-c option)

      Specify the setup type (online) of the active host.

      When you specify online, mount the shared disk and permit the logical host to access it.

    For details about the jcfdbsetup command, see jcfdbsetup in 1. Commands in the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.

  5. Execute the jcoimdef command to enable the IM Configuration Management database.

    jcoimdef -cf ON -h logical-host-name

    For details about the jcoimdef command, see jcoimdef in 1. Commands in the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.

(d) Setting up an OS environment

In the event of an error, if the Dr. Watson dialog box and Microsoft error reporting dialog box are displayed, failover of JP1/IM - Manager may fail. Therefore, display of these dialog boxes must be suppressed.

■ Setting Dr. Watson for Windows (for Windows Server 2003)

To set Dr. Watson for Windows:

  1. From the Start menu, choose Run.

  2. In the text box, enter drwtsn32 and then click the OK button.

    The Dr. Watson for Windows dialog box appears.

  3. Clear the Visual Notification check box.

  4. Click the OK button.

■ Suppressing Microsoft error reporting

In Windows Server 2003:

  1. In Control Panel, double-click System.

    The System Properties dialog box appears.

  2. On the Advanced page, click the Error Reporting button.

    The Error Reporting dialog box appears.

  3. Choose Disable error reporting and make sure that the But notify me when critical errors occur check box is not selected.

  4. Click the OK button.

Setup of the logical host at the primary server is now complete.

Make sure that the JP1/IM - Manager files for the logical host have been created on the shared disk and, if necessary, place the shared disk offline.

To Page Top

(4) Copying the common definition information

Copy the common definition information from the primary server to the secondary server.

The common definition information contains the settings needed to execute JP1/IM - Manager and JP1/Base on the logical host.

To copy the common definition information:

  1. Back up the common definition information at the primary server.

    At the primary node, execute the jbsgetcnf command to back up the common definition information.

    jbsgetcnf -h logical-host-name > common-definition-information-backup-file-name

    Note that the logical host name is case sensitive. Specify the logical host name set in JP1/Base in the correct form, including case.

  2. Copy the backup file from the primary server to the secondary server.

    Use a method such as FTP.

  3. Set the common definition information at the secondary server.

    Use the backup file copied from the primary server to set the common definition information at the secondary server.

    jbssetcnf common-definition-information-backup-file-name

To Page Top

(5) Setting up the logical host environment (secondary node)

(a) Preparations for setup

To prepare for setup:

  1. Make sure that the services of JP1/IM and JP1/Base are stopped.

    Make sure that all services of JP1/IM and JP1/Base are stopped on the physical host and all logical hosts. If JP1/IM - MO is used, also stop the JP1/IM - Message Optimizer service of JP1/IM - MO on the connection source.

  2. If you set up the IM database on the primary server, copy the cluster setup information file that was used in the primary server onto the secondary server. (This operation is not necessary if the IM database is not set up on the primary server.)

    Store the copied file in Manager-path\conf\imdb\setup.

Note that there is no need for the shared disk to be available for use at the secondary server.

(b) Setting up JP1/Base

To set up JP1/Base:

  1. Set up the logical host (secondary node) for JP1/Base.

    For details about the procedure, see the Job Management Partner 1/Base User's Guide.

  2. Set up a command execution environment for JP1/Base.

    Execute the jcocmddef command to set up a command execution environment for JP1/Base. For details about the jcocmddef command, see the Job Management Partner 1/Base User's Guide.

(c) Setting up JP1/IM - Manager

This subsection explains the following settings:

  • Setting JP1/IM - Manager (Central Console)

  • Setting JP1/IM - Manager (Central Scope)

  • Setting JP1/IM - Manager (IM Configuration Management)

  • Setting JP1/IM - Manager (IM database)

Note that the setup of JP1/IM - Manager (Central Scope), JP1/IM - Manager (IM Configuration Management), and JP1/IM - Manager (IM database) is optional. If you do not use these products, there is no need to set them up.

■ Setting JP1/IM - Manager (Central Console)

To set JP1/IM - Manager (Central Console):

  1. Open the setup window for the logical host of JP1/IM - Manager (Central Console).

    When you execute the Console-path\bin\jp1cohasetup.exe command, the following window appears.

    Figure 6‒9: Window for setting the logical host (secondary node)

    [Figure]

  2. Click the Logical Host Settings for Secondary Node System button.

    The following window appears.

    Figure 6‒10: Window for setting the logical host (secondary node)

    [Figure]

    Specify the logical host name.

    • Logical host name

      Select the logical host that was set up at the primary server.

    After you have specified the above information, click the Next button.

  3. Check the settings.

    The following window appears.

    Figure 6‒11: Window for setting the logical host (secondary node)

    [Figure]

    Check the settings. If the settings are correct, click the Finish button.

■ Setting JP1/IM - Manager (Central Scope)

This subsection describes the setting procedure for using JP1/IM - Manager (Central Scope). The windows displayed for this setting are the same as for JP1/IM - Manager (Central Console) except for the title bar that displays Central Scope.

To set JP1/IM - Manager (Central Scope):

  1. Open the window for setting the logical host for JP1/IM - Manager (Central Scope).

    Execute the Scope-path\bin\jp1cshasetup.exe command.

  2. Click the Logical Host Settings for Secondary Node System button.

    In the Logical Host Settings for Secondary Node System window, specify the logical host name.

    • Logical host name

      Select the logical host that was set up at the primary server.

    After you have specified the above information, click the Next button.

  3. Check the settings.

    When the confirmation window appears, check the settings. If the settings are correct, click the Finish button.

■ Setting JP1/IM - Manager (IM Configuration Management)

This subsection describes the setting procedure for using JP1/IM - Manager (IM Configuration Management). The windows displayed for this setting are the same as for JP1/IM - Manager (Central Console) except for the title bar that displays Configuration Management.

To set JP1/IM - Manager (IM Configuration Management):

  1. Open the window for setting the logical host for JP1/IM - Manager (IM Configuration Management).

    Execute the Manager-path\bin\imcf\jp1cfhasetup.exe command.

  2. Click the Logical Host Settings for Secondary Node System button.

    In the Logical Host Settings for Secondary Node System window, specify the logical host name.

    • Logical host name

      Select the logical host that was set up at the primary server.

    After you have specified the above information, click the Next button.

  3. Check the settings.

    When the confirmation window appears, check the settings. If the settings are correct, click the Finish button.

■ Setting JP1/IM - Manager (IM database)

This subsection describes the setting procedure for using JP1/IM - Manager (IM database). If you want to use the integrated monitoring database to manage JP1 events, or use the IM Configuration Management database to manage system hierarchies (IM configurations), you need to create an IM database.

To set JP1/IM - Manager (IM database):

  1. Edit the cluster setup information file.

    Prepare a cluster setup information file that contains information about the size of the database area required for creating the IM databases and the database storage directory. Check the contents of the cluster setup information file that was copied from the active host in 6.2.2(5)(a) Preparations for setup. The settings in the cluster setup information file must be the same as those specified at the primary node.

    For details about the settings in the cluster setup information file, see Cluster setup information file (jimdbclustersetupinfo.conf) in 2. Definition Files in the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.

  2. Execute the jcodbsetup command to create an integrated monitoring database.

    jcodbsetup -f cluster-setup-information-file-name -h logical-host-name -c standby [-q]

    Use arguments to specify the cluster setup information file name, logical host name, and setup type.

    • cluster-setup-information-file-name (-f option)

      Specify the name of the cluster setup information file that was created in step 1.

    • logical-host-name (-h option)

      Specify the logical host name that was set up at the primary server.

    • Setup type (-c option)

      Specify the setup type (standby) of the standby host.

    For details about the jcodbsetup command, see jcodbsetup in 1. Commands in the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.

  3. Execute the jcfdbsetup command to create an IM Configuration Management database.

    jcfdbsetup - f setup-information-file-name - h logical-host-name -c standby [-q]

    Use arguments to specify the cluster setup information file name, logical host name, and setup type.

    • cluster-setup-information-file-name (-f option)

      Specify the name of the cluster setup information file that was created in step 1.

    • logical-host-name (-h option)

      Specify the logical host name that was set up at the primary server.

    • Setup type (-c option)

      Specify the setup type (standby) of the standby host.

    For details about the jcfdbsetup command, see jcfdbsetup in 1. Commands in the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.

(d) Setting up an OS environment

If the Dr. Watson dialog box or the Microsoft error reporting dialog box is displayed when an error occurs, failover of JP1/IM - Manager may fail. Therefore, display of these dialog boxes must be suppressed.

■ Setting Dr. Watson for Windows (for Windows Server 2003)

To set Dr. Watson for Windows:

  1. From the Start menu, choose Run.

  2. In the text box, enter drwtsn32 and then click the OK button.

    The Dr. Watson for Windows dialog box appears.

  3. Clear the Visual Notification check box.

  4. Click the OK button.

■ Suppressing Microsoft error reporting (for Windows Server 2003)

  1. In Control Panel, double-click System.

    The System Properties dialog box appears.

  2. On the Advanced page, click the Error Reporting button.

    The Error Reporting dialog box appears.

  3. Choose Disable error reporting and make sure that the But notify me when critical errors occur check box is not selected.

  4. Click the OK button.

Setup of the secondary node is now complete.

To Page Top

Trademarks

All Rights Reserved. Copyright (C) 2012, 2014, Hitachi, Ltd.