Documentation forSolarWinds Observability SaaS

Troubleshoot Network Collector installation issues

The Network Collector includes the SolarWinds Observability Agent and the Agent uses the network-collector plugin to send data to SolarWinds Observability SaaS. During the installation, both the Agent and the plugin are configured automatically. See Agents and Troubleshoot SolarWinds Observability Agent issues for details on configuring and installing SolarWinds Observability Agents.

Upgrade SolarWinds Hybrid Cloud Observability on a server with Network Collector is not supported

You are running an incorrect installer. Instead of using the installer for Network Collector, you launched the installer for a different SolarWinds Observability product.

To resolve the issue, download the correct installation file.

  1. In SolarWinds Observability SaaS, click Add Data at the top.

  2. Click Network Device and click the link to download the ISO file.

Agent already installed on the machine

When you try to install the Agent on a host where an Agent is already installed, you will be informed about it. The Agent will be installed but will fail to register because of an invalid token.

Resolution

  1. Unbind the Agent identity. To do so, run the following PowerShell command

    .\uamsclient-ct1.exe unbind-identity
  2. Uninstall the Agent via Add/Remove Programs.

  3. Install Network Collector by running the Agent installation script.

Start the installation on a server where Network Collector is already installed

When you try to install the Network Collector on a server with Network Collector already deployed, the installation Fails with a System.ServiceModel.EndpointNotFoundException.

To resolve the issue, install the Network Collector on a different server with no SolarWinds deployment on it.

Start the silent installation on a server without .NET framework installed

If you try to install the Network Collector on a server without .NET framework installed, the installation gets stuck at the Network Collector installation phase. Check the logs. Search for messages about restart being required.

Resolution

  1. Reboot the host server.

  2. Wait until the installation completes. The installation might take quite a long time to complete.

Original credentials when you redeploy the SolarWinds Observability Agent with a new configuration

When you uninstall the Agent, change your web console password configuration, regenerate the installation script, and use the script to re-install the Agent, the collector is configured with the original password settings.

Resolution

  1. After you uninstall the Agent, delete the corresponding Agent in SolarWinds Observability SaaS. See Remove the Agent from SolarWinds Observability SaaS.

  2. Reinstall the Agent.

  3. Wait until the installation completes. The installation might take quite a long time to complete.

Reusing the Agent deployment script triggers auto-generated credentials

If you use the same script to install the Agent on a different machine, a password for the web console is generated automatically.

Resolution

  1. Generate a new installation script for installing the Network Collector on each machine.

Failed Network Collector installation

If the installation fails, review Events to find out what happened. The Configuration wizard log contains an error while executing silent Configuration wizard.

Resolution

  1. Re-run the installation on a new virtual machine.

Error while setting credentials towards the end of the installation

In case of the credential service issues, user-defined credentials might fail to be applied on the Network Collector. On Events, you will see an event saying Failed to create web console credentials for user admin.

Resolution

  1. Open the web console in your browser. On the Login screen, create a password manually.

Install the SolarWinds Observability Agent with another role, such as host-monitoring

If you successfully install the Agent but cannot see any events related to the installation on the Events page, you might have installed the Agent with a different plugin (for example with host-monitoring).

Resolution

  1. Uninstall the Agent.
  2. Delete the Agent in SolarWinds Observability SaaS. See Remove the Agent from SolarWinds Observability SaaS.
  3. Re-install the Agent.

See Delete Agents.