You may need to upgrade one component in order to get a bug fix, but want to know how the upgrade will impact your entire environment and reporting before doing so.
Review the compatibility matrix below for various components of the AppDynamics environment.
Apache Web Server Agent version <= Controller version
Application Agent version(Java, .Net, Node.js Agent etc) <= Analytics Agent version
For Controller versions lower than 4.4.1: Application (language) Agent version (Java, .Net, Node.js Agent, etc.) <= Controller version
*For Controller versions 4.4.1 or higher: Application (language) Agent version (Java, .Net, Node.js Agent, etc.) unrestricted
Analytics Agent version <= Controller version
Analytics Agent version <= Events Service version
Controller version <= EUM Server version
Controller version <= Events Service version
DB Agent version <= Controller version
EUM version <= Events Service version
Mobile Agent version: To determine the minimum versions of the Controller and EUM Serverrequired for supporting the latest features of the Mobile Agents, see the Mobile Agent Version and Deployment Support Matrix
Machine Agent v4.5.2+ is compatible with Controller v4.4.0+
Machine Agent v4.5.0 - 4.5.1 is compatible with Controller v4.5.0 - 4.5.x
Machine Agent v4.4.0 - 4.4.3 is compatible with Controller v4.4.0 - 4.4.3
Machine Agent v4.3.x, 4.4.x, and 4.5.x is compatible with Controller v4.5.x
*Backward compatibility is supported on the following agents starting in Release 4.5:
If you are upgrading your iOS Agent to the latest version, check that you are using at least the recommended minimum Controller and EUM Server versions so all features for that agent version will function correctly and there will be no unexpected side effects.
If you update your Controller and EUM Server, you should plan to upgrade the Events Service to ensure that the Events Service version is higher than or equal to the EUM Server and Controller version.
Although we encourage you to keep your environment components in compatible versions as stated above, in some cases, the components can still be compatible if they vary within just the patch version.
The process for the other Mobile Agents should be similar, but please refer to the Mobile Agent Version and Deployment Support Matrix for version specifications.
Last Updated: 3/15/19