From Smart Agent 24.7 onwards, you can upgrade Smart Agent by using the Agent Management user interface. 

Before You Begin

You must install the following packages to upgrade Smart Agent:

  • bzip2
  • jq
  • pip3

Upgrade Smart Agent Using Agent Management UI

To upgrade Smart Agent perform the following on the Agent Management UI:

These steps are applicable if you have used the root credentials to install Smart Agent.


  1. Click the Smart Agents tab.
  2. Select the Smart Agent that you require to upgrade.
  3. Click Upgrade.
  4. Select the required upgrade type.
    • Default Upgrade: This upgrades the Smart Agent to the latest version with the existing configuration.
      You can select the Smart Agent version from the Available Versions list. 

    • Custom Upgrade: This upgrades the Smart Agent with the custom updates. However, this is currently unsupported.

      Currently, Smart Agent supports only Default Upgrade.

      You can update the following fields:

  5. Click Upgrade Now.
  6. (For Linux) Check for the success status from the History tab, then run the following commands on the host machine:
    sudo systemctl restart smartagent
sudo systemctl daemon-reload
sudo systemctl restart smartagent
    CODE

This updates Smart Agent to the new binary. 

For Windows, you do not require to restart Smart Agent. However, ensure that you check the success status from the log files at <smartagent-dir>/upgrade-log.log.

Upgrade Smart Agent Manually

You can upgrade the Smart Agent manually by uninstalling and reinstalling it.

Before You Begin

  • You must install the following packages to upgrade Smart Agent:
    • bzip2
    • jq
    • pip3
  • Back up the following files and add these files in the Smart Agent directory after the upgrade.

    • <smartagent-hostname>/config.ini - This is required to keep the same Smart Agent config.ini configuration.

    • <smartagent-hostname>/id - This is required to use the same Smart Agent ID after the upgrade.

    • <smartagent-hostname>/lib/ld_preload.json - This is required to auto attach supported agents to the process.

    • <smartagent-hostname>/store.yaml - This is required to track all the packages that were installed using Smart Agent.

    • <smartagent-hostname>/.process.json - If this file does not exist, you can ignore this file. This is required to keep the Machine Agent process alive.

Upgrade the Smart Agent

The following steps are needed to upgrade Smart Agent:

  1. Uninstall Smart Agent
  2. Install Smart Agent