NOTE: The information in this article is not release-specific. You can reference it for any release.
Before you upgrade your Controller, you’ll want to be familiar with how the new Controller version you’re targeting interacts with the Agents in your environment.
- How does the version compatibility for Controllers and component Agents map to your environment?
- Are there interim versions you need to consider?
- Do you know where to find reference information and instructions so you can upgrade those components successfully?
To make sure you know the steps to follow for a successful release upgrade, we recommend starting with this article and then following the instructions in our upgrade checklists (links available below).
Table of Contents
- Be sure to review
- Product Announcements and Alerts
- Agent-to-Controller Version Compatibility
- Database Agent-to-Controller Version Compatibility
- Other Compatibility Considerations: On-premises, Backward Compatibility
- How do you find your Controller Version?
- Next Steps: Upgrade Checklists for other Components
Be sure to review
Before upgrading any component, we recommend you review available information about version compatibility between the target Controller and all the Agents relevant to your environment:
✓ Product Announcements and Alerts
✓ Version Compatibility Matrices
✓ Compendium of Upgrade Checklist Articles
Product Announcements and Alerts
Review the Product Announcements and Alerts page to discover and understand the details of upgrading any intermediate versions between your current Controller version and the one you’re targeting.
Agent-to-Controller Version Compatibility
Review the Agent-to-Controller and Database Agent-to-Controller compatibility grids just below for various components of the AppDynamics environment.
NOTE: For complete details about component compatibility, see our Community and technical documentation.
NOTE: See the following section for Database Agent-to-Controller Compatibility
| AGENTS | SUPPORTED CONTROLLER VERSIONS | |||
| v4.3 | v4.4 | v4.5 | v20.3 - future releases | |
| Analytics | The Analytics Agent’s version should be less than or equal to the Controller’s version, and it should also be less than or equal to Event Service version |
|||
| Apache Web Server | The Apache Web Server Agent’s version should be less than or equal to the Controller’s version | |||
| Java |
4.x - 4.3 |
4.4.1 - 20.x (1) |
4.5 - 20.x (1) |
4.4 - 20.x (1)(2) |
| JavaScript (ADRUM) |
The JavaScript Agent’s (ADRUM) version should be less than or equal to the EUM Server version |
|||
| Machine |
4.x - 4.3 |
4.4.1 - 20.x (1) |
4.5 - 20.x (1) |
4.4 - 20.x(1)(2) |
| .NET |
4.x - 4.3 |
4.4.1 - 20.x (1) |
4.5 - 20.x (1) |
4.4 - 20.x (1)(2) |
(1) Controller version supports through the most recent released Agent version
(2) Controller version does not support Agent version 4.1
Database Agent-to-Controller Version Compatibility
NOTE: The AppDynamics DB Agent isn’t backward compatible. Its version should be less than or equal to the Controller version.
|
|
Supported Controller Versions |
|||||||
|
Controller Versions |
v4.3 |
v4.4 |
v4.5 |
v20.3 - future releases |
||||
|
DB Agent |
4.1-4.3 (1) |
4.1-4.4 (1) |
4.1-4.5 (1) |
4.1 - 20.x (1)(2) |
||||
(1) Controller version supports through the most recent released Database Agent version
(2) DB Agent is only compatible up to its corresponding Controller version
Other Compatibility Considerations
On-premises Compatibility
Things to keep in mind when you have an on-premises deployment:
- The Controller version should be less than or equal to the EUM Server version, and should also be less than or equal to Events Service version
- The EUM Server version should be less than or equal to the Events Service version
- The Java Script Agent version should be less than or equal to the EUM Server's version
Agent Backward Compatibility
Starting with release v.4.5x, backward compatibility is supported on the following Agents:
- Java
- .NET
- Node.js
- PHP
- Python
- Go SDK
- C/C++
How do you determine your Controller version?
- On your Controller’s Home page, click the Settings gear on the upper right. Then click About AppDynamics just above the logout option.
Home > Overview > Settings > then click About AppDynamics
- A dialog box with the Controller’s current version and build will appear
"About AppDynamics” dialog box, headed by the Controller version and build
Next Steps: Checklists for upgrading each component
After following the recommendations in this article, refer to the relevant upgrade checklists for each type of AppDynamics component:
NOTE: These guides are not release-specific and can be referenced for any release.
- Upgrading Platform Components
- Upgrading Machine Agents
- Upgrading Java Agents
- Upgrading .NET Agents
- Upgrading Dynamic Language Agents
- Upgrading Analytics Agents
- Upgrading Database Agents
- Upgrading EUM Servers, Agents, and SDKs
Last Updated: 7/20/20
