Installing agent relays in silent mode

In silent mode, you specify the installation properties in a text file and then run the agent relay installation without command-line prompts.

Before you begin

  • Ensure that the computer on which you are installing the agent relay has a supported version of the Java Runtime Environment (JRE) or Java Development Kit (JDK).
  • Set the PATH variable to contain the location of the JRE or JDK that you are using.
  • Ensure that the firewall on the computer allows connection to the HCL Launch server through HTTP/HTTPS.
  • Install the HCL Launch server.
  • Ensure that you have an authentication token for the relay. If you intend to use the component version replication option, the token must be assigned to a user with the server configuration permission Read Artifact Set List. For information about tokens, see Setting server configuration security.
  • Set up an account on the computer for the agent relay to use.
  • Make sure that your networks and firewalls allow communication on the required ports. See Firewall and communication configuration.
  • Ensure that there is no limit on the maximum memory size and virtual memory size. For example, on most Linux systems, you can run the ulimit -m and ulimit -v commands and ensure that both return the value unlimited. To find out how to remove the limit on the maximum memory size and virtual memory size, see the documentation for the operating system.

About this task

To install the agent relay in silent mode, you specify the installation properties in a properties file. The example.agentrelay.install.properties file is provided as an example of a properties file. The example.agentrelay.install.properties file is in the agent relay installation file.

Procedure

  1. Download and extract the agent relay installer to the computer on which you want to install the agent relay:
    • To download the installer from the server, click Help , located in the upper-right corner of the page, and then click Tools. Then, click HCL Launch Agent Relay and download and extract the file.
    • To find the installer on the server with the command line, go to the following location and copy the file to the target system: installation_folder/opt/tomcat/webapps/ROOT/tools/agent-relay.zip
  2. Expand the compressed installation file.
  3. Open the example.agentrelay.install.properties file for editing, or copy the example.agentrelay.install.properties file to a new properties file.
  4. Customize the installation by specifying the properties in the agent relay installation properties file.
    If you do not specify a property, the default value is used. These properties are copied to the agentrelay.properties file of the completed installation.
  5. Save the file.
  6. Run the installation file with the install-silent.cmd command on Windows or the ./install-silent.sh command on Linux. Provide the properties file as a command-line argument.
    For example, on Windows, if the properties file is named installrelay.properties, type the following command:
    install-silent.cmd installrelay.properties
    On Linux, if the properties file is named installrelay.properties, type the following command:
    ./install-silent.sh installrelay.properties
    To install a FIPS-compliant agent relay, add the -fips parameter, as in the following example:
    ./install-silent.sh installrelay.properties -fips
  7. If the relay is on Linux or UNIX and will connect to 400 or more agents, increase the process and file limit for the server:
    1. Add the following lines to the file that sets process and file limits.
      For example, for Red Hat Enterprise Linux, version 7, use the /etc/security/limits.conf file. For AIX, use the /etc/security/limits.d/90-nproc.conf file.
      relayUser             soft    nofile          60000
      relayUser             hard    nofile          60000
      relayUser             soft    nproc           65535
      relayUser             hard    nproc           65535
      Use the name of the operating system user that is running the agent relay for relayUser. By default, the agent relay installation program creates a user that is named agentrelay.
    2. Restart the computer that hosts the agent relay.
  8. To start the agent relay, go to the installation folder for the relay and run the following command:
    bin/agentrelay start

Results

Any messages that are created during the installation are stored in the file agentrelay-install.log.

What to do next

If you must modify the relay, you can edit these properties in the agentrelay.properties file in the relay_installation\conf directory.

Now you can install agents and connect them to the relay. See Installing agents.

To monitor the status of the relay and the agents that are connected to it, click Resources > Agent Relays. This tab shows the number of active and offline agents that are connected to each relay. For more information about an agent relay, in the Name column, click the relay.