ajscsasetup (Windows, Linux)

Organization of this page

Format

ajscsasetup
     -c|-p|-d  Shared-directory-name  -h  Logical-host-name-of-JP1/Base  [-m|-s]

To Page Top

Description

Setup the JP1/AJS3 for Cloud Service Applications server.

To Page Top

Execution privileges

In Windows: Administrators privileges

In Linux: Superuser privileges

To Page Top

Storage directory

In Windows:: JP1/AJS3 for Cloud Service Applications-installation-folder\bin\
In Linux:: /opt/jp1ajs3csa/bin/

To Page Top

Arguments

`-c`

This option displays the setup details of the JP1/AJS3 for Cloud Service Applications server. The following shows the display items and their descriptions.

No.	Display item	Description
1	Logical host name of JP1/Base	When a logical host is set up, this item shows the logical host name.
2	Shared directory name	When a shared directory is used, this item shows the path to the shared directory.

`-p`

This option returns the configuration of the JP1/AJS3 for Cloud Service Applications server from the cluster configuration to the default one.

The settings of each configuration file are returned to the defaults, including path and log output destination.

`-d` `Shared-directory-name`

When setting up the JP1/AJS3 for Cloud Service Applications server with a cluster configuration, specify the full path to the shared directory.

The number of characters that can be specified is 2 to 100 (unit: byte).

For Windows, if the first two bytes are specified with characters other than the drive letter (e.g., C:), the command terminates abnormally.

Do not specify a disk on the network drive. Also, do not specify a path including multibyte characters.

Do not specify the drive and the root directory.

As the shared directory, specified-shared-directory-name\jp1ajs3csa is created for Windows, and specified-shared-directory-name/jp1ajs3csa for Linux. Under this directory, an environment definition file is created, where the database file is copied. This environment definition file is necessary for operating the JP1/AJS3 for Cloud Service Applications server with a cluster configuration. Note that if these directories already exist with the -m option specified, the command terminates abnormally. When the -m option is specified, make sure that these directories do not exist before executing a command.

`-h` `Logical-host-name-of-JP1/Base`

Specify the logical host name where the JP1 user authentication information is set, which is used for cluster configuration.

The number of characters that can be specified is 1 to 255 (unit: byte).

`-m`

Specify this option when setting up the JP1/AJS3 for Cloud Service Applications server as the primary node of the cluster configuration.

Specify this option together with the -d option. If the directory specified for the -d option does not exist, the command terminates abnormally.

When setting up the primary node, make sure that the shared disk is mounted.

`-s`

Specify this option when setting up the JP1/AJS3 for Cloud Service Applications server as the secondary node of the cluster configuration.

Specify this option together with the -d option.

When setting up the secondary node, specify the -d option with the path to the shared directory that has been specified for setting up the primary node.

To Page Top

Notes

The information set by the ajscsasetup command is reflected the next time the JP1/AJS3 CSA HTTP Server service or the JP1/AJS3 CSA Web Application Server service is started. Therefore, if the setting is changed by the ajscsasetup command when the service is in operation, the setting information displayed using -c differs from the current operation status.
When a command is executed with -c specified, even if the ajscsasetup.conf and ajs3csaweb.conf files are invalid, the processing is continued.
Logs output by this command are always output to a physical host in a cluster configuration environment. In the case of ajs3csaweb.conf, this command also always refers to ajs3csaweb.conf on the physical host.
When the ajscsasetup command is executed, settings of the user property file for J2EE server (usrconf.properties)^# might return to the initial state, and startup of JP1/AJS3 CSA Web Application Server services might fail. After the execution of the ajscsasetup command, set again the user property file for J2EE server (usrconf.properties).

This problem occurs when both of the following conditions are met:
1. The settings of the user property file for J2EE server (usrconf.properties) are changed before the execution of the ajscsasetup command.
2. The -d or -p option is specified for the argument of the ajscsasetup command.
#:

For details about setup items of the user property file for J2EE server (usrconf.properties) to be used for setting the JP1/AJS3 for CSA Web Application Server, see 3.4.3 User property file for J2EE server (usrconf.properties).

To Page Top

Return values

0	Normal end
Value other than 0	Abnormal end

To Page Top

Example 1

Display the setup details of the JP1/AJS3 for Cloud Service Applications server.

ajscsasetup -c

Output example

KNBB2520-I Output of settings data will now start.
Logical host name         logicalhost
Shared directory     E:\share
KNBB2521-I Output of settings data ended.

To Page Top

Example 2

This option returns the configuration of JP1/AJS3 for Cloud Service Applications server from the cluster configuration to the default.

ajscsasetup -p

To Page Top

Example 3

Set up the JP1/AJS3 for Cloud Service Applications server as the primary node when the shared directory is E:\SHARE and the logical host of JP1/Base is logicalhost.

ajscsasetup -d E:\SHARE -h logicalhost

ajscsasetup -d E:\SHARE -h logicalhost -m

To Page Top

Example 4

Set up the JP1/AJS3 for Cloud Service Applications server as the secondary node when the shared directory is E:\SHARE and the logical host of JP1/Base is logicalhost.

ajscsasetup -d E:\SHARE -h logicalhost -s

To Page Top