Hitachi

JP1 Version 12 JP1/Client Process Automation Configuration and Administration Guide


3.3.2 Setting up components for the AJS3 linkage function

To use the AJS3 linkage function, you need to set up hosts where CPA or CPA Option for AJS3 is installed and then start the job execution service and the message communication service on each host.

Organization of this subsection

(1) Setting up a CPA host

  1. Install CPA.

    For details on how to install it, see 2.2 Installation.

  2. Start the JP1/CPA service and the JP1/CPA Message service.

(2) Setting up AJS3 - Manager and Agent hosts

  1. Set up AJS3 - Manager and Agent.

    For details on how to set up AJS3 - Manager and Agent, see the manual JP1/Automatic Job Management System 3 Configuration Guide.

  2. Install CPA Option for AJS3.

    For details on how to install it, see 3.2 Installation. If you want jobs to be managed and executed on the AJS3 - Manager host, you install CPA Option for AJS3 on the AJS3 - Manager host. If you want jobs to be executed on a separate host from the AJS3 - Manager host, you install CPA Option for AJS3 on the AJS3 - Agent host.

  3. Start the JP1/CPA service and the JP1/CPA Message service.

(3) Setting up a AJS3 - View host

  1. Copy the following files, which are provided with CPA Option for AJS3, to the AJS3 - View host:

    • The defining program for the CPA linkage custom job and the resource file storage folder

      [File location]

      - data-path\addin\forajs\view\cpacustomdef.exe

      - data-path\addin\forajs\view\ja-JP\

      [Destination]

      Any location on the AJS3 - View host

      Ensure that the cpacustomdef.exe file and the ja-JP folder exist at the same level.

      Some security products or other protections limit locations where executable files can run. In such a case, you need to select a location so that the executable file can be allowed to run.

    • Icon for the CPA linkage custom job#

      [File location]

      data-path\addin\forajs\view\CUSTOM_PC_CPALINK.gif

      [Destination]

      AJS3-View-install-path\image\custom

      #: In AJS3 - View version 12-50 or later, you do not have to copy it as it is a standard custom job.

  2. Use AJS3 - View to register the CPA linkage custom job.

    To register the CPA linkage custom job, you complete the registration information with values described in the table below.

    For details on how to register a custom job, see the manual JP1 Version 12 JP1/Automatic Job Management System 3 Linkage Guide.

    Table 3‒2: Values you specify to register a custom job

    Item

    Value

    Defining program

    The file path name of the custom job definition program for CPA linkage, which you copied in step 1

    Execution program

    CPA-Option-for-AJS3-install-path\bin\cpalink.exe (fixed)

    Version

    1200 (fixed)

    Class name

    CPALINK (fixed)

    Job type

    PC

(4) Configuring communication with CPA

(a) Host name resolution

To communicate with CPA, ensure that the server running CPA Option for AJS3 can resolve the names of the connected hosts. A way to do this is to use the hosts file to resolve the host names to the IP addresses.

(b) Configuring the firewall and other protections to allow traffic

To communicate with CPA, ensure that the CPA Option for AJS3 host and the devices on network routes to CPA are configured with security protections to allow inbound and outbound traffic on the specified port number. The port number is defined as described in 3.3.1(1) Changing the port number of the message communication service.

For Windows Firewall, you can use the Enable firewall settings command provided in the Start menu or the cpasetfirewall command to configure the settings.

Note that the CPA Option for AJS3 uninstaller does not revert the settings. If you no longer use CPA Option for AJS3, you need to revert the settings by using the Disable firewall settings command provided in the Start menu or the cpasetfirewall command before uninstalling CPA Option for AJS3.

Remember that the Enable firewall settings and Disable firewall settings commands require administrator privileges. You must run the commands as an administrator.

To enable communication with CPA, configure Windows Firewall on both hosts to allow appropriate traffic.

Important

Ensure that the time zone is synchronized between the host on which CPA is installed and the one on which CPA Option for AJS3 is installed.

(c) Using the AJS3 linkage function in a cluster

Ensure that hosts running CPA can communicate with both the IP address of the physical host running CPA Option for AJS3 and its logical IP address.