Job Management Partner 1/Base User's Guide
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 3-6 Setup procedure for a cluster system (In Windows)
- Organization of this subsection
- (1) Setup on the primary node
- (2) Setup on the secondary node
- (3) Disabling Dr. Watson error notification (primary and secondary nodes)
- (4) Disabling Microsoft error reporting (primary and secondary nodes)
(1) Setup on the primary node
To set up the physical and logical hosts on the primary node:
- 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 6.1 User management setup (in Windows).
- Modify the event server settings (conf) for the physical host.
Modify the settings for the event service communication protocol (ports parameter) and retry limit for forwarding JP1 events (forward-limit parameter).
For the ports parameter, specify the IP address used for the physical host or the name of the physical host.
The event service stops during failovers. Use the forward-limit parameter to specify the maximum period to retry forwarding the JP1 events that could not be sent during a failover. By default, the system continues to retry for 3,600 seconds.
The event server settings file (conf) resides in the following location:
The following shows an example of the parameter settings:
installation-folder\conf\event\servers\default\
For details on the event server settings file, see Event server settings file in 14. Definition Files.
ports IP-address-of-physical-host jp1imevt jp1imevtapi forward-limit 3600
- Set the logical host.
- Setting up through GUI
- 1. Execute installation-folder\bin\jp1bshasetup.exe.
- The Settings for Base Cluster System dialog box appears.
Figure 3-7 Settings for Base Cluster System dialog box
- 2. Click the Logical Host Settings for Primary Node System button.
- The Logical Host Settings for Primary Node System dialog box appears.
Figure 3-8 Logical Host Settings for Primary Node System dialog box
- In this dialog box, specify the name of the logical host for which information will be created and a folder on a shared disk for creating 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.
- The following dialog box appears.
Figure 3-9 Logical Host Settings for Primary Node System dialog box (confirmation window)
- You can use this dialog box to check the settings. If the settings are correct, click the Finish button.
- This completes all the settings except the communication protocol for the event service.
- 4. Set up the authentication server on the logical host.
- The authentication servers that have been set on the physical host are set for the logical host. Use the GUI to set an authentication server that has a different physical host. For details, see 6.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 13. Commands.
- 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 Environment Settings.
- 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 in the common definition information (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. Match the common definition information on the physical hosts.
- When you finish these operations, match the information on all the physical hosts, as described in 3.4.5 Modifying common definition information.
- 4. 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 6.1 User management setup (in Windows).
- 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
- Modify the event server settings (conf) for the logical host.
Modify the settings for the event service communication protocol (ports parameter) and retry limit for forwarding JP1 events (forward-limit parameter).
For the ports parameter, specify the IP address used for the logical host or the name of the logical host.
The event service stops during failovers. Use the forward-limit parameter to specify the maximum period to retry forwarding the JP1 events that could not be sent during a failover. By default, the system continues to retry for 3,600 seconds.
The event server settings file (conf) resides in the following location:
The following shows an example of the parameter settings:
shared-folder\jp1base\event\
For details on the event server settings file, see Event server settings file in 14. Definition Files.
ports IP-address-of-logical-host jp1imevt jp1imevtapi forward-limit 3600
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
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.
To set up the physical and logical hosts on the secondary node:
- 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 6.1 User management setup (in Windows).
- Modify the event server settings (conf) for the physical host.
Modify the settings for the event service communication protocol (ports parameter) and retry limit for forwarding JP1 events (forward-limit parameter).
For the ports parameter, specify the IP address used for the physical host or the name of the physical host.
The event service stops during failovers. Use the forward-limit parameter to specify the maximum period to retry forwarding the JP1 events that could not be sent during a failover. By default, the system continues to retry for 3,600 seconds.
The event server settings file (conf) resides in the following location:
The following shows an example of the parameter settings:
installation-folder\conf\event\servers\default\
For details on the event server settings file, see Event server settings file in 14. Definition Files.
ports IP-address-of-physical-host jp1imevt jp1imevtapi forward-limit 3600
- 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- Copy the backup file to the secondary node.
- 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- Set the logical host.
- Setting up through GUI
- 1. Execute installation-folder\bin\jp1bshasetup.exe.
- The Settings for Base Cluster System dialog box appears.
- 2. Click the Logical Host Settings for Secondary Node System button.
- The Logical Host Settings for Secondary Node System dialog box appears. In this dialog box, select the logical host name that you specified on the primary node.
Figure 3-10 Logical Host Settings for Secondary Node System dialog box
- 3. Click the Next button.
- The settings for the selected logical host are displayed.
Figure 3-11 Logical Host Settings for Secondary Node System dialog box (confirmation window)
- You can use this dialog box to check the settings. 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 13. Commands.
This completes JP1/Base setup on the secondary node.
(3) Disabling Dr. Watson error notification (primary and secondary nodes)
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:
- From the command prompt, enter drwtsn32 -i to enable settings for Dr. Watson.
This command installs Dr. Watson as the default application debugger.
- From the Start menu, choose Run.
- Type drwtsn32 in the text box and click the OK button.
The Dr. Watson dialog box appears.
- Clear the Visual Notification check box.
- Click the OK button.
(4) Disabling Microsoft error reporting (primary and secondary nodes)
In Windows Server 2003, 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 the Control Panel, double-click System.
The System Properties dialog box appears.
- Select the Advanced tab, and then click the Error Reporting button.
The Error Reporting dialog box appears.
- Select the Disable error reporting radio button and clear the But notify me when critical errors occur check box.
- Click the OK button.
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.