Install agent relays in silent mode on Windows
You can configure and install a Deployment Automation agent relay in silent mode on Windows.
Install an agent relay silently
Silent mode uses an options file to run an installation in the background.
To install an agent relay in silent mode on Windows:
Download the agent relay installer for Windows from the Software Licensing and Downloads portal (requires login).
Create an options file, add the agent relay options, and save the file as C:/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.cmd -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.
The following table describes the agent relay options for silent installation on Windows.
Enter the path to the directory where to install the agent relay. If the directory doesn't exist, specify one to create, for example:
C:\Program Files\Micro Focus\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.
Enter the path to the Java installation directory. Ensure that the JAVA_HOME environment variable points to this directory, for example:
C:\Program Files\Micro Focus\common\jre\<version>
|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.|
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 communications with remote agents. Default: 7916.|
|AGENT_RELAY_MUTUAL_AUTH||If mutual authentication is required, enter true. For details, see Configure SSL mutual authentication.|
you want the agent relay to connect to the
Deployment Automation 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.|
Specify whether or not (true of false) to install the agent relay as a Windows service. Default: true.
If you specify true, set the following options:
|INSTALL_SERVICE_NAME||Enter a unique name for the service. No spaces are allowed. Default: agentrelay.|
|INSTALL_SERVICE_LOGIN||Enter a username, including the domain path, under which to run the service. For a local account, put .\ before the username. Default: .\localsystem.|
|INSTALL_SERVICE_PASSWORD||(Optional) Enter a password for the Windows service user account. Default: nopass.|
|INSTALL_SERVICE_AUTOSTART||Specify whether or not (true or false) to start the Windows service automatically. Default: false.|
Options file example
Use the following example of the optionsFile.txt settings to configure agent relay silent installation on Windows.
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. The agent relay runs as a Windows service named sda-relay123 that is set to start automatically when the system starts. The admin user account name for the agent relay Windows service is admin01, and the password is password.