1.5.7 setupcluster (configuring a cluster environment)
Description
This command configures a JP1/AO cluster environment. You need to execute the command on both executing and standby hosts.
You can execute the command with the path on the shared disk to which the databases and data are backed up to configure the cluster environment.
After the command is executed, a message appears indicating ongoing processes.
Syntax
setupcluster
/exportpath path-to-which-the-databases-and-data-are-backed-up
Arguments
- /exportpath path-to-which-the-databases-and-data-are-backed-up
This option specifies the absolute or relative path to the folder to which the databases and data on which this command is executed are backed up. You must specify the folder on the shared disk that has sufficient free space. The maximum length of the path name is 49 characters.
Located in
- In Windows:
JP1/AO-installation-folder\bin
- In Linux:
/opt/jp1ao/bin
Execute permission
Execute the command as a user with Administrator or root permissions. If a user without Administrator or root permissions executes the command, a message appears asking the user to elevate the permission level.
Return code
The following table lists the return codes from the command.
Return code |
Description |
|---|---|
0 |
The command succeeded. |
1 |
The argument is invalid. |
2 |
The command execution has been interrupted. |
3 |
The service status is invalid. |
4 |
One of the other commands is running. |
5 |
Communication failed. |
7 |
An invalid path is specified. |
9 |
The specified path does not exist. |
10 |
The specified path is not accessible. |
11 |
The specified folder is not empty. |
14 |
You do not have permission to execute the command. |
120 |
Setting up the cluster failed. |
|
255 |
The command execution has been interrupted due to an error other than the above. |
Example
The following example shows how to use the command to configure a cluster environment in Windows. In this example, the databases are re-created and the data is backed up in the path on the shared folder specified on the executing host. (In the case of the standby host, the same command is used.)
setupcluster /exportpath Z:\share