Installing Agents Remotely

You can install an agent onto a UNIX machine using the web application. A remotely-installed agent cannot be installed as a service.

To install an agent:

  1. Navigate to Management > Resources.
  2. In the selection box, select Agents / Pools.
  3. Click the Agent / Agent Pool Actions button and then select Install New Agent.
  4. Enter the information needed to install the agent as follows:
    Field Description
    Target Hosts* Host names or IP addresses of the machines where the agent will be installed.
    SSH Port* Secure Shell (SSH) port addresses of the machines where the agent will be installed.
    SSH Username* SSH user name used on the machines where the agent will be installed.
    Use Public Key Authentication Check this box if you want to authenticate using public key authentication instead of a password.
    SSH Password* SSH password associated with the user name used on the machines where the agent will be installed.
    Agent Name* Name of the agent.
    Agent Dir* Directory where agent should be installed.
    Java Home Path* Path to Java on the machine where the agent will be installed.
    Temp Dir Path* Path to the directory used to perform the installation on the target machine.
    Server Host* Host name or IP address of the Deployment Automation server or agent relay to which the agent will connect.
    Server Port* Serena Deployment Automation server port (7918) or agent relay (7916) to which the agent will connect.
    Mutual Auth Check this box if the agent should enforce certificate validation for mutual authentication.
    Proxy Host Host name or IP address of the agent relay if used.
    Proxy Port HTTP port of the agent relay (20080) if used.
  5. Click Save when you are done.

Remotely installed agents will start running automatically. If a remotely installed agent stops running, it must be restarted on the host machine.