6.3.2 Setup procedure for new installation

Use this procedure to set up JP1/IM - Service Support that was newly installed. This procedure is the same for all JP1/IM - Service Support products.

Edit the jsssetupinfo.bat command file.

If you change the storage destination of the Item management database or the port number used in JP1/IM - Service Support, edit the jsssetupinfo.bat command file. The jsssetupinfo.bat command file is stored in the following location:

IM-SS-path\conf\setup\jsssetupinfo.bat

The following shows the format of the jsssetupinfo.bat command file.

[Figure]

In the jsssetupinfo.bat command file, you can edit the default values in the table below. If you change any settings other than the ones in the Setting column, an error occurs.

Table 6‒1: Settings that can be edited in the jsssetupinfo.bat command file
Setting	Description	Default value
`IMSSDBDIR`	Name of the storage-destination folder for the Item management database^#1	`IM-SS-path\db`
`IMSSDBPORT`	Number of the port used for communication with the Item management database server^#2	24400
`IMSSHTTPPORT`	Number of the port used for communication with the Web server and web browser^#2	24401
`IMSSWEBCONPORT`	Number of the port used for linkage between the WWW container server and Web server^#2	24402
`IMSSWEBSHUPORT`	Number of the port used for shutting down the communication with the WWW container server^#2	24403
`IMSSWEBHTTPPORT`	Number of the port used for communication with the Web server for system configuration^#2	24404

#1

When you specify the name of the storage-destination folder for the Item management database, note the following:

- Specify the absolute path in no more than 133 bytes.

- Specify the characters that can be used in the OS.

- Half-width alphanumeric characters, underscores (_), yen signs (\), parentheses (()), periods (.), and half-width space characters can be used.

- Do not use the yen sign (\) for the end of the folder name.

- Do not use a half-width space or tab for the beginning or the end of the folder name.

- You cannot specify a network drive.

- If you specify the name of a folder that does not exist, the folder is created when the jsssetup.bat command is executed.

- Do not specify the root folder of a hard drive, such as D:\.

#2

For IMSSDBPORT, you can specify half-width numerals in the range from 5001 to 65535. For IMSSHTTPPORT, IMSSWEBCONPORT, IMSSWEBSHUPORT, and IMSSWEBHTTPPORT, you can specify half-width numerals in the range from 1 to 65535. However, note the following:

- Each port number must be unique.

- Do not use port numbers that are used by other products.

- Do not use half-width space characters or tabs before and after port numbers.

Reference note: A model file (IM-SS-path\conf\setup\jsssetupinfo.bat.model) is provided for the jsssetupinfo.bat command file. Use the model file to reset the contents of the jsssetupinfo.bat command file. You can delete the jsssetupinfo.bat command file, and then copy the model file and rename it to jsssetupinfo.bat.

Execute the jsssetup.bat command.

From the Start menu, select Programs, JP1_Integrated Management - Service Support, and then JP1_IM-SS Command Prompt, and execute the jsssetup.bat command with the -s option specified as an argument to set up JP1/IM - Service Support.

Specify other arguments as described below according to your operation requirements. For details about the jsssetup.bat command, see jsssetup.bat (sets up JP1/IM - Service Support) in Chapter 11. Commands.
- If you want to register an Item by sending an email, specify the -t option, which makes a master system and a temporary receipt process work board. Note that you can create a master system and a temporary receipt process work board at any time by using the dedicated command (not only during setup). For details, see jsscreatesysandpwb (creates the master system and the temporary receipt process work board) in Chapter 11. Commands.
For the criteria for determining the size of the Item management database, see the Release Notes.

Notes when Windows Server 2012 or Windows Server 2008 is used:

If the Windows UAC feature is enabled and your user account has Administrator permissions other than Administrator, you must change the setting so that you can execute the command as administrator, and then execute the command. For details about how to change the setting so that the user can execute a program as the administrator, see List of commands in Chapter 11. Commands.

Configure the ODBC data source.

Configure the ODBC data source that JP1/IM - Service Support uses to connect to the databases.

Select Control Panel, Administrative Tools, and then Data Source (ODBC) to start the ODBC Data Source Administrator.

In a 64-bit OS (Windows Server 2012, Windows Server 2008, or Windows Server 2003(x64)), execute the following file to start the ODBC Data Source Administrator:

system-drive:\WINDOWS\SysWOW64\odbcad32.exe

Open the System DSN tab, and add the system data source HiRDB ODBC3.0 Driver, and set the following information.

Setting item	Setting value
DSN	jp1imss
PDHOST (HOST name)	--
PDNAMEPORT (HiRDB port number)	--
HiRDB Client environment definition file name (absolute path name)	`IM-SS-path\dbms\db\CONF\emb\HiRDB.ini`

Legend:: --: Specify no value.

Click the OK button to register the data source.

Set the environment variable group of the databases.

Use the tool for registering HiRDB client environment variables to set a client environment variable group for the databases. This group is used in the user interface of JP1/IM - Service Support and by commands.

The file that starts the tool for registering HiRDB client environment variables differs depending on the language environment of the Item management server as follows:

In a Japanese environment: IM-SS-path\dbms\db\CLIENT\UTL\pdcltadm.exe
In a English environment: IM-SS-path\dbms\db\CLIENT\UTL\pdcltadm_e.exe
In a Chinese environment: IM-SS-path\dbms\db\CLIENT\UTL\pdcltadm_e.exe

If the Windows UAC feature is enabled in Windows Server 2012 or Windows Server 2008 and your user account has Administrator permissions other than Administrator, right click pdcltadm.exe or pdcltadm_e.exe, select Run as administrator from the displayed properties window. Then execute pdcltadm.exe or pdcltadm_e.exe.

Select the System Group radio button, and then click the ADD button. The PDCLTADM dialog box is displayed. In this dialog box, set the information below. Note that the values for PDCLTCNVMODE, PDBLKF, PDLOCKSKIP, and PDIPC in the following settings must be selected from the Other environment variable combo box or directly entered.

Setting	Setting value
Group Name	`IMSS_ENV_GROUP`
PDCLTPATH	`IM-SS-path\log`
PDHOST	`127.0.0.1`
User ID	--
Password	--
PDNAMEPORT	Port number of the Item management database (The default number is 24400.)
PDSQLTRACE	--
PDSWAITTIME	--
PDCWAITTIME	`180`
PDSWATCHTIME	`0`
PDCLTCNVMODE	`NOUSE`
PDBLKF	`80`
PDLOCKSKIP	`YES`
PDIPC	`MEMORY`

Legend:: --: Specify no value.

Click the OK button to display the environment variable group name IMSS_ENV_GROUP in the PDCLTADM dialog box.

Notes:

Do not click the Test button in the PDCLTADM dialog box. If you click this button, an error is displayed.
If you select the User Group radio button and configure the settings, the settings are not applied. Select the System Group radio button and then configure the settings.

Execute the jsschauthorityserver command.

If you use an LDAP server as the authentication server, or if you use the authentication function of JP1/Base, execute the jsschauthorityserver command to switch the authentication server. This procedure is not necessary if you do not use an LDAP server as the authentication server, or if you do not use the authentication function of JP1/Base.

For details about the jsschauthorityserver command, see jsschauthorityserver (switches the authentication method) in Chapter 11. Commands.

If you want to display an HTML manual by clicking the Help button in the main window, you need to incorporate the manual into JP1/IM - Service Support. For details about the procedure for incorporating a manual, see 6.7 Procedure for incorporating a manual.

If you are using JP1/IM - Service Support Advanced Edition, you can create the Item storage database as part of the setup process. For details on how to create the Item storage database, see 10.2.10 Setting up the Item storage database.

To Page Top