Job Management Partner 1/Base User's Guide
Function
The jp1base_setup_cluster command sets the operating environment of a JP1/Base logical host. If you set the operating environment of a JP1/Base in a cluster system, execute this command at the primary node and the secondary node.
- At the primary node:
- Specify the logical host name and the shared folder name. Specify the other options as required. Since this command attempts to create definition files and log files in the specified shared folder, you must mount a shared disk before executing this command.
- At the secondary node:
- Specify the logical host name only. The command sets the environment based on the information specified at the primary node. Note that you must copy the common definition information from the primary node to the secondary node before you set the operating environment of the secondary node. For details on copying the common definition information, see the descriptions for the jbsgetcnf and jbssetcnf commands.
Format
jbs_setup_cluster -h logical-host-name [[-d shared-folder[-a authentication-server]] [-v] | -r]
Required execution permission
Administrators. (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)
Command directory
- installation-folder\bin\
Arguments
-h logical-host-name
Specify the name of the logical host you want to set up or delete. You can enter a character string that is from 1 to 196 bytes to specify the logical host.
-d shared-folder
Specify this option only when setting the operating environment of the primary node. Specify the shared folder in which to save information to be carried over at failover. The shared directory to be specified must be in shared-folder. The environment settings for operating JP1/Base are saved in the specified shared folder. If you execute this command with this option specified, the command creates the folders shown in the following table and copies the definition files from installation-folder\jp1base\conf to the appropriate shared folder.
Folder Files to be contained shared-folder\jp1base\conf\ Definition files shared-folder\jp1base\log\ Log file shared-folder\event\ Event server settings file -a authentication-server
Specify the host name of the authentication server to which the logical host will connect. If you omit this option, the command assumes the same authentication server as that specified in the operating environment of the physical host.
-v
Specify this option to view all messages when you set the operating environment of the logical host.
-r
Specify this option to delete the logical host. You can execute this option on both the primary and secondary server. This procedure deletes the common definition information of the logical host for JP1/Base, JP1/IM, JP1/Power Monitor, and JP1/AJS, and deletes those services. However, shared files and shared directories remain on the shared disk. Delete these files and directories manually.
Notes
- Complete this setup on every node.
- At execution of this command, the TCP/IP communication protocol is changed from socket binding to IP addressing. This change affects settings for the logical hosts to be created and their constituent physical hosts. For details on the socket binding method used for TCP/IP communication, see the documentation for the OS you are using.
- In the jbs_setup_cluster command, you cannot specify the communication protocol of the event service. To specify a communication protocol, edit the event server settings file (conf).
- Do not execute this command when JP1/Base is active.
- At command execution, the logical host name and folder-on-shared-disk\event are automatically set to the event server index file (installation-folder\conf\event\index) for the event service on the local disk. A logical host name and communication type (keep-alive) is also automatically set to the API setting file (installation-folder\conf\event\api) for the event service on the local disk. The event server settings file (conf) and forwarding settings file (forward) are created under folder-on-shared-disk\event.
Return values
0 Normal end 1 Abnormal end
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.