jp1cs_setup_cluster (UNIX only)
- Organization of this page
Function
This command sets up an operating environment for a logical host of JP1/IM - Manager (JP1/IM - Central Scope). Use this command for environment setup in a cluster system.
Set up the environment for the primary node first, and then set up the standby node.
In the environment setup for the primary node, you must specify the logical host name and shared directory name. When you execute the command, information such as definition files is copied to the specified shared directory; therefore, you must have already made the shared disk available for use.
In the environment setup for the standby node, specify only the logical host name. The operating environment is set up based on the information specified for the executing node.
Before you start setting up an environment for the secondary node, you must use the jbsgetcnf and jbssetcnf commands of JP1/Base to copy to the standby node the common definition information set at the executing node.
Before you use this command, terminate JP1/IM - Manager.
When you execute this command, the socket binding method used for TCP/IP communication is changed to the IP binding method. The command changes this setting for the physical host and for the logical host that is to be created. For details about the socket binding method used for TCP/IP communication, see the documentation for the applicable OS.
Format
jp1cs_setup_cluster -h logical-host-name [-d shared-directory-name]
Execution permission
Superuser permissions
Storage directory
/opt/jp1scope/bin/
Arguments
- -h logical-host-name
-
Specifies a host name for the logical host whose environment is to be set up. The permitted length is from 1 to 63 bytes characters.
Set the specified logical host name in the hosts file and in the name server to enable TCP/IP communication. For DNS operation, do not specify the host name in FQDN format (for example, for jp1v6.soft.hitachi.co.jp, specify jp1v6).
- -d shared-directory-name
-
Specifies a shared directory for storing the information that is to be inherited during node switching. Specify a directory on the shared disk. The permitted length is from 1 to 165 bytes characters.
The command creates the directories listed below in the specified shared directory and then copies definition files from /etc/opt/jp1scope/conf/.
Table 1‒52: Directories created by the jp1cs_setup_cluster command Type of files to be stored
Directory
Definition files
shared-directory-name/jp1scope/conf/
Log files
shared-directory-name/jp1scope/log/
Temporary files
shared-directory-name/jp1scope/tmp/
Database information
shared-directory-name/jp1scope/database/
Change the definition files, if necessary.
Notes
-
You must set a logical host for each node.
-
You must make the shared disk available for use before you set up an environment for the primary node by executing the jp1cs_setup_cluster command.
Return values
0 |
Normal termination |
1 |
Abnormal termination |
Examples
Set up an environment with the following conditions:
Logical host name: lnode0 Shared disk: shdsk/lnode0
-
Setting up the logical host environment at the primary server
jp1cs_setup_cluster -h lnode0 -d /shdsk/lnode0
-
Setting up the logical host environment at the secondary server
jp1cs_setup_cluster -h lnode0