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.
|
- Organization of this subsection
(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 8.1 User management setup (in Windows).
-
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 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 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) 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.
-
Set up user management for the logical host (only when using the logical host as the authentication server).
For details on setting user management function, see 8.1 User management setup (in Windows).
- Set up by using the GUI
-
1. From the Windows Start menu, choose Programs, JP1_Base, and then JP1_Base Setup.
2. In the Select Logical Host dialog box, select the logical host for which you want to set up user management.
3. Register the JP1 user.
4. Set JP1 user operating permissions.
- Set up by using commands
-
1. Register the JP1 user.
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. Set JP1 user operating permissions.
The user permission level file (JP1_UserLevel) resides in the following location:
shared-folder\conf\user_acl\JP1_UserLevel
After editing this file (JP1_UserLevel), execute the jbsaclreload command to apply the settings.
-
Register the user mapping information in the common definition information.
For details about the user mapping information settings, see 8.1 User management setup (in Windows).
- Set up by using the GUI
-
1. From the Windows Start menu, choose Programs, JP1_Base, and then JP1_Base Setup.
2. In the Select Logical Host dialog box, select the logical host for which you want to set up user management function.
3. Select the User Mapping tab of the JP1/Base Environment Settings dialog box.
4. Set the user mapping information.
- Set up by using commands
-
The user mapping definition file (jp1BsUmap.conf) resides in the following location:
shared-folder\jp1base\conf\user_acl\jp1BsUmap.conf
After editing this file (jp1BsUmap.conf), execute the following command to register the user mapping information.
jbsmkumap -h logical-host-name
If you want to check the registered user mapping information, execute the following command:
jbsgetumap -h logical-host-name
-
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
-
Settings to configure both physical and logical host environments on the same host.
To configure both physical and logical host environments on the same host ,you need to set up the network control. For details, see 5.4.5 Settings to configure both physical and logical host environments on the same host.
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 JP1/Integrated Management 3 - Manager Configuration Guide, JP1/Integrated Management 3 - Manager Administration Guide, JP1/Automatic Job Management System 3 System Design (Configuration) Guide, JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide, and the JP1/Automatic Job Management System 3 Administration Guide.
(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.
-
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).
-
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.
-
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.
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 3. Click the Next button.
Figure 5‒12: Logical Host Settings for Secondary Node System dialog box (confirmation window) 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.
-
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.
-
Settings to configure both physical and logical host environments on the same host.
To configure both physical and logical host environments on the same host ,you need to set up the network control. For details, see 5.4.5 Settings to configure both physical and logical host environments on the same host.
This completes JP1/Base setup on the secondary node.