AppDynamics switched from Semantic Versioning to Calendar Versioning starting in February 2020 for some agents and March 2020 for the entire product suite.


    Skip to end of metadata
    Go to start of metadata

    You are viewing an old version of this page. View the current version.

    Compare with Current View Page History

    « Previous Version 45 Next »

    This page provides an overview of compatibility mapping between Agent and Controller versions. 

    About Agent and Controller Compatibility

    Please refer to the Language Agent Backward Compatibility table below for AppDynamics Agents and AppDynamics Controller compatibility. 

    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, the oldest agents should be on originating tiers of any business transactions. This ensures that agents on downstream nodes can process the correlation header created by the originating tier.

    It's 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.

    Language Agent Backward Compatibility

    Starting in release 4.5, AppDynamics language agents are backward-compatible with any 4.4.1 or later Controller. This enables you to upgrade your language agents – and take advantage of the latest agent-side enhancements, features, and bug fixes – without upgrading your 4.4 Controller. The following table outlines the Controller and language agent releases that are compatible.

    Starting in 20.2, the AppDynamics language agents are backward-compatible with any 4.5.0 or later Controller, including Controllers using Calendar Versioning from 20.3 and higher.

    Controller ReleaseLanguage Agent ReleaseNotes
    20.3.x+4.4+, 20.2.x+, 20.3.x+20.3.x Controllers can accept connections from 4.4+ agents as well as 20.2.x+ and 20.3.x+ agents that use Calendar Versioning.
    4.5.x4.1+, 20.2.x+, 20.3.x+4.5.x Controller can accept connections from 4.1+ agents, including agents that use Calendar Versioning.
    4.4.1+4.1+4.4.1 and newer Controllers can accept connections from newer agents.
    4.3.x4.1.x – 4.3.x4.3.x Controllers cannot accept connections from newer agents.
    4.2.x4.1.x – 4.2.xAgents older than 4.3 are no longer supported, and agents older than 4.1 are no longer guaranteed to connect to a Controller.

    The above table is only a reference for general software compatibility. For specific maintenance and support terms, please refer to your specific EULA.

    Backward compatibility is supported on the following agents starting in Release 4.5:

    • C/C++ 
    • Cluster
    • Go SDK
    • Java
    • Machine
    • .NET
    • Node.js
    • PHP
    • Python

    While using the Enterprise Console to upgrade the Controller, several folders (including the appagent folder) are removed and reinstalled. If you deployed a Java agent with a newer version than the Controller in the controller/appserver/glassfish/domains/domain1/appagent folder, the upgrade will fail and internal monitoring will be lost. To prevent this, you must update the domain.xml file to point to the new Java agent or avoid using customized installation for Java agents.

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

    Agent Versions Supported by Controller Version 4.5.x

    Agent Version/
    Agent Type
    Languages AgentsCluster AgentDatabase AgentAppDynamics for DatabasesMachine AgentNetwork Agent
    Java Agent.NET AgentNode.js AgentPHP AgentPython AgentWeb Server AgentC / C++ Agent (SDK)
    20.x+




    4.5.x


    4.4.x


    4.3.x



    The ability to customize Business Transaction detection, supported by .NET Agent for Linux version 4.5.9, requires Controller versions 4.5.2 and higher. The .NET Agent version 4.5.9 works with Controller version 4.4.1 and higher, but the customizable transaction detection and configuration capabilities require 4.5.2 and later versions of the Controller. See .NET Agent for Linux Business Transaction Configuration.


    SSL Compatibility between Java Agent and Controller

    The default protocol used by the Controller is TLSv1.2. See Secure the Platform for information on changing the default security protocol used by the Controller or agent. 

    For the Java Agent, the default protocols are:

    • For Java 8 SE applications: TLSv1.2.
    • For Java 7+ applications: TLSv1.2.

    SSLv3 has been disabled for SaaS Controllers because of the CVE-2014-3566 vulnerability. SSLv3 connections are no longer supported.

    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.5) and <minor_release_number> Updates sections for minor releases in the Release Notes.

    • No labels