Remote Agent Installation

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. Display the Install New Agent dialog by clicking the Install New Agent button on the Agents pane Home > Resources > Agents.

2. Enter the required information into the dialog's fields:

   Remote Agent Installation fields table

   Field	Description
   Target Hosts*	Host names or IP addresses of the machines where the agent will be installed.
   SSH Port*	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 Serena Release Automation server or agent relay to which the agent will connect.
   Server Port*	Serena Release Automation server port (7918) or agent relay (7916) to which the agent will connect.
   Mutual Authentication	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.

3. 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.