Update the .NET agent

Installing the .NET agent requires Administrator rights in your Windows admin group. For more information, see the permissions documentation for the .NET Framework agent or .NET Core 2.0 agent.

Follow these instructions to update your agent.

Verify your agent version

  1. Refer to the release notes to find the latest version of the agent.
  2. Verify which version of the .NET agent you currently have installed by using Windows Programs and Features or by using your Linux package manager.
  3. To finish the update, follow the instructions for your agent:

If your app uses a particularly old agent version, see Upgrading legacy .NET agents.

Update the .NET Framework agent

Use one of the following methods to update to the latest version of New Relic's .NET Framework agent:

Scriptable installer

You can update the .NET Framework agent on Windows using a scriptable installer.

Standard install

Instrumenting applications running on .NET Framework version 4.0 and below requires a .NET agent version lower than 7.0. See Technical support for .NET frameworks 4.0 or earlier for more information and download instructions.

  1. Ensure that you have .NET 4.5 and higher installed on your system.
  2. Stop IIS.
  3. Download and run the appropriate install package for your architecture:

  4. After the installer package finishes, start IIS.

Update the .NET Core 2.0 agent

Use one of the following methods to update to the latest version of New Relic's .NET Core 2.0 agent:

Scriptable installer
You can update the .NET Core 2.0 agent on Windows using a scriptable installer.
zip, tar.gz, deb file
  1. Shut down your application(s).
  2. Download and run the appropriate install file for your architecture from the download site.

  3. Extract the downloaded zip file on top of the existing files.
  4. Restart your application(s).
yum (CentOS, Oracle Linux, or RHEL)
  1. Shut down your application(s).
  2. Use the following to update the agent:
    sudo yum update newrelic-netcore20-agent
apt (Debian, Linux Mint, or Ubuntu)
  1. Shut down your application(s).
  2. Use the following to get a list of available updates and install them:
    sudo apt-get update && sudo apt-get install --only-upgrade newrelic-netcore20-agent
rpm (CentOS, Oracle Linux, or RHEL)
  1. Shut down your application(s).
  2. Download and run the appropriate rpm file for your architecture from the download site.

  3. Use the following to update the agent:
    sudo rpm -Uvh FILE_NAME.rpm

Update older .NET agents

If you are upgrading from an older .NET Framework agent version, review major changes that may affect your app installation.

For more help

Recommendations for learning more: