Upgrading agents remotely
You can upgrade agents that have a status of Upgrade Recommended or Upgrade Required by using the Upgrade action.
Before you begin
- To ensure compatibility and optimal performance, run the same version of the HCL Launch server and agents. Server and agents of different versions may result in unexpected behavior. In such case, you must update or roll back the server and agents so that they run the same versions.
- You must upgrade the server before you upgrade the agents.
About this task
- When an agent has the Upgrade Required status. Such agents cannot run deployments until they are upgraded. This status might occur if a change is made to server-agent communications.
- When an agent has the Upgrade Recommended status. It might occur after a performance enhancement. An agent with the status Upgrade Recommended can run deployments, but for best performance, upgrade the agent.
- To improve the HCL Launch security by using a TLS protocol. Some older agents are only compatible with SSLv3. SSLv3 is dynamically enabled if necessary. See Supported TLS and SSL protocols and ciphers.
-
Upgrade agents and agent relays in addition to upgrading the server.
You can upgrade agents individually or in a batch. To upgrade agents:
Procedure
-
Click
. The Agents pane lists agents and their status.
- Select the check boxes for the agents to upgrade.
-
Click (
)
Upgraded agents are taken offline while the upgrade is applied and have the Offline status. If the upgrade finishes, the agents are automatically restarted and have the Online status. If the agents do not come back online, check their logs for error messages.Note:Updating many agents simultaneously can have a significant affect the server. As a rule-of-thumb, limit the number of simultaneous upgrades to 10 or fewer.