Agent Installation

You can install agents on supported operating systems using an interactive installer, a silent installer, console installation mode, or manual installation steps.

If you plan to run deployments on several machines, a separate agent should be installed on each machine. If, for example, your testing environment consists of three machines, install an agent on each one. Follow the same procedure for each environment the application uses.

Important: Except for evaluation purposes, do not install an agent on the same machine as the server.

Note:

For UNIX environments, you can install agents remotely from the Release Automation web application. Agents installed remotely cannot be run as a service. See Installing Agents Remotely.

Permission for Users Installing Agents

The user performing the agent installation needs full access rights to the installation location used.

The default installation location for the UNIX Release Automation agent is:

/opt/serena/Release_Automation_Agent

The default installation location for the Windows Release Automation agent is:

C:\Program Files (x86)\serena\Release Automation Agent

Permission for Users Running Agents

Each agent needs the appropriate permission to communicate with the Release Automation server.

For production environments, Serena recommends creating a user account dedicated to running the agent on the machine where the agent is installed.

For simple evaluations, the administrative user can run the agent on the machine where the server is located.

At a minimum, the user running the agent should have permission to do the following:

Create a cache. By default, the cache is located in the home directory of the user running the agent. The cache can be moved or disabled.
Open a TCP connection. The agent uses a TCP connection to communicate with the server's JMS port.
Open a HTTP(S) connection. The agent must be able to connect to the Release Automation user interface to download artifacts from CodeStation.
Access the file system. Many agents need read/write permission to items on the file system.

The following topics lead you through an agent installation.