Hitachi

JP1 Version 12 JP1/Service Support Configuration and Administration Guide


6.3.2 Setup procedure for new installation

Use this procedure to set up JP1/Service Support that was newly installed. This procedure is the same for all JP1/Service Support products. Notes on setting up, see 6.9.2 Notes on Setting Up.

Important

The setting of client environment variable group is not required for JP1/Service Support 11-00 or later.

  1. Edit the jsssetupinfo.bat command file.

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

    JP1/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‒5: 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

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

    Note

    A model file (JP1/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.

  2. Execute the jsssetup.bat command.

    From the Start menu, select Programs, JP1_Service Support, and then JP1_SS Command Prompt, and execute the jsssetup.bat command with the -s option specified as an argument to set up JP1/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/Service Support) in Chapter 12. Commands.

    For the criteria for determining the size of the Item management database, see 5.12.5 Criteria for determining the Item management database size.

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

  3. Configure the ODBC data source.

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

    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)

    JP1/SS-path\dbms\db\CONF\emb\HiRDB.ini

    Legend:

    --: Specify no value.

    Click the OK button to register the data source.

  4. 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 12. 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/Service Support. For details about the procedure for incorporating a manual, see 6.8 Procedure for incorporating a manual.

Note that, if you plan to use an Item storage database, the Item storage database can be set up as part of the setup process. For details on how to create the Item storage database, see 11.2.10 Setting up the Item storage database.