HCL Workload Automation on Amazon Web Services

Scenario 1: Direct connection; your computer can connect to the master domain manager

Direct connection; procedure to install an agent on a computer that can connect to the master domain manager.

This scenario describes your environment if the computers on which you are launching the agents can communicate with the internet and connect to the master domain manager.

To install the agent, complete the following steps:
Note: For operating system commands see Command reference.
  1. Verify the supported operating systems and prerequisites.
  2. Before you start the installation, ensure your computer meets the following requirements:
    • For Solaris 64-bit: temporary disk space 250 MB, installation directory space inst_dir 470 MB
    • For Linux for IBM System z: temporary disk space 300 MB, installation directory space inst_dir 480 MB
    • For Linux for PCC: temporary disk space 325 MB, installation directory space inst_dir 420 MB
    • For Linux temporary disk space 250 MB, installation directory space inst_dir 470 MB
    • For AIX temporary disk space 270 MB, installation directory space inst_dir 570 MB
    • For HP-UX temporary disk space 270 MB, installation directory space inst_dir 570 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, for example /WAAgent.
  5. Extract the agent installation files to this directory:
    • For Solaris 64 bit, extract the TWS94_SOL_I386_AGENT.zip
    • For Linux for IBM System z, extract the TWS94_LNX_S390_AGENT.zip
    • For Linux for PPC, extract the TWS94_LNX_PPC_AGENT.zip
    • For Linux, extract the TWS94_LNX_X86_64_AGENT.zip
    • For AIX, extract the TWS94_AIX_AGENT.zip
    • For HP-UX, extract the TWS94_HPIA64_AGENT.zip
  6. From a shell on the computer on which you want to install the product, log on as root.
    Installing as a non-root user is also possible, but be aware of the following implications on the use of the uname keyword of the installWAAgent command, which becomes an optional parameter, and on its effect on the user_name of the agent. That is:
    • The uname keyword can be omitted because user_name is automatically set to the login name of the installer. If the installer specifies a uname with a different user_name value, an error message is returned.
    • As a consequence, the agent can run jobs uniquely with the user name of that installer.
    • Future upgrades, modifications, and removal of the agent can be made exclusively with the same login used for installation. To keep track of the login name used by the installer, at installation time the read-only InstallationLoginUser parameter is recorded with the login name in the JobManager.ini configuration file in the agent installation directory.
    Enter the following command to set the execute permission for the installation program:
    chmod a+x installWAAgent.sh
  7. If you are installing as the root user, create the user for which the agent is installed with the home directory. If you are installing as a different user, this step is not necessary as the login under which you are installing automatically becomes also the user of the agent.
    Important: If you are installing as non-root user, and you use the su- non-root username command in the shell where you are about to run installWAAgent, make sure that $HOME is set on your home directory as a non-root user (use echo $HOME to verify that the value returned corresponds to your home directory).
  8. To install the agent using the default settings, run the following command from the directory where you downloaded the agent installation files:
    ./installWAAgent.sh -new [-uname user_name] -acceptlicense yes
    Where:
    -uname user_name
    • If you logged in as the root user, it is the name of the user for which the agent is installed. This is the user you created in the previous step. Do not confuse this name with the user performing the installation logged on as root, or with the user name you received by email when you requested your subscription.
    • If you logged in as another user, you do not need to specify this keyword as it automatically takes the login name.
    -acceptlicense yes|no
    Specify whether or not to accept the License Agreement. If you specify no, the update exits without performing any action.
By default, the agent is installed in:
  • The /opt/HCL/WA_user_name directory, if you logged in as the root user. user_name is the name of the user that you specified in the -uname user_name option. If the /opt/HCL directory already exists, ensure that the directory permission is set to 755.
  • The home_dir/TWA directory, if you logged in with a different login. Ensure that the directory permission of home_dir is set to 755 and that your login owns it.
The default value assigned to the -gwid <gateway_site_label> parameter is GW1. Also, the agent is installed by using the 31114 port to dispatch workload, the 31132 port to dispatch events, and all the default values. If the 31114 port is already in use, then install the agent specifying this additional parameter: -jmport port_number and a number in the range 1-65535 as follows:
./installWAAgent.sh -new [-uname user_name] -acceptlicense yes 
-jmport port_number

After a successful installation proceed with the installation of another agent if necessary.

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.