Upgrade Agents

These are the prerequisites for Upgrading Agents

  • You require to upgrade agents to the latest version. Also, refer to the agent specific documentation to meet all the prerequisites before performing an upgrade.

  • If you are upgrading Machine Agent, ensure to stop all the extension processes before you start the upgrade.

  • Ensure the following if you are upgrading Java or Machine Agent with the existing modified or additional configuration updates:

    Note: This is required only if you want to retain any previous manual configurations to any files. The controller-info.xmlconfiguration is retained even if <agent-type>.zip does not exist
    • Ensure that the temp directory is four times the size of the agent download file size.
    • Do not modify the <agent-type>.zip file that is present under the current agent directory.
    • The current directory size should be three times the size of the <agent-type>.zip file.
    • (For already installed Java Agent with the Smart Agent version 25.2 or lower) Manual update of the <agent-type>.zip file is required because there is no zip file available in the directory. Therefore, download the <agent>.zip file from the downloads portal and place it under the agent directory with the name <agent-type>.zip. For example, java.zip or machine.zip.
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.
Note: The selected agent is upgraded in the same folder (or directory) where it was originally installed.
  1. Select the agent(s) of the same type that you want to upgrade, then click Upgrade.
  2. 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.
  3. 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.
      The source can be the AppDynamics download portal (Using AppDynamics Portal), your local directory (Using Local Directory), or your custom HTTP server (Custom HTTP URL). If you select Custom HTTP URL and if your HTTP server requires authentication, configure smart agent to use basic authentication. See Configure Basic Authentication for Custom Artifactory Location.
    3. Retain the same configuration or edit it as required. The attributes are displayed based on the selected agent.
      Note:

      • By default, Smart Agent reuses the previous configuration details. However, if you specify a new configuration, it takes precedence over the old configuration. If the configuration is not specified, Smart Agent uses the default value defined in the JSON file.

      • If you modify any existing file or add any new file, those files are retained after the upgrade. However, this requires the <agent>.zip file to be available in the Smart Agent directory.

  4. Optional: You can use the agent specific custom configurations to specify in Custom Configuration. For the list of keys that you can use, see Custom Configuration.
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.