Upgrade Smart Agent

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

Upgrade Smart Agent Using Agent Management UI

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

Note: 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 custom updates. You can update the following fields:
      Field NamePurpose
      Download SourceSelect the source from where you will download the Smart Agent installation file.
      • Using AppDynamics Portal: Use this if you are using the Downloads portal to install Smart Agent.
      • Using Local Directory: Use this if you are using local directory to install Smart Agent.
      • Custom HTTP URL: Use this if you are using the Custom HTTP server to install Smart Agent. Specify the URL of the server in the Custom HTTP URL field. For example, https://artifactory.custom.url/content/custom-agent/java_agent-X.Y.Z.For basic authentication, Smart Agent communicates with the HTTP sever, such as Nexus, Artifactory, or any custom HTTP server. To configure Basic Authentication for the custom location include the following variables in the [AnsibleConfig].EnvVars section of the Smart Agent config.ini file:
        • ENABLE_CUSTOM_HTTP
        • CUSTOM_HTTP_USERNAME
        • CUSTOM_HTTP_PASSWORD
      Install VersionSpecify the version of Smart Agent that you want to install. For example, 24.10.0.
  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
This updates Smart Agent to the new binary.
Note: 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.

You need to back up some files before the upgrade and add these files after the upgrade.

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.

The following steps are needed to upgrade Smart Agent:
  1. Back up the required files, as stated in the prerequisites.
  2. Uninstall Smart Agent.
  3. Install Smart Agent.
  4. Add the backed up files in the Smart Agent directory.