jsshasetup.bat (sets up JP1/Service Support in a cluster environment)
- Organization of this page
Description
This command sets up JP1/Service Support so that it can be used in a cluster environment. To run this command, go to the Start menu and click Programs, JP1_Service Support, and JP1_SS Command Prompt. Then execute the command.
Format
jsshasetup.bat {{-c {online -s {S | M | L | LL | XL} [-t]} | standby} | -vup [-t] | -r} [-q]
Required execution permission
Administrator permissions
Storage folder
JP1/SS-path\tools\
Arguments
-c online -s {S | M | L | LL | XL}
Sets up JP1/Service Support on the primary server so that it can be used in a cluster environment. Specify the size of the Item management database with the -s option. Use half-width uppercase characters to specify S, M, L, LL, or XL.
The following table describes the size for each value.
Specified value |
Size of the database on the local disk |
Size of the database on the shared disk |
---|---|---|
S |
1.4 gigabytes |
5.2 gigabytes |
M |
1.4 gigabytes |
29.2 gigabytes |
L |
1.5 gigabytes |
71.1 gigabytes |
LL |
1.7 gigabytes |
150.9 gigabytes |
XL |
1.7 gigabytes |
161.5 gigabytes |
When you specify the -s option, all the setup processing is executed and the existing Item management database is initialized. If you have changed the folder containing the Item management database or the port number of the Item management database, the setup is performed with the latest information.
For details about how to change the folder for storing the Item management database or the port number of the Item management database, see 10.2.4 Editing jsshasetupinfo.bat.
For details about the criteria for determining the size of the Item management database, see 5.12.5 Criteria for determining the Item management database size.
-t
Registers emails as Items. When you specify the -t option, the master system and the temporary receipt process work board, which are required to register emails as Items, are created. If you do not specify the -t option, the master system and the temporary receipt process work board are not created.
Do not specify the -t option when the -c standby option is specified. In addition, specify the -t option only when you set up JP1/Service Support on the primary server. Do not specify the -t option when you set up JP1/Service Support on the secondary server. If you do, an error will occur.
If you want to create the master system and the temporary receipt process work board after you execute the jsshasetup.bat command, use the jsscreatesysandpwb command (creates the master system and the temporary receipt process work board). For details about the jsscreatesysandpwb command, see jsscreatesysandpwb (creates the master system and the temporary receipt process work board) in Chapter 12. Commands.
-c standby
Sets up JP1/Service Support on the secondary server so that it can be used in a cluster environment.
-vup
Sets up JP1/Service Support after overwrite installation to upgrade JP1/Service Support to the latest version. This option can also be used if you upgrade the product from JP1/Service Support Starter Edition to JP1/Service Support (Standard). Specify this option only if you upgrade the version of JP1/Service Support from an earlier version, or upgrade the product from JP1/Service Support Starter Edition to JP1/Service Support (Standard).
When you specify the -vup option, the database is not initialized and the environment settings of the WWW container server are not updated. Only the features extended by version upgrade or product upgrade are updated. The folder containing the Item management database and the port number of the database remain as they were for the previous setup.
Additionally, if the version of JP1/Service Support is 10-50 or earlier and email-based Item registration is used, executing the jsshasetup.bat command with the -vup option specified executes the jssauthusersetup command automatically. Therefore, the password (hptl_jp1_imss_mail_pop3_password) of the email server to which email for Item registration is to be sent that has been set in the email definition file is reconfigured.
-r
Sets up JP1/Service Support after overwrite installation of the same version of JP1/Service Support. Do not specify the -r option when you set up JP1/Service Support for the first time.
When you specify the -r option, the database is not initialized and the environment settings of the WWW container server are not updated. The folder containing the Item management database and the port number of the database remain as they were for the previous setup.
-q
Initializes the database without displaying a confirmation message.
If you do not specify the -q option, the system displays a message to ask whether to permit initialization of the database.
Return values
Return value |
Meaning |
---|---|
0 |
Normal end |
1 |
Abnormal end |
Prerequisites for executing the command
-
Make sure that you execute the jsshasetup.bat command when you create a cluster environment for the first time or overwrite an existing cluster environment.
-
Make sure that you execute the jsshasetup.bat command on the primary server.
-
For details about which services need to be active or inactive when this command is executed, see Status of services when commands are executed in Chapter 12. Commands.
-
Before you perform version upgrade or product upgrade by executing the jsshasetup.bat command with the -vup option specified, the JP1/Service Support - DB Server service must be running.
-
Before you execute the jsshasetup.bat command, use cluster software to take the JP1/Service Support - Web Service service, the JP1/Service Support service, the JP1/Service Support - DB Server service, and the JP1/Service Support - DB Cluster Service service offline.
-
While the jsshasetup.bat command is being executed, do not execute other JP1/Service Support commands.
-
When you execute the jsshasetup.bat command with online set for the -c option on the primary server, make sure that you execute the jsshasetup.bat command with standby set for the -c option on the secondary server.
-
If you execute the jsshasetup.bat command to upgrade the version of JP1/Service Support, or to upgrade the product to JP1/Service Support (Standard), the available space is required on the drive on which the Item management database is stored. Required available space depends on the version of JP1/Service Support and the size of the Item management database.
For details, see 10.8.1 Procedure for version upgrade of JP1/Service Support in a cluster environment.
-
When the jsshasetup.bat command is executed, a temporary file is created. Therefore, about 400 MB of available space is required for the installation folder for JP1/Service Support, excluding the available space required for version upgrade or product upgrade.
Remarks
-
When you execute the jsshasetup.bat command, multiple child processes start within the system. Even if you cancel the jsshasetup.bat command by using Ctrl+C, the child processes continue running. For this reason, do not cancel the jsshasetup.bat command during execution by using Ctrl+C. If you happen to do so, wait for a while and re-execute the command.
-
After you perform version upgrade or product upgrade of JP1/Service Support by executing the jsshasetup.bat command with the -vup option on the secondary server, do not re-execute a command with the -vup option on the same server.
-
If the jsshasetup.bat command ends abnormally, the JP1/Service Support service might be active. Before you re-execute the jsshasetup.bat command, make sure that you inactive the JP1/Service Support service.
-
After you execute the jsshasetup.bat command, inactivate the JP1/Service Support - DB Server service. You need to do this because the Service Control Manager on the host where you execute the command starts the JP1/Service Support - DB Server service of the Item management database server.
-
When you execute the jsshasetup.bat command, a KNAB22018-W warning message or a KNAB26148-W warning message might appear. If either of these messages appears, JP1/Service Support is already set up. Take the action described in the explanation of the KNAB22018-W or KNAB26148-W message.
Example
The following example shows how to set up JP1/Service Support on the primary server to be used in a new cluster environment. The size of the Item management database is M.
jsshasetup.bat -c online -s M