8.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 /jp1user JP1-user-name
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.
- /jp1user JP1-user-name
-
This option specifies the JP1 user name.
Located in
JP1/AO-installation-folder\bin
Execute permission
Execute the command as a user with Administrator permissions. If a user without Administrator 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. |
121 |
The specified JP1 user does not have permission to set up the task-processing engine. |
255 |
The command execution has been interrupted due to an error other than the above. |
Example
The following command shows an example of how to configure a cluster environment. 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 /jp1user JP1_AO_Admin
Related topic