jsshasetup.bat (sets up JP1/IM - Service Support in a cluster environment)
- Organization of this page
Description
This command sets up JP1/IM - 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_Integrated Management - Service Support, and JP1_IM-SS Command Prompt. Then execute the command. The arguments you can specify depend on the JP1/IM - Service Support product being used.
Format
- For JP1/IM - Service Support (Standard):
jsshasetup.bat {{-c {online -s {S | M | L | LL} [-t]} | standby} | -vup [-t]| -r} [-q]- For JP1/IM - Service Support Advanced Edition:
jsshasetup.bat {{-c {online -s {S | M | L | LL | XL} [-t]} | standby} | -vup [-t] | -r} [-q]
Required execution permission
Administrator permissions
Storage folder
IM-SS-path\tools\
Arguments
-c online -s {S | M | L | LL | XL}
Sets up JP1/IM - 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 |
- #
-
This value can be specified only when JP1/IM - Service Support Advanced Edition is used.
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 9.2.4 Editing jsshasetupinfo.bat.
For details about the criteria for determining the size of the Item management database, see the Release Notes.
-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/IM - Service Support on the primary server. Do not specify the -t option when you set up JP1/IM - 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 11. Commands.
-c standby
Sets up JP1/IM - Service Support on the secondary server so that it can be used in a cluster environment.
-vup
Upgrades the version of JP1/IM - Service Support (Standard) from version 10-10 to 10-50. This option is specified during setup after overwrite installation is performed. This option can also be used if you upgrade the product from JP1/IM - Service Support (Standard) whose version is earlier than 10-10 to JP1/IM - Service Support Advanced Edition. Specify this option only if you upgrade the version of JP1/IM - Service Support from an earlier version, or upgrade the product from JP1/IM - Service Support (Standard) to JP1/IM - Service Support Advanced Edition.
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.
-r
Sets up JP1/IM - Service Support after overwrite installation of the same version of JP1/IM - Service Support. Do not specify the -r option when you set up JP1/IM - 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 11. 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/IM - 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/IM - Service Support (Standard) from 10-10 to 10-50, or to upgrade the product from JP1/IM - Service Support to JP1/IM - Service Support Advanced Editon10-50, the following available space is required on the drive on which the Item management database is stored, depending on the size of the Item management database:
-
For the S-size Item management database: 0.2 GB
-
For the M-size Item management database: 0.9 GB
-
For the L-size Item management database: 1.4 GB
-
For the LL-size Item management database: 2.9 GB
-
In JP1/IM - Service Support (Standard) 10-10, there is no XL-size setting for the Item management database.
-
-
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/IM - 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/IM - 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/IM - Service Support is already set up. Take the action described in the explanation of the KNAB22018-W or KNAB26148-W message.
-
When JP1/IM - Service Support Advanced Edition is not used, executing the jsshasetup.bat command with XL specified for the -s option causes an error.
Example
The following example shows how to set up JP1/IM - 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