Documentation forSolarWinds Platform Self-Hosted

Connect to or register a previously installed agent to modify connection or update settings

This topic applies only to the following SolarWinds Platform products:

SolarWinds Observability Self-Hosted

DPAIM — LA — NAM — NPM — SAM — SCM — SRM — VMAN*

You may need to connect and register an agent manually when agents are configured with server-initiated communication, when you migrate servers, or when Allow Automatic Agent Registration is not enabled. The steps are different depending on the agent communication mode. You should confirm the agent communication mode before connecting.

Connect to an agent using agent-initiated communication

  1. Click Settings > All Settings in the menu bar.
  2. Under Node & Group Management, click Manage Agents.
  3. Click Add Agent.
  4. Click Connect to a previously installed agent, and click Next.
  5. Enter the name of the agent you want to connect to, and select Agent-initiated communication.
  6. Select the agent from the Agent list.
  7. Optional: Expand Advanced to change the proxy.
  8. Optional: Select Allow automatic agent updates.

    Disabling this option requires you to upgrade agents manually after upgrading your SolarWinds products and modules.

  9. Click Submit.

When the connection is successful, the agent displays in the agent list on the Manage Agents page.

Connect to an agent using server-initiated communication

If the communication mode is server-initiated (passive), a shared secret was required during installation. This secret must be entered again here.

If you are migrating to a new SolarWinds Platform server, you must redeploy any agents using server-initiated communication.

  1. Click Settings > All Settings in the menu bar.
  2. Under Node & Group Management, click Manage Agents.
  3. Click Add Agent.
  4. Click Connect to a previously installed agent, and click Next.
  5. Enter the name of the agent you want to connect to, and select Server-initiated communication.
  6. Enter the IP address or hostname where the agent is installed.
  7. Optional: Expand Advanced to change the port number, assign the agent to a different poller, or use a proxy to connect to the agent.
  8. Optional: Select Allow automatic agent updates.

    Disabling this option requires you to upgrade agents manually after upgrading your SolarWinds products and modules.

  9. Click Submit.

When the connection is successful, the agent displays in the agent list on the Manage Agents page.