jssitemstoredbsetup.bat (sets up an Item storage database)

Description

This command sets up the Item storage database. To execute this command, in the Start menu, click Programs, JP1_Service Support, and then JP1_SS Command Prompt.

To Page Top

Format

jssitemstoredbsetup.bat {-i name-of-the-configuration-file-for-expanding-an-Item-storage-database
                        [-c online] | -c standby} [-q]

To Page Top

Required execution permission

Administrator permissions

To Page Top

Storage folder

JP1/SS-path\tools\

To Page Top

Arguments

To Page Top

Return values

#

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:

1. Initialize the databases of JP1/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 12. Commands.

2. Recover the databases of JP1/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 12. Commands.

To Page Top

Prerequisites for executing the command

• For details about the status of services when commands are executed, see Status of services when commands are executed in Chapter 12. 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 13. 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.

To Page Top

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 11.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/Service Support logs and folders that are open to users in A.2 List of log files output by JP1/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/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

To Page Top

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

To Page Top