Documentation forServer & Application Monitor

Uninstall the AppOptics Agent from SAM

AppOptics is approaching its End of Service Life and has been removed from SolarWinds Observability Self-Hosted. For more details, see AppOptics End of Service Life FAQ. The instructions below describe how to remove the AppOptics Agent(s) from SAM.

Migrate to SolarWinds Observability SaaS for the next generation of application performance monitoring. You can view both SaaS and self-hosted observability data in one place using the Platform Connect feature.

Uninstall the AppOptics Agent

During initial configuration, the AppOptics Integration module installed its agent on the server, or node, specified by the user. The agent also collected additional information about IIS.

Follow these steps to uninstall the AppOptics Agent from your server or servers (if multiple agents are installed):

  1. Log in to the SolarWinds Observability Self-Hosted database and execute the following query to display a listing of all installed AppOptics agents. The SamAppOptics_AgentsToUninstall_Backup table includes applicable information required to perform the uninstall process. 

    SELECT [ApplicationID],
       [IntegrationType],
       [ServiceName],
       [NodeID],
       [IP_Address],
       [SysName]
FROM [SolarWindsOrion].[dbo].[SamAppOptics_AgentsToUninstall_Backup];

  2. For each agent listed:

    1. Log in to the appropriate server (node) with administrator privileges using its IP address provided in the table.

    2. Navigate to the C:\Program Files\SolarWinds\APM\dotnet directory, locate and run the unins000.exe file.

    3. In the modal window that opens, click Yes to confirm uninstalling of the AppOptics agent and all its components.

    4. Once the uninstall process is complete, a message will confirm successful removal of the agent. Click OK to close the modal.

      Some log files may remain in the installation directory, which are no longer needed. The entire \APM\dotnet can be safely deleted.

  3. After ensuring that all AppOptics agents have been uninstalled, delete the SamAppOptics_AgentsToUninstall_Backup table: 

    DROP TABLE [SolarWindsOrion].[dbo].[SamAppOptics_AgentsToUninstall_Backup];

Troubleshooting

If the agent is installed on the node where SolarWinds Observability Self-Hosted is also installed, you may encounter a prompt during the uninstall process indicating that the application, w3wp must be stopped.

In this case, you can proceed in one of two ways:

  • Open the SolarWinds Platform Service Manager, and stop the SolarWinds NetPerfMon service before continuing with the uninstall process, or

  • Click Close Applications and Continue in the Setup - Close Applications window, which will automatically perform the necessary actions and continue with the uninstall process.