jp1base_setup_cluster (UNIX only)
- Organization of this page
Function
The jp1base_setup_cluster command sets the operating environment of a JP1/Base logical host. Execute this command if you want to use JP1/Base in a cluster system. First set the environment for the primary node, and then set the environment for the secondary node.
Format
jp1base_setup_cluster -h logical-host-name [-d shared-directory [-a authentication-server] [-s] [-v]]
Required execution permission
Superuser or JP1/Base administrator permission
- At the primary node:
-
Specify the logical host name and the shared directory name. Specify the other options as required. Since this command attempts to create files in the specified shared directory, 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. Use the jbsgetcnf and jbssetcnf commands to copy the information.
Command directory
/opt/jp1base/bin/
Arguments
-h logical-host-name
Specify the name of the logical host you want to set up.
- Notes
-
-
Register the logical host name in the hosts file and in the name server to enable TCP/IP communication.
-
If you do not want to operate JP1/Base by DNS, do not specify the host name in the FQDN (Fully Qualified Domain Name) format. For example, if the FQDN is jp1v6.soft.hitachi.co.jp, specify jp1v6.
-
-d shared-directory
Specify this option only when setting the operating environment of the primary node. Specify the shared directory in which to save information to be carried over at failover. The shared directory to be specified must be in shared-directory. The environment settings for operating JP1/Base are saved in the specified shared directory. If you execute this command with this option specified, the command creates the directories shown in the following table and copies the definition files from /etc/opt/jp1base/conf/ to the appropriate shared directory.
Directory |
Files to be contained |
---|---|
shared-directory/jp1base/conf/ |
Definition files |
shared-directory/jp1base/log/ |
Log file |
shared-directory/event/ |
Event server settings file |
Modify the definition files as required.
-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.
-s
Specify this option if you want to run an authentication server on the logical host. If you specify this option, the authentication server is activated when JP1/Base starts. If you omit this option, no authentication server will be activated when JP1/Base starts.
-v
Specify this option to view all messages when you set the operating environment of the logical host.
Notes
-
Complete this setup on every node.
-
At execution of this command, the logical-host-name and directory-name-on shared-disk/event/ are automatically set in the event server index file (/etc/opt/jp1base/conf/event/index) of the event service on the local disk. The event server settings file (conf) and forwarding settings file (forward) are created in the directory-name-on shared-disk/event/ directory.
-
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.
-
Do not execute this command when JP1/Base is active.
Example
The following shows an example of this command when the logical host name is lnode0 and the shared directory is /shdsk/lnode0.
- At the primary node:
jp1base_setup_cluster -h lnode0 -d /shdsk/lnode0 -a lnode0 -s
The above command sets the operating environment of the logical host, creates shared directories and files on a shared disk, and sets up an authentication server.
- At the secondary node:
jp1base_setup_cluster -h lnode0