Observability

SolarWinds Observability Network Collector UAMS Client agent re-installation

This guide provides guidelines on how to manually reinstall the UAMS agent deployed in the Network Collector in SolarWinds Observability.

First published date

4/9/2024 5:13 PM

Last published date

12/22/2025 10:31 PM

Overview

There are cases that you may notice that Network devices that are registered in your Network Collector are not flowing through in your SolarWinds Observability UI. In some instances, re-installation of the UAMS Client agent will resolve the issue, as long as you have undergone the basic troubleshooting steps mentioned in this documentation linked here.

Product section

SolarWinds Observability

Cause

  • In rare situations caused by internal infrastructure problems, the network-collector (SiteCollector) plugin is not displayed when you log in to the SolarWinds Observability UI >> Settings >> Agents >> click on the Agent Name or Host Name where you deployed the Network Collector. 
  • There are also cases when reinstall is needed if wrong role has been used to deploy the UAMS Client agent.

Resolution

  1. Log in to the host where you installed your Network Collector
  2. Locate the “SolarWinds UAMS Client” through Programs and Features or running appwiz.cpl
  3. Uninstall “SolarWinds UAMS Client”
  4. When it asks you, whether you want to delete all user data, click on yes.
  5. Log in to the SolarWinds Observability UI, go to Settings >> Agents >> locate the host name you installed the Network Collector and select it >> click Delete.
  6. Back on the host where the Network Collector is installed, run the script below in PowerShell:  
    [Net.ServicePointManager]::SecurityProtocol = "Tls11, Tls12"; irm https://agent-binaries.cloud.solarwinds.com/uams/latest/uamsclient_install.ps1 | iex; install -AccessToken "<ENTER YOUR API TOKEN HERE>" -Metadata "role:SiteCollector" -SwoUrl "<xx-yy.cloud.solarwinds.com>"
    Make sure to replace your "<ENTER YOUR API TOKEN HERE>" with your actual SWO API token. Click Settings in SWO >> API Tokens in the left-hand navigation. You can use an existing SWO API token. Replace also the SWO URL with your actual SWO URL region.
  7. Once done, log in to your Network Collector and re-register your network device to be monitored in SWO whenever necessary.