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. 

Prerequisites for Upgrading Java or Machine Agent with Existing Agent Configurations

These are the requirements for upgrading Java Agent or Machine Agent along with the modified or additional configuration updates:

This is required only if you want to retain any previous manual configurations to any files. The controller-info.xml configuration 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. 

Upgrade the Required Agents using Smart Agent

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

You must stop all the extension processes before upgrading Machine Agent.

 

  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 Authentication for Custom Artifact Location.
    3. Retain the same configuration or edit it as required.
      The attributes are displayed based on the selected agent.
      • By default, Smart Agent reuses the previous Controller configuration details. However, if you specify a new configuration in the controller-info.xml file, 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.
  5. 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.