Upgrading agent relays from the command line
When you upgrade the server, be sure to always upgrade agents and agent relays.
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: Beginning in
version 7.0.2, the IBM® UrbanCode® Deploy server and
agent relays require a Java™ Runtime Environment
(JRE) or Java Development Kit (JDK) version
11.
Important: After you upgrade to IBM UrbanCode Deploy version 6.2.2 or later, note these changes to agent relays:
- Users might notice that some agent relays are no longer listed in the user interface even though they were able to view relays before the upgrade. The new version includes updated security controls. The agent relays are still available to the users. However, System Team administrators can assign agent relays to teams and set the View Agent Relays permission for roles so that appropriate users can see the agent relays in the user interface.
- Users can install and use agent relays. However, the relays are not listed in the user interface for the user until a System Team administrator assigns the agent relay to teams and sets the View Agent Relays permission.
Note: If you are upgrading to version 7.0.5.1 or later, the custom JAVA_OPTS properties needs to be
updated in the AGENT_RELAY_INSTALL_DIR\bin\worker-args.conf file. Starting with version 7.0.5.1,
worker-args.conf file holds the JAVA_OPTS properties for WORKER thread.
Upgrade the agent relays as follows: