Upgrading agent relays from the command line#

When you upgrade the server, be sure to always upgrade agents and agent relays.

Upgrade the server.

The CodeStation request port is configured automatically on the system where the agent relay is located. The CodeStation port number is one greater than the number assigned for HTTP communication. By default, the HTTP port is 20080. If you use the default value for the HTTP port, the CodeStation request port would be numbered 20081.

If the CodeStation request port is blocked, agents cannot download artifacts. If you upgrade from versions before 6.1, ensure that the port is not blocked by the firewall or other processes on the agent relay system.

Important: After you upgrade to HCL™ Launch version 6.2.2 or later, note these changes to agent relays:

Upgrade the agent relays as follows:

  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
    • Stop the agent relay.
  2. If the system that hosts the agent relay is using a version of Java prior to version 8, upgrade to a JRE of version 8 or later.

    See Updating the JRE location for agent relays.

  3. From the agent relay installer folder, run install.sh (Linux) or install.cmd (Windows).

    • Enter the home directory for the JRE/JDK that the relay should use.

      Specify the directory in which Java™ is installed. Press Y to accept the location set in the JAVA_HOME parameter.

    • *Enter the directory to install the agent relay into.*

      Enter the current directory that the relay is installed in. The default value is /opt/ibm/agentrelay on Linux™ and C:\Program Files\IBM\agentrelay on Windows™.

    • *The specified directory appears to contain an existing installation. Do you want to upgrade it?*

      Enter Y.

    • *Enable the agent relay to verify the server HTTPS certificate? If enabled, you must import the server certificate to the JRE keystore on the agent relay.*

      Specify whether to verify the server HTTPS certificate.

    • *Web communication is a new and more scalable replacement for JMS. Contact your UCD administrator to determine if your server is ready to use Web communication. A Web relay will not support connections from agents using the legacy JMS mode. This Agent Relay is currently set to use JMS. Should this agent relay be changed from JMS to web communication? [y/N] >*

      Starting with version 7.1.0.1, you can change JMS relays to Web via upgrade. If you select y, make sure that the agents connected with the relay are Web agents.

  4. To start the agent relay, go to the installation folder for the relay and run the following command:

    bin/agentrelay start

Parent topic: Upgrading agent relays