Knowledge Base

Showing results for 
Search instead for 
Did you mean: 

Release Upgrade Checklist for .NET Agents

To make sure you complete all the tasks necessary for upgrading your .NET Agents after a release, we recommend following the instructions in our upgrade checklist. This guide is not release-specific and can be referenced for any release.



  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.


Upgrading .NET Agents

  1. Starting in release 4.5, .NET agents are automatically backward-compatible with any 4.4.1+ Controller, so you can upgrade your agent while retaining your 4.4.1+ Controller. If your Controller is older than 4.4.1, you must upgrade your Controller before upgrading your .NET agent. Review the Agent/Controller compatibility matrix for compatibility mappings between agents and Controller versions.
  2. Tip! Use the decision matrix to determine which NuGet and distribution package is needed for your particular platform and applications when deploying .NET Agents.
  3. Tip! Upgrade agents first on downstream tiers and then on upstream tiers to ensure a successful correlation.
  4. Tip! If you are upgrading multiple agents in your monitored environment, upgrade the agents for the tiers on which business transactions are originated last.
  5. See Upgrade the .NET Agent for step-by-step instructions.
  6. If the agent installation fails, this may be due to the configurations in your environment. Follow the Checklist for Resolving .NET Agent Installation Issues to address potential issues. If necessary, uninstall the new version and reinstall the older version.
  7. See Upgrade AppDynamics.Windows Azure NuGet Package if you are using the AppDynamics.WindowsAzure NuGet package to monitor your Azure solutions.
  8. See Upgrade your AppDynamics Azure Site Extension for .NET for instructions for both minor and major releases. 


Instructions for upgrading other AppDynamics components are available in our general Release Upgrade Checklist

Version history
Revision #:
11 of 11
Last update:
‎02-20-2019 11:00 AM
Updated by:
Labels (1)

Found this article helpful? Click the Thumbs Up button.
Have an additional comment? Post it below.
0 Kudos

Found this article helpful? Click the Thumbs Up button.
Have an additional comment? Post it below.