HCL Workload Automation on Amazon Web Services

Scenario 2: Computers that cannot connect to the master domain manager but connect through a computer that acts as a gateway

Installation procedure for computers that cannot connect to master domain manager but connect through a computer that acts as a gateway.

This scenario describes your environment if the computer where you are installing the agent cannot connect to the master domain manager but a computer in your network can connect to the master domain manager. This computer acts as a gateway in your network zone.

To configure your network, first install the agent, let's call it Agent 1, on the computer that can connect to the master domain manager, then install Agent 2. Follow the instructions below to install all the agents.

  1. Verify the supported operating systems and prerequisites.
  2. Before you start the installation, ensure that your computer meets the following requirements:
    Temporary disk space
    300 MB
    Installation directory space
    480 MB
  3. If you did not already download the agent installation files, go to the Dynamic Workload Console landing page. In the Download and Install section, you can download the agent installation files for the selected operating system platform.
  4. Go to the directory where you saved the compressed agent installation files, in this example, /WAAgent.
  5. Extract the agent installation files TWS94_IBM_I_AGENT.zip to the /WAAgent directory.
  6. On the computer on which you want to install the product, sign on as the QSECOFR user.
  7. Use the PASE shell or the AIXterm command to extract the package:
    Using PASE shell:
    1. Open the PASE shell.
    2. Run the command "CALL QP2TERM".
    3. Locate the folder where you downloaded the agent installation files and run the command:
      "unzip TWS94_IBM_I_AGENT.zip"
    4. Exit from the PASE shell.
    Using AIXterm command:
    1. Start the Xserver on your desktop.
    2. On the iSeries machine, open a QSH shell and export the display.
    3. In QSH shell, go to the directory /QopenSys and run the command "aixterm -sb".
    4. A pop-up window is displayed on your desktop. By Using this pop-up window, unzip the TWS94_IBM_I_AGENT.zip file.
  8. Change to the directory where you downloaded the agent installation files.
  9. Install Agent 1 and then install Agent 2. The installation of Agent 2 depends on whether you install Agent 1 using the default installation settings or if you install Agent 1 using custom settings.
    Agent 1 installed using the default installation parameter settings
    The default installation assigns port number 31114 to the -jmport parameter to dispatch the workload, and port number 31132 for the -gwiefport parameter to dispatch events. To install Agent 2 using the default installation settings, submit the following command:
    ./installWAAgent.sh -new [-uname <user_name>] 
     -gateway remote -gwhostname <host_name_of_Agent1>
     -acceptlicense yes
    This command performs an installation assigning the default values for the installation parameters. If you want to customize some of these values, for example the value of the -jmport parameter because the default port number is already in use, you can use the following command instead:
    ./installWAAgent.sh -new [-uname <user_name>] 
    -jmport <jmport_value>
    -gateway remote -gwhostname <host_name_of_Agent1> 
     -gwport <jmport_number_Agent1> 
    -acceptlicense yes
    You can also customize other parameters such as the installation directory or the display name for your agent. See UNIX, Linux, and IBM i command syntax and parameters for more information about all of the customizable parameters.
    Agent 1 installed using a custom installation, with custom values for the -jmport parameter
    If you installed Agent 1 using a custom installation to customize the -jmport parameter such as following:
    ./installWAAgent.sh -new -uname <user_name>
    -jmport <jmport_value> -acceptlicense yes
    Then, install Agent 2 and Agent 3 as follows:
    ./installWAAgent.sh -new [-uname <user_name>] 
    [-jmport <jmport_value>]
    -gateway remote -gwhostname <host_name_of_Agent1>
    -gwport <jmport_number_Agent1> -acceptlicense yes
    Where:
    -uname user_name
    The name of the user for which the agent is installed.
    -jmport port_number
    This is the port through which this agent is contacted. The default is 31114. The valid range is from 1 to 65535.
    -gateway local|remote
    • Use local to specify that the computer can connect directly with the master domain manager and that it also routes communication for other computers that cannot communicate directly. This is the default setting.
    • Use remote to specify that the computer on which you are installing the agent communicates with the master domain manager through a gateway configured on a different agent.
    -gwhostname host_name_of_Agent1
    This is the fully qualified host name or IP address of the remote gateway you want to use. In our example, this corresponds to Agent 1.
    -gwport jmport_number_of_Agent1
    This is the jmport number of the remote gateway you want to use. In our example, this corresponds to Agent 1.
    -acceptlicense yes|no
    Specify whether or not to accept the License Agreement. If you specify no, the update exits without performing any action.

To customize any of the default installation settings, see UNIX, Linux, and IBM i command syntax and parameters.

If the installation did not complete successfully, an error is displayed on the screen. Correct the error as described in the error Operator Response that you find in the inst_dir/logs file, and rerun the installation.