Agent relay installation options
This topic describes the options you need to configure when installing an agent relay.
The following table lists the options requested by the installer. Where Windows and UNIX/Linux options differ, platform-specific information is included.
Agent relay configuration table
The following table describes agent relay configuration options.
|Please enter the directory where you would like to install the agent relay.||
Enter the directory where you want the agent relay installed. If it does not exist, the system prompts you on whether to create it. For example:
Windows: C:\Program Files\Micro Focus\agentrelay
|Please enter your java home.||
directory where Java is installed. Ensure that the
Windows : C:\Program Files\Micro Focus\common\jre\8.0
Note: On Windows, JRE 8.0 is required for an agent relay to be installed as a service. On all platforms, to restrict the security protocols, you must use version Java 8.0.
|Enter the name of this relay.||Enter the name of the agent relay. Each agent relay must have a unique name. The default name is agent-relay.|
|Enter the IP or host name which this agent relay should use||Enter the IP address or host name on which the agent relay will listen for HTTP requests coming from agents.|
|Enter the port which this agent relay should proxy HTTP requests on||
Enter the port on which the agent relay will listen for HTTP requests coming from agents. The default port is 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 will then automatically connect through HTTPS. Agent relays will automatically use HTTPS when agents request HTTPS links.
|Port which this agent relay should use for communication.||Enter the port on which the agent relay will use for JMS-based communications with remote agents. The default port is 7916.|
|Connect the agent relay to a central server?||Specify whether
you want the agent relay to connect to the
server as follows:
Note: If you aren't sure, accept the default value (Y). To change it later, edit the agentrelay.properties file located in the relay_installation\conf directory.
|Enter the IP or hostname of your central server||If you selected Y in the option to connect the agent relay to the server, enter the IP or host name where the agent relay can contact the server.|
|Enter the port which the central server uses for communication||If you selected Y in the option to connect the agent relay to the server, enter the port the server uses to communicate with agents. The default is 7918.|
|Use mutual authentication between the agent, relay and server.||If mutual authentication is required, enter Y. For more information, see Configure SSL mutual authentication.|
|Do you want to install the Agent Relay as Windows service?||If you are installing the agent relay on Windows, you can install it as a Windows service. The default value is N. If you specify Y, see the following table entries.|
|Enter a unique service name for the Agent Relay. No spaces please.||(Required for running as a Windows service) Enter a unique name for the service. The default is agentrelay.|
|Enter the user account name including domain path to run the service as (for local use '.\.' before login).||(Required for running as a Windows service) Enter an account name, including the domain path under which to run the service. For a local user, insert .\ before the user name. The default is .\localsystem.|
|Enter the password for the '.\localsystem' user account.||(Optional for running as a Windows service) Enter a password for the Windows service user account name. The default is no password.|
|Do you want to start the service automatically?||(Required for running as a Windows service) Specify whether or not (y|N) you want the Windows service to be started automatically. The default is N.|
Note: If you need to modify the agent relay settings, edit the agentrelay.properties file located in the <relay_installation>\conf directory. You can also manage agent relays through the user interface. See Manage agent relays.