Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Configuration Guide


3.4.1 Setting up JP1/AJS3 - Manager

This subsection describes how to set up the Windows version of JP1/AJS3 - Manager as required to connect JP1/AJS3 - Web Console and JP1/AJS3 - Manager. To set up JP1/AJS3 - Manager, you must have administrator privileges.

Note

If the OS of the JP1/AJS3 - Manager host to which JP1/AJS3 - Web Console connects is UNIX, see 13.3.1 Setting up JP1/AJS3 - Manager.

To set up JP1/AJS3 - Manager:

  1. In Windows Control Panel, open the Services administrative tool, and stop the following service:

    • JP1/AJS3 service

  2. When JP1/AJS3 - Manager has been installed by performing an upgrade installation, specify settings to start the ajscdinetd process.

    You do not need to perform this procedure if a new installation of JP1/AJS3 - Manager version 11-00 or later was performed, or if this procedure has already been performed.

    The ajscdinetd process of JP1/AJS3 - Manager must be started to enable JP1/AJS3 - Manager to accept connections from JP1/AJS3 - Web Console. To start the ajscdinetd process, you must revise the JP1/AJS3 startup process definition file (jp1ajs_hstd.conf) and the extended startup process definition file (jp1ajs_hsad_0700.conf) of JP1/AJS3 - Manager. You must also add the port number of the port the ajscdinetd process uses to the services file.

    How to specify settings in these definition files varies depending on whether the jp1ajs_hstd.conf file or the jp1ajs_hstd_0700.conf file has already been revised. To check whether the jp1ajs_hstd.conf file or the jp1ajs_hstd_0700.conf file has already been revised, open each file by using a text editor.

    The following shows the storage folders for jp1ajs_hstd.conf, jp1ajs_hstd_0700.conf, and the model files:

    For a physical host:

    JP1/AJS3-Manager-installation-folder\conf

    For a logical host:

    shared-folder\conf

    If the jp1ajs_hstd.conf file and the jp1ajs_hstd_0700.conf file have not been revised, see (1) Settings to start the ajscdinetd process (when the definition files have not been revised). If the jp1ajs_hstd.conf file or the jp1ajs_hstd_0700.conf file has already been revised, see (2) Settings to start the ajscdinetd process (when the definition files have already been revised).

  3. If necessary, change the restart setting of the ajscdinetd process.

    With the initial settings for JP1/AJS3 - Manager, the ajscdinetd process restarts if the ajscdinetd process has ended abnormally. If necessary, change this restart setting.

    The restart of the ajscdinetd process is defined in the JP1/AJS3 - Manager extended startup process definition file (jp1ajs_hstd_0700.conf). For details about the extended startup process definition file, see 6.3.1 Restarting an abnormally terminated JP1/AJS3 process in the JP1/Automatic Job Management System 3 Administration Guide.

  4. If necessary, change the setting of the size of the internal log for the ajscdinetd process.

    Use the AJSCDINETDLOGSIZE environment setting parameter to specify the setting of the size of the internal log for the ajscdinetd process.

    For details about the AJSCDINETDLOGSIZE environment setting parameter, see 20.4.2(22) AJSCDINETDLOGSIZE.

  5. Specify settings to pass through the firewall.

    When a firewall is set in the operating environment, you must specify settings to enable the communication between JP1/AJS3 - Web Console and JP1/AJS3 - Manager to pass through the firewall.

    For the port numbers to be used by JP1/AJS3 - Web Console and JP1/AJS3 - Manager and the directions of communication traffic through a firewall, see A. List of Port Numbers in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.

  6. If necessary, set environment setting parameters.

    Based on a preliminary review, change settings of environment setting parameters. For details about the environment setting parameters to be reviewed, see 4.6.2 Environment settings for JP1/AJS3 - Manager connected with a Web Console server in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.

    To change the settings of environment setting parameters, use the jajs_config command. For details about how to set environment setting parameters, see 4.2 Environment setting parameter settings.

  7. Start the JP1/AJS3 service.

Organization of this subsection

(1) Settings to start the ajscdinetd process (when the definition files have not been revised)

The following describes how to specify settings to start the ajscdinetd process when the content of the JP1/AJS3 startup process definition file and the JP1/AJS3 extended startup process definition file have not been changed from the initial status:

  1. Back up the jp1ajs_hstd.conf file and the jp1ajs_hstd_0700.conf file.

  2. Copy the model file (jp1ajs_hstd.conf.model) for the JP1/AJS3 startup process definition file, and then rename the copy of the model file to jp1ajs_hstd.conf.

  3. Copy the model file (jp1ajs_hstd_0700.conf.model) for the extended startup process definition file, and then rename the copy of the model file to jp1ajs_hstd_0700.conf.

  4. When logical hosts are used for operations, copy the files created in steps 2 and 3 into a shared folder.

  5. In the services file, add the port number of the port to be used by the ajscdinetd process.

    Default port number:

    22250

    Example of adding a port number:

    jp1ajs3cdinetd 22250/tcp # JP1/AJS3 - Web Console

    If the default port number cannot be used, specify the port number of the port to be used by the ajscdinetd process while avoiding the duplicate specification of the port number specified for any other process. When you change the port number to be used from the default, you also need to change the connection port number specified in the network-settings file for JP1/AJS3 - Web Console.

    If a duplicate port number is specified, a message (KAVS0904-E) is output to the integrated trace log when the ajscdinetd process starts.

Cautionary note:

The port number setting added in the services file is not deleted by performing an uninstallation of JP1/AJS3 - Manager. When the port number setting is no longer necessary, you need to delete it manually.

(2) Settings to start the ajscdinetd process (when the definition files have already been revised)

The following describes how to specify settings to start the ajscdinetd process when the content of the JP1/AJS3 startup process definition file or the JP1/AJS3 extended startup process definition file has been changed from the initial status:

  1. Open the jp1ajs_hstd.conf file.

  2. Add a definition of the ajscdinetd process on any line.

    Add the following definition:

    ajscdinetd|ajscdinetd.exe|||1800|
  3. Save the jp1ajs_hstd.conf file.

  4. Open the jp1ajs_hstd_0700.conf file.

  5. Add a definition of the ajscdinetd process to any line.

    Add the following definition:

    ajscdinetd|ajscdinetd.exe||1|3|3|21600|0|0|hostevam|1|||||||
  6. Save the jp1ajs_hstd_0700.conf file.

  7. Add the port number of the port to be used by the ajscdinetd process in the services file.

    Default port number:

    22250

    Example of adding a port number:

    jp1ajs3cdinetd 22250/tcp # JP1/AJS3 - Web Console

    If the default port number cannot be used, specify the port number of the port to be used by the ajscdinetd process while avoiding the duplicate specification of the port number specified for any other process. When you change the port number to be used from the default, you also need to change the connection port number specified in the network-settings file for JP1/AJS3 - Web Console.

    If a duplicate port number is specified, a message (KAVS0904-E) is output to the integrated trace log when the ajscdinetd process starts.

  8. Start the JP1/AJS3 service.

Cautionary note

The port number setting added in the services file is not deleted by performing an uninstallation of JP1/AJS3 - Manager. When the port number setting is no longer necessary, you need to delete it manually.