Knowledge Base

Showing results for 
Search instead for 
Did you mean: 

Release Upgrade Checklist for Platform Components

To make sure you complete all the tasks necessary for upgrading platform components after a release, we recommend following the instructions in our upgrade checklist below. 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 Platform Components

  1. Before upgrading to a newer version of the platform, complete the tasks outlined here.
  2. Depending on the components you are using, you should perform the upgrades in a specific order to ensure all data is transferred properly:
    1. Step 1: Upgrade the Enterprise Console
      1. Review the Controller system requirements and increase your hardware resources if necessary.
      2. The Enterprise Console supports the installation of the Events Service on a Windows environment for a single node install. If you have several remote nodes, you will need to do a manual upgrade of the Events Service cluster and set the keys manually. For instructions on connecting to the Events Service, click here.

      3. Tip! The Enterprise Console will set and sync the keys between the Controller and Events Service, but we recommend confirming that the keys were synced correctly: appdynamics.on.premise.event.service.key == ad.accountmanager.key.controller
      4. Tip! If you are upgrading the Events Service using the Enterprise Console, you do not need to stop the Events Service.
    2. Step 2: Upgrade the Events Service
    3. Step 3: Upgrade the EUM Server
    4. Step 4: Complete a full backup of the Controller
    5. Step 5: Upgrade the Controller using the Enterprise Console
      1. Tip! If you are upgrading an HA pair, we recommend upgrading via CLI using the Phased Upgrade Method (new in v4.5.6). This allows you to retain the HA roles of the Controllers so that the primary and secondary roles do not switch after upgrade and you can check the status of your primary Controller before upgrading the secondary. If you encounter any issues during or post-upgrade, you can roll back by promoting and failing over to the preserved, secondary Controller. You may also use GUI or the old CLI method to upgrade your HA pair, but we recommend the Phased Upgrade Method.
      2. Tip! You can directly upgrade from small/demo deployments to large/extra large deployments. For instructions on preparing a large deployment, see Tuning for Large Profile Controller.
      3. Tip! As part of our improvements around SAML 2.0 authentication in the v4.5 release, our SAML implementation requires a NameID assertion for Microsoft Active Directory Federation Services (ADFS)If you use ADFS SAML, add the NameID as the Outgoing Claim Type in your claim rule before upgrading your Controller. Click here for instructions.
      4. Tip! Check the Controller’s database.log for any errors during this process. You can find the log at <controller_home>/db/logs/database.log. There should not be any InnoDB: Error lines in the log from the last startup. If any errors are found, contact AppDynamics Support before attempting the upgrade. Upgrading the Controller with a corrupt database may put the Controller in a bad state with a high recovery time.
      5. Note: In the event of a failure, follow the troubleshooting steps here: Troubleshoot the Upgrade
  3. In the event of a failure when upgrading a platform component, please contact AppDynamics Support.


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

Version history
Revision #:
10 of 10
Last update:
‎02-25-2019 01:19 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.