ajscsasetup (Windows, Linux)
- Organization of this page
Format
ajscsasetup -c|-p|-d Shared-directory-name -h Logical-host-name-of-JP1/Base [-m|-s]
Description
Setup the JP1/AJS3 for Cloud Service Applications server.
Execution privileges
In Windows: Administrators privileges
In Linux: Superuser privileges
Storage directory
- In Windows:
-
JP1/AJS3 for Cloud Service Applications-installation-folder\bin\
- In Linux:
-
/opt/jp1ajs3csa/bin/
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.
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:
-
The settings of the user property file for J2EE server (usrconf.properties) are changed before the execution of the ajscsasetup command.
-
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).
-
Return values
0 |
Normal end |
Value other than 0 |
Abnormal end |
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.
Example 2
This option returns the configuration of JP1/AJS3 for Cloud Service Applications server from the cluster configuration to the default.
ajscsasetup -p
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
or
ajscsasetup -d E:\SHARE -h logicalhost -m
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