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.
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
- 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
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
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.