Installing Agents in Unix or Linux

Tidal Automation implements agents using Java to support agents running on operating systems other than Microsoft Windows. By using the industry-standard Java development platform, TA agents can run seamlessly on a wide variety of environments, such as Unix, Linux, OVMS, z/OS, and OpenVMS.

Note: If you are using Unix Agent version 4.0.0.2, the minimum required version of Java is 17.

Installing an Agent

Before installing a Unix/Linux TA Agent, backup your files and gather the information:

  • Name of the user who will own the agent

  • Port number for the agent

  • Directory path for the Java Virtual Machine (JVM)

Note: If a non-default umask (0022) is set for the root user, the access permissions to the jar files in the lib directory may require updating. All desired runtime users should have read access to the jar files.

To install the agent from the command line:

Note: While the installer must be run as the root user, the user who runs the agent service must have read access to the directory in which the agent is installed (/opt, by default).

  1. Download the Tidal Automation Agent for Linux/Unix software.

  1. Login as root.

  1. Copy the install.sh and install.tar files to your temp directory.

    Note: Do not unpack the install.tar file. The file will automatically unpack during the installation process.

  1. Change the permissions on the install.sh file in the directory to make the file executable:

    chmod 554 install.sh install.tar

  1. Begin the installation by entering:

    ./install.sh

    The installation program displays an introductory dialog.

  1. Enter Y to continue the installation, and press Enter. The Select the Owner dialog opens.

    The top of the screen shows the users defined on the machine. In some cases, you might want to choose a user who is not defined on the local machine but is defined as a NIS user allowing the user to install over the network.

  1. Enter the name of the user to own the agent.

    Note: Carefully consider which user you use to run the agent. You might want to create a user specifically for this purpose.

  1. Press Enter.

  1. Enter Y in the Select the Location panel; then press Enter. The Agent Configuration Menu dialog opens.

  1. Type 1 to choose the Add Instance option; then press Enter. The Select the Location for the Agent Files dialog opens.

  1. Enter the information you gathered before beginning installation:

    • Name to call the agent

    • Number of the port the agent should use

    • Directory path for the Java binary files (JVM)

  1. Click Enter. A confirmation dialog displays the information that you entered.

  2. Do either of these:

    • If the information is correct, press Enter.

    • If the information is not correct, type n.

    You are prompted again for the name, port number, and directory path for the agent.