8.5.5 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

• 8.3 Valid characters for arguments in a command