This page applies to an earlier version of the AppDynamics App IQ Platform.
For documentation on the latest version, see the 4.4 Documentation.


On this page:

 

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
51 rates

AppDynamics agents are not backwards compatible with the AppDynamics Controller. The Controller version must be equal to or greater than the versions of any agents connecting to it. This page describes compatibility mappings between the Controller and older versions of the agents. 

A monitored environment may have agents of different versions deployed in it at a given time, as long as all agents are compatible with the Controller version. However, in this environment the oldest agents should be on the originating tiers of any business transactions. This ensures that agents on downstream nodes can process the correlation header created by the originating tier. This is an important point to consider when rolling out agent upgrades: be sure to start upgrading the agents on the nodes of downstream tiers first, and then upgrade the agents on the originating tier nodes last.

Java Agent - Controller Compatibility

The Controller supports older agents. Prior to 3.6.2, newer agents will not work with an older Controller. 3.6.2 and newer agents will work with the Controller that has the same major and minor version (X.x). 

The 4.1.x Controller supports the following versions of the Java Agent:

  • 4.1.x
  • 4.0.x
  • 3.9.x
  • 3.8.x
  • 3.7.x

For the notes on SSL protocol compatibility between versions of the agent and Controller, see SSL Compatibility Matrix for App Agent for Java - Controller

.NET Agent - Controller Compatibility 

The Controller supports older Agents. Prior to 3.6.2, newer agents will not work with an older Controller. 3.6.2 and newer agents will work with the Controller that has the same major and minor version (X.x).

The 4.1.x Controller supports the following versions of the App Agent for .NET:

  • 4.1.x
  • 4.0.x
  • 3.9.x
  • 3.8.x
  • 3.7.x

PHP Agent - Controller Compatibility

The 4.1.x Controller supports the following versions of the PHP Agent:

  • 4.1.x
  • 4.0.x
  • 3.9.x
  • 3.8.x
  • 3.7.7 and newer 3.7.x

Node.js Agent - Controller Compatibility

The 4.1.x Controller supports the following versions of the Node.js Agent:

  • 4.1.x
  • 4.0.x
  • 3.9.x
  • 3.8.5 +

Python Agent - Controller Compatibility

The 4.1 Controller support the following versions of the Python Agent:

  • 4.1.x
  • 4.0.x

Web Server Agent - Controller Compatibility

The 4.1.x Controller supports the following versions of the Web Server Agent:

  • 4.1.x

Database Agent - Controller Compatibility

The 4.1.x Controller supports version 4.0.3 and higher of the Database Agent.

AppDynamics for Databases - Controller Compatibility

The 4.1.x Controller supports the following versions of AppDynamics for Databases:

  • 2.7.4 and higher

Note: AppDynamics for Databases version 2.7.4 is required for AppDynamics for Databases to correlate with the App Agent for PHP.

Standalone Machine Agent - Controller Compatibility

The Controller supports older agents. Prior to 3.6.2, newer agents will not work with an older Controller. 3.6.2 and newer agents will work with the Controller that has the same major and minor version (X.x). 

The 4.1.x Controller supports the following versions of the Standalone Machine Agent:

  • 4.1.x
  • 4.0.x
  • 3.9.x
  • 3.8.x
  • 3.7.x

SSL Compatibility between Java Agent and Controller

The default protocol used by the Controller and Java Agent are:  

  • Controller: TLSv1.2 
  • Java Agent:
    • For Java 8 SE applications, TLSv1.2.
    • For Java 7+ applications, TLSv1.2. You can change the agent to use SSLv3 if desire. See Security for information on changing the default security protocol used by the Controller or agent. 
    • For Java 5/6 applications, SSLv3. You must enable SSLv3 connection on the Controller if the agents connect directly to the Controller. See Security for information on changing the default security protocol used by the Controller or agent. 

The default SSL protocols for the Controller and agent changed in 3.8.x. See Agent - Controller Compatibility Matrix in the 3.8 documentation for SSL compatibility information for previous versions. 

Requirements for Connecting with a 4.1 Single-Tenant On-Premise Controller

The AppDynamics access key is now required in the configuration of 4.1+ agents to access single-tenant controllers. See the release note for details on how this impacts various controller-agent version combinations.

Introduction of New Agent Features

Even when new and old agents are supported by the same up-to-date Controller, new functionality introduced by later agents is not available on the older agents.

Information about when an agent feature was introduced is documented in the New and Enhanced Features section for a new major release (such as 4.0) and <minor_release_number> Updates sections for minor releases in the release notes. So, for example, support for percentile metrics was introduced for the .NET agent in 4.0; this is documented in the .NET Agent Updates section under New and Enhanced Features in 4.0 in the Platform Release Notes. The addition of the new agent features in the 4.0 agent will be documented under 4.x Updates in the Platform Release Notes.

 

  • No labels