Upgrading the .NET Agent

AppOptics agents are no longer receiving updates. The new SolarWinds Observability Libraries can send APM data to AppOptics and are regularly updated with new features and improvements. If your components are supported by the new libraries, consider transitioning to the SolarWinds Observability Libraries for your APM needs. Alternatively, you can also consider using SolarWinds Observability as your primary APM monitoring solution.

Upgrading to the SolarWinds Observability .NET Library

The .NET Instrumentation Library for SolarWinds Observability is compatible with the AppOptics collector. SolarWinds Observability libraries are not compatible with AppOptics agents. Do not use a mix of SolarWinds Observability libraries and AppOptics agents to instrument applications that are part of a distributed trace.

To upgrade to the SolarWinds Observability .NET Library, uninstall the AppOptics .NET Agent and follow the rest of the steps described in Migrate the .NET Library from AppOptics to SolarWinds Observability. Before restarting the application, make the following additional configuration changes to have the SolarWinds Observability .NET Library continue sending data to AppOptics:

• Set a valid AppOptics service key. See the SolarWinds Observability configuration options for the new configuration file and environment variable names.
• Set the collector configuration to the AppOptics endpoint collector.appoptics.com:443.

Upgrade to a newer version of the legacy AppOptics Agent

Upgrading IIS Only instrumentation

1. Run iisreset /STOP to stop IIS
2. Run the uninstaller: C:\Program Files\AppOptics\APM\dotnet\unins000.exe The uninstaller filename has the format unins<nnn>.exe where nnn will increment on reinstalls.
3. Download the latest .NET Agent from https://files.appoptics.com/dotnet/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 agent when both IIS and non-IIS services are being instrumented.

1. Run iisreset /STOP to stop IIS
2. Stop services configured in the applications section of the agent.config file
3. Run the uninstaller: C:\Program Files\AppOptics\APM\dotnet\unins000.exe
4. Download the latest .NET Agent from https://files.appoptics.com/dotnet/DotNetAgent_Setup.exe
5. Run the new .NET agent installer
6. Run iisreset /START to start IIS
7. Restart any services stopped in Step 2

AppOptics.Instrumentation NuGet Package

The AppOptics.Instrumentation NuGet package has been deprecated and is no longer supported. The package has been replaced with the AppOptics.Agent NuGet package. In addition to providing the same functionality as the AppOptics.Instrumentation NuGet package, the AppOptics.Agent package also provides automatic instrumentation support. See AppOptics.Agent NuGet package (legacy agent).