Upgrade the .NET Library

The most recent .NET Library version and release date is   . See the .NET Library release notes for details of the recent changes to the library.

Upgrading IIS Only instrumentation

These steps document how to upgrade the .NET APM Library when only IIS instrumentation has been enabled, the components Instrument IIS .NET Framework and/or Instrument IIS .NET applications were selected in the previous installation of the .NET APM Library.

1. Run iisreset /STOP to stop IIS.
2. Run the uninstaller: %PROGRAMFILES%\SolarWinds\APM\dotnet\unins000.exe The uninstaller filename has the format unins<nnn>.exe where nnn will increment on reinstalls.
3. Download the latest .NET Library from https://agent-binaries.cloud.solarwinds.com/apm/dotnet/latest/SolarWindsAPM_DotNetAgent_Setup.exe.
4. Run the new installer.
5. Run iisreset /START to start IIS.

Upgrading IIS and non-IIS instrumentation

These steps document how to upgrade the .NET APM Library when both IIS and non-IIS services are being instrumented.

1. Run iisreset /STOP to stop IIS.
2. Stop services that have been enabled with instrumentation. Those services will either be configured in the applications section of the solarwinds_apm.config file, or were enabled for instrumentation by setting the necessary environment variables.
3. Run the uninstaller: %PROGRAMFILES%\SolarWinds\APM\dotnet\unins000.exe.
4. Download the latest .NET Library from https://agent-binaries.cloud.solarwinds.com/apm/dotnet/latest/SolarWindsAPM_DotNetAgent_Setup.exe.
5. Run the new .NET Library installer.
6. Run iisreset /START to start IIS.
7. Restart any services stopped in Step 2.

SolarWindsAPM.Agent NuGet package

The SolarWindsAPM.Agent NuGet package provides automatic instrumentation support. See SolarWindsAPM.Agent NuGet package.

Azure App Services

Starting with the 6.3.0 release, a new Azure site extension was released, SolarWindsAPM .NET OpenTelemetry Agent Azure AppServices Extension. It replaces the previous SolarWindsAPM .NET Agent Azure AppServices Extension.

To upgrade to the SolarWindsAPM .NET OpenTelemetry Agent Azure App Service Extension:

1. Stop the Azure App Service.

2. Save the solarwinds_apm.config file if any changes were made to it.

3. In the Azure Web App, in the Development Tools section, click Extensions.

4. Select the SolarWindsAPM .NET Agent Azure AppServices Site Extension, and click the Delete button.

5. Click the Add button and select the SolarWindsAPM .NET OpenTelemetry Agent Azure AppServices Extension from the list.

6. Update the App Service environment variables, see the SolarWinds Observability | Install the .NET Library on Azure App Service documentation for the updated environment variable values.

7. Update the solarwinds_apm.config file, located at C:\home\SiteExtensions\SolarWindsAPM.OpenTelemetry.Agent.AzureAppServices.Extension\SolarWindsAPM with any changes that had been made to the solarwinds_apm.config file copied in Step 2.

8. Start the Azure App Service.