Related pages:

This page describes how to upgrade the .NET Agent for Linux on VMs such as Docker and on hardware running Linux.

Upgrading the .NET Agent for Linux updates the agent files and maintains legacy configurations.

Requirements

  • Before you begin, review the Release Notes for changes that affect your environment.

  • AppDynamics requires an account access key for agent connections to single-tenant Controller accounts. Versions of AppDynamics before 4.1 only required an account access key for multi-tenant Controller accounts.

    Single-tenant Controller customers can find the account access key in the Controller under Settings > License > Account. 

    You must be a member of a role with the View License account level permission, see Create and Manage Custom Roles.

Binaries Overview

After downloading the agent binaries, you will need to extract them from the zip file into the desired folder.

The archive contains the following files: 

  • AppDynamics.Agent.netstandard.dll
  • AppDynamicsConfig.json.template
  • libappdprofiler.so
  • README.md

Upgrade the .NET Agent for Linux

  1. Download and unzip the .NET Agent for Linux installation package, AppDynamics-DotNetCore-linux-x64-4.5.x.x.zip to a temporary directory.

  2. Replace the existing agent binaries with their latest versions. The files you need to replace are: 

    • libappdprofiler.so 

    • AppDynamics.Agent.netstandard.dll

  3. Restart your application, or rebuild and then run your container image with the new versions of the agent binaries.

AppDynamics recommends that you include the new agent binaries into your Continuous Integration/Continuous Delivery (CI/CD) pipeline.