You can upgrade multiple agents of the same type. Under App Agents or Machine Agents, select the required agent type that you want to upgrade. 

  • It is recommended to upgrade to the latest version.  Also, refer to the agent specific documentation to meet all the prerequisites before performing an upgrade.
  • For Machine Agent, stop all the extension processes before starting the upgrade.

  1. Click Check for Updates to view the available upgrades.

    You can upgrade the agents without Internet. If there is no Internet, the Controller UI displays No access to Download Portal .

    However, Agent Management checks the cache data to display the agent status. Click Refresh to fetch the agent builds and refresh the cache if the last updated time is more than 24 hours.

  2. Select the agent(s) that you want to upgrade, then click Upgrade.

  3. Select one of the following options:
    • Default Upgrade: to use the latest version with the default configuration.
    • Custom Upgrade: to specify the version and change other settings.
  4. For Custom Upgrade:
    1. Select the version that you want to upgrade in Available Versions.
    2. Select the source from where you are downloading the agent.
    3. Retain the same configuration or edit it as required.
      The attributes are displayed based on the selected agent.
  5. (Optional) You can use the agent specific custom configurations to specify in Custom Configuration. For the list of keys that you can use, see the agent variables table in the agent specific pages under Ansible. 
  6. Check the upgrade status in Tasks in Progress.
    You can search for the specific host and check the log file. After the task is completed it is added to the History tab.