jssitemstoredbsetup.bat (sets up an Item storage database)
- Organization of this page
Description
This command sets up the Item storage database. To execute this command, in the Start menu, click Programs, JP1_Integrated Management - Service Support, and then JP1_IM-SS Command Prompt. This command can be executed when JP1/IM - Service Support Advanced Edition is used.
Format
jssitemstoredbsetup.bat {-i name-of-the-configuration-file-for-expanding-an-Item-storage-database [-c online] | -c standby} [-q]
Required execution permission
Administrator permissions
Storage folder
IM-SS-path\tools\
Arguments
-i name-of-the-configuration-file-for-expanding-an-Item-storage-database
Use an absolute path with a character string consisting of 255 bytes or less to specify the name of the configuration file for setting up an Item storage database. Count half-width characters as 1-byte each and full-width characters as 2-bytes each. You cannot specify a UNC path. For details about the configuration file for setting up an Item storage database, see Configuration file for setting up an Item storage database (jssitemstoredbinfo.bat) in Chapter 12. Definition Files.
-c online | -c standby
Specify the server on which the Item storage database is to be set up (online for the primary server, and standby for the secondary server).
-q
Continues setting up the Item storage database without displaying a confirmation message. If you do not specify the -q option, the system displays a message to ask whether to continue setting up the Item storage database.
Return values
Return value |
Meaning |
---|---|
0 |
Normal end |
1 |
Abnormal end (unsetup not required for retry) |
2# |
Abnormal end (unsetup required for retry) |
- #
-
If the return value is 2, correct the cause of the error, recover the environment according to the following procedure, and then re-execute the command:
-
Initialize the databases of JP1/IM - Service Support.
Execute the jssdbinit.bat (initializes databases) command to initialize the Item management database and the Item storage database. For details about the jssdbinit.bat (initializes databases) command, see jssdbinit.bat (initializes databases) in Chapter 11. Commands.
-
Recover the databases of JP1/IM - Service Support.
Execute the jssdbrecovery.bat (recovers a database) command to recover the Item management database and Item storage database from the backup file that was made before executing the jssitemstoredbsetup.bat command. For details about the jssdbrecovery.bat (recovers a database) command, see jssdbrecovery.bat (recovers a database) in Chapter 11. Commands.
-
Prerequisites for executing the command
-
The jssitemstoredbsetup.bat command can be executed when JP1/IM - Service Support Advanced Edition is used.
-
For details about the status of services when commands are executed, see Status of services when commands are executed in Chapter 11. Commands.
-
Each time a storage area in the Item storage database is set up, required memory size becomes larger. For details about required memory space, see the release notes.
-
Setting up a storage area in the Item storage database by executing the jssitemstoredbsetup.bat command requires 128 GB of available space for the folder that stores the Item storage database specified in the configuration file for setting up an Item storage database. For details about the configuration file for setting up an Item storage database, see Configuration file for setting up an Item storage database (jssitemstoredbinfo.bat) in Chapter 12. Definition Files.
-
Execute the command for a storage area that has not been set up.
-
Before storage area B is set up, setup for storage area A must be finished.
-
The Item management database must be set up in XL size.
-
For details about commands that cannot be executed at the same time as the jssitemstoredbsetup.bat command, see Commands that cannot be executed at the same time.
Remarks
-
Use the jssunsetup.bat command to perform unsetup of the Item storage database. In case you should set up the Item storage database by mistake, back up the data in the Item management database before executing the jssitemstoredbsetup.bat command. For details about how to back up the data in the Item management database, see 10.2.1 Backing up and recovering the Item management database.
-
Do not cancel the jssitemstoredbsetup.bat command during execution by using Ctrl+C. If you happen to do so, recover the environment in the same way as when the return value is 2.
-
The execution result of the jssitemstoredbsetup.bat command is output to the log file open to users. For details, see the description about the JP1/IM - Service Support logs and folders that are open to users in A.2 List of log files output by JP1/IM - Service Support.
-
Make sure that the input file you specify is created with a character encoding that is compatible with the system locale of the machine on which JP1/IM - Service Support is installed. The character encodings that can be used are as follows:
-
In a Japanese environment: UTF-8
-
In an English environment: UTF-8
-
In a Chinese environment: UTF-8
-
Examples
- Example 1
-
When you use the configuration file for setting up an Item storage database (c:\setup\jssitemstoredbinfo.bat) to set up the Item storage database:
jssitemstoredbsetup.bat -i c:\setup\jssitemstoredbinfo.bat
- Example 2
-
When you use the configuration file for setting up an Item storage database (c:\setup\jssitemstoredbinfo.bat) to set up the Item storage database on the primary server in a cluster environment:
jssitemstoredbsetup.bat -i c:\setup\jssitemstoredbinfo.bat -c online
- Example 3
-
When you set up the Item storage database on the secondary server in a cluster environment:
jssitemstoredbsetup.bat -c standby