Hitachi

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


21.8.3 Environment in which each container requires a different port number for communication

There might be an environment in which JP1/AJS3 - Agent is deployed for each container of the container orchestration system or container management software and communication to each container is performed with a different port number from external hosts. In such an environment, the destination port mapping function of JP1/Base must be used on the external hosts that communicate to the containers. For details about the destination port mapping function, see 2.12.2(4) Destination port mapping function in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.

The procedure for setting up the destination port mapping function is as follows:

  1. Edit the destination communications port settings file (jp1_destport.conf).

    Create the destination communications port settings file by editing its model file (jp1_destport.conf.model). In the initial settings of the model file, all lines are commented out by prefixing a hash mark (#). If necessary, delete the hash marks (#) and change the port numbers from the default values. A port number specification is required for each container. An example of editing the file is as follows:

    Before the change:

    #
    # jp1_destport.conf
    #
    #[container1]
    #jp1ajs2qagt    20242     # To send job execution requests to JP1/AJS3 - Agent
    #jp1ajs2eaagt   20247     # JP1/AJS3 - Agent event job execution
    #jp1ajs2chkagt  23139     # To use the definition pre-check function
    #jp1ajs2qlagt   20300     # To use queueless jobs(For queueless job execution by JP1/AJS3 - Agent)
    #jp1ajs2atmsg   22251     # Flexible job execution
    #jp1ajs3sysctla 22257     # To use the Web GUI (Management Portal)
    #jp1imevt       20098     # Transferring JP1 events to another host

    After the change:

    #
    # jp1_destport.conf
    #
    [container1]
    jp1ajs2qagt    30242     # To send job execution requests to JP1/AJS3 - Agent
    jp1ajs2eaagt   30247     # JP1/AJS3 - Agent event job execution
    jp1ajs2chkagt  33139     # To use the definition pre-check function
    jp1ajs2qlagt    30300     # To use queueless jobs(For queueless job execution by JP1/AJS3 - Agent)
    jp1ajs2atmsg   32251     # Flexible job execution
    jp1ajs3sysctla  32257     # To use the Web GUI (Management Portal)
    jp1imevt       30098     # Transferring JP1 events to another host
     
    [container2]
    jp1ajs2qagt    31242
    jp1ajs2eaagt   31247
    jp1ajs2chkagt  34139
    jp1ajs2qlagt   31300
    jp1ajs2atmsg  33251
    jp1ajs3sysctla  33257
    jp1imevt       31098

    For details about how to edit the destination communications port settings file, see the JP1/Base User's Guide.

    Cautionary note:

    When defining a destination communication port by using the jbsdestpimport command, ensure that no jobs are being executed on the target container. Defining the destination port while jobs are running can cause communication failures with the target container, resulting in jobs ending abnormally or command execution failures.

    Additionally, it may take up to 30 seconds for the definition of the destination port for services used by queueless jobs (jp1ajs2qlagt) to take effect. Therefore, avoid executing queueless jobs on the target container immediately after defining the destination port.

  2. Execute the jbsdestpimport command.

    For details about the jbsdestpimport command, see the JP1/Base User's Guide.

    To check the information registered by the jbsdestpimport command, execute the jbsdestpexport command. For details about the jbsdestpexport command, see the JP1/Base User's Guide.

  3. Enable the destination port mapping function (if it has not been enabled).

    For details about how to enable the destination port mapping function, see 21.8.6 Settings for using the destination port mapping function.