Knowledge Base

Showing results for 
Search instead for 
Did you mean: 

How do I get started with upgrading platform components?

A complete checklist for upgrading platform components


NOTE: The information in this article is not release-specific. You can reference it for any release.

To make sure you complete all the tasks necessary for upgrading platform components after a release, we recommend following the upgrade checklist instructions below. 


Table of Contents


Prepare to upgrade your platform components

  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 either of the following to confirm the compatibility of the various components of the AppDynamics environment:


Plan your platform component upgrade

Before upgrading to a newer version of the platform, complete the tasks outlined in the Update Product Components documentation.

To ensure all data is transferred properly, perform your upgrades in the specific recommended order for the components you’re using:


Step 1. Upgrade the Enterprise Console

Review the Upgrade the Enterprise Console documentation first.


To determine the requirements, review the Controller system requirements and increase your hardware resources if necessary.


Step 2. Upgrade the Events Service

Do I need a single node install or a manual upgrade?

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, see the End-User Monitoring Connection Settings documentation.


Note: Even though the Enterprise Console will set and sync the keys between the Controller and Events Service, we still recommend confirming that the keys were synced correctly:

appdynamics.on.premise.event.service.key == ad.accountmanager.key.controller

Note: If you're upgrading the Events Service using the Enterprise Console, you don't need to stop the Events Service.


Complete the Events Service upgrade

Follow the Upgrade the Events Service documentation to complete the Events Service upgrade.


Step 3. Upgrade the EUM Server

See Upgrade the EUM Server for instructions on upgrading an EUM Server.


Step 4. Back up the Controller

Complete a full backup of the Controller. Reference Back up the Existing Controller for instructions.


Step 5. Upgrade the Controller with the Enterprise Console

Final Upgrade Considerations

Before completing the upgrade process, review the following and implement as appropriate:

Upgrading an HA Pair

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. 


It is also possible to use GUI or the old CLI method to upgrade your HA pair, but we recommend the Phased Upgrade Method.

Upgrading from a small to an extra-large deployment

You can directly upgrade from small/demo deployments to large/extra large deployments. See the Tuning for Large Profile Controller documentation for instructions on preparing a large deployment.

Be sure to check the Controller’s database.log

Check the Controller&rs 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.


Upgrade the Controller with the Enterprise Console

Once you’ve completed preceding steps and considerations, refer to the Upgrade the Controller using the Enterprise Console documentation to perform and complete the upgrade.



In the event of a failure, follow the troubleshooting steps in the  Troubleshoot the Upgrade documentation.


In the event of a failure when upgrading a platform component, please contact AppDynamics Support.


Additional Resources

How do I get started with upgrading AppDynamics components for any release?

Version history
Revision #:
17 of 17
Last update:
‎10-09-2020 03:18 PM
Updated by:
Labels (1)

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