Install agent relays in silent mode on UNIX/Linux
This topic describes how to configure and install a Deployment Automation agent relay in silent mode on UNIX/Linux platforms.
Install an agent relay in silent mode on UNIX/Linux
Note: 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 the following are installed:
- Motif: Usually available by default
- 32-bit compatibility libraries: C/C++ runtime
To install an agent relay in silent mode on UNIX/Linux:
Download the agent relay installer for your platform.
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.
From a command prompt, run this command:
install.sh –silent –options optionsFile.txt
where optionsFile.txt is the options file you created in step 2.
After you install your agent relay, continue with the next steps in the Installation checklist.
The following table describes the agent relay silent installation options for UNIX/Linux.
directory where you want the agent relay installed. If it does not exist, you
will be prompted on whether to create it, for example:
Note: This is the only required option for running the agent relay silent installation. If only this property is included, the rest of the options will have the default values.
directory where Java is installed. Ensure that the
|AGENT_RELAY_NAME||Enter the name of
the agent relay. Each agent relay must have a unique name. The default name is
|PROXY_HOST||Enter the IP address or host name on which the agent relay will listen for HTTP requests coming from agents.|
Enter the port on
which the agent relay will listen for HTTP requests coming from agents. The
default port is
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 will then automatically connect through HTTPS. Agent relays will automatically use HTTPS when agents request HTTPS links.
|AGENT_RELAY_RELAY_PORT||Enter the port on
which the agent relay will use for JMS-based communications with remote agents.
The default is
authentication is required, enter
you want the agent relay to connect to the
server as follows:
Note: If you aren't sure, accept the default
|AGENT_RELAY_SERVER_HOST||If you entered
|AGENT_RELAY_SERVER_PORT||If you entered
|AGENTRELAY_USER||UNIX/Linux username under which to run the agent relay.|
|AGENTRELAY_GROUP||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 located in the <relay_installation>\conf directory. You can also manage some agent relay settings through the user interface. See Manage agent relays.
Example of silent installation settings in an options file
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.
AGENT_RELAY_HOME=/opt/MicroFocus/agentrelay JAVA_HOME=/opt/MicroFocus/common/jre 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