Knowledge Base

Showing results for 
Search instead for 
Did you mean: 

Release Upgrade Checklist for Machine Agents

To make sure you complete all the tasks necessary for upgrading your Machine Agents after a release, we recommend following the instructions in our upgrade checklist. This guide is not release-specific and can be referenced for any release.



  1. Review the Product Announcements and Alerts page for details on any intermediate versions between the current version of your instance and the version you are targeting.

  2. Review the compatibility matrix in our Community and technical documentation for various components of the AppDynamics environment.


Upgrading Machine Agents  

  1. Review the Machine Agent and Controller version compatability information below:
    Machine agent 4.5.2+
     is compatible with Controller 4.4.0+
    Machine agent 4.5.0 - 4.5.1 is compatible with Controller 4.5.0 - 4.5.x
    Machine agent 4.4.0 - 4.4.3 is compatible with Controller 4.4.0 - 4.4.3
    Machine agent 4.3.x, 4.4.x, and 4.5.x is compatible with Controller 4.5.x

  2. Review the list of Machine Agent supported environments and versions to ensure compatibility between your Machine Agents and JDK. For example, 4.0.x is the latest version that can run on JDK 1.5 and higher and any version from 4.1.x and higher needs JDK 1.7 or higher.

Tip! Back up the <machine_agent_home> directory to a <machine_agent_home_BACKUP> in case you need to revert to the previous installation.

  1. See Upgrading the Machine Agent for step-by-step instructions.

  2. In the event of a failure, uninstall the new version and reinstall the previous version of the Machine Agent.


Instructions for upgrading other AppDynamics components are available in our general Release Upgrade Checklist.

Version history
Revision #:
16 of 16
Last update:
‎07-01-2020 03:45 PM
Updated by:
Labels (1)

Found this article helpful? Click the Thumbs Up button.
Have an additional comment? Post it below.
0 Kudos

Found this article helpful? Click the Thumbs Up button.
Have an additional comment? Post it below.