Knowledge Base

cancel
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.

 

Preparation

  1. Review the Produce 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, perform the upgrades in a specific order to ensure all data is transferred properly:
    1. Step 1: Upgrade the Enterprise Console
      1. Note: Review the Controller system requirements and increase your hardware resources if necessary.
      2. Note: 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! 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.
      2. 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.
      3. 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

0 Kudos