Install agent relays in silent mode on UNIX/Linux

You can configure and install a Deployment Automation agent relay in silent mode on UNIX/Linux platforms.

Install an agent relay silently

Silent mode uses an options file to run an installation in the background.

UNIX: UNIX installers are 32-bit applications, and 64-bit systems may not support them by default. Before running the installer on a 64-bit Linux system, ensure that you have Motif installed (usually available by default).

To install an agent relay in silent mode on UNIX/Linux:

  1. Download the agent relay installer for your platform from the Software Licensing and Downloads portal (requires login).

  2. Create an options file, add the agent relay options, and save the file as optionsFile.txt. For details, see Silent installation options for an agent relay.

    Note: Make sure that the options file is in ANSI format. The agent installer does not support UTF.

  3. From a command prompt, run this command:

    install.sh –silent –options optionsFile.txt

    where optionsFile.txt is your options file.

After you install your agent relay, continue with the next steps in the Installation checklist.

Back to top

Silent installation options for an agent relay

The following table describes the agent relay options for silent installation on UNIX/Linux.

Option Description
AGENT_RELAY_HOME

Enter the path to the directory where to install the agent relay. If the directory doesn't exist, specify one to create, for example:

/opt/MicroFocus/agentrelay

Note: This is the only required option for the agent relay silent installation. If only this property is included, other options have the default values.
JAVA_HOME

Enter the path to the Java installation directory. Ensure that the JAVA_HOME environment variable points to this directory, for example:

/opt/MicroFocus/common/jre

AGENT_RELAY_NAME Enter the name of the agent relay. Each agent relay must have a unique name. Default name: agent-relay.
PROXY_HOST Enter the IP address or host name which the agent relay uses to listen for HTTP requests coming from agents.
PROXY_PORT

Enter the port which the agent relay uses to listen for HTTP requests coming from agents. Default: 20080.

Note: Agent relays can also communicate through HTTPS. To enable this communication, configure the server to work through HTTPS and change the external agent link to use HTTPS. Agents then automatically connect through HTTPS. Agent relays automatically use HTTPS when agents request HTTPS links.

AGENT_RELAY_RELAY_PORT Enter the port for the agent relay to use for JMS-based communication with remote agents. The default is 7916.
AGENT_RELAY_MUTUAL_AUTH If mutual authentication is required, enter true. For details, see Configure SSL mutual authentication.
AGENT_RELAY_CONNECT Specify whether you want the agent relay to connect to the Deployment Automation server as follows:
AGENT_RELAY_SERVER_HOST If you entered true for AGENT_RELAY_CONNECT, enter the IP or host name where the agent relay can contact the server.
AGENT_RELAY_SERVER_PORT If you entered true for AGENT_RELAY_CONNECT, enter the port the server uses to communicate with agents. Default: 7918.
AGENTRELAY_USER Enter the UNIX/Linux username under which to run the agent relay.
AGENTRELAY_GROUP Enter the UNIX/Linux group name under which to run the agent relay.

Note: To change the agent relay settings after the installation, edit the agentrelay.properties file in the <relay_installation>\conf directory. You can also manage some agent relay settings in the user interface. For details, see Manage agent relays.

Back to top

Options file example

Use the following example of the optionsFile.txt settings to configure agent relay silent installation on UNIX/Linux.

In this optionsFile.txt, the agent relay named Relay123 is configured to connect to the server on DAServerHost. The mutual authentication mode for the agent relay is activated.

Copy code 
AGENT_RELAY_HOME=<agentrelay-install-directory> 
JAVA_HOME=<jre-install-path>            
AGENT_RELAY_NAME=Relay123
PROXY_HOST=0.0.0.0
PROXY_PORT=20080
AGENT_RELAY_RELAY_PORT=7916 
AGENT_RELAY_MUTUAL_AUTH=true
AGENT_RELAY_CONNECT=true
AGENT_RELAY_SERVER_HOST=DAServerHost
AGENT_RELAY_SERVER_PORT=7918
AGENTRELAY_USER=agentrelay
AGENTRELAY_GROUP=agentrelay 

Back to top

See also: