How do I get started with upgrading Analytics Agents?

[Nina.Wolinsky]

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

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

Table of Contents

• Prepare to upgrade your Analytics Agent
• Plan your Analytics Agent upgrade
• Troubleshooting
• Additional Resources

Prepare to upgrade your Analytics Agent

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.

Plan your Analytics Agent upgrade

• The Analytics Agent, Events Service and Controller versions should be compatible:
  • The Analytics Agent version should be older or equal to the Events Service version.
  • The Analytics Agent version should be older than or equal to the Controller Server version.
    

• Be sure to maintain copies of:
  • controller.xml file 
  • analytics-agent.properties
  • job directory
  • watermark folder

• See the  Upgrade Analytics Agent documentation for step-by-step instructions.

• If you’re running the Analytics Agent through the Machine Agent, see Upgrade the Machine Agent for instructions.

Troubleshooting

In the event of an error state, follow the troubleshooting steps outlined in the Troubleshooting Analytics Issues documentation.

Additional Resources

Instructions for upgrading other AppDynamics components are available in our general release upgrade checklist, How do I get started with upgrading App Dynamics components for any release?