Documentation forSolarWinds Platform Self-Hosted

Edit agent connection settings or reprovision the agent once deployed

This topic applies only to the following SolarWinds Platform products:

SolarWinds Observability Self-Hosted

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

You can modify settings such as the communication mode or to which polling engine the agent sends information by modifying the agent on the computer.

If the agent loses connectivity to the SolarWinds Platform server, is unable to connect after being manually installed, or if the SolarWinds Platform server has migrated, you can configure the agent's settings directly on the computer you are monitoring. This enables the agent to reconnect to the SolarWinds Platform server.

Reprovisioning the agent retains historical data for the node including cpu, memory, and application polled data.

Windows devices

  1. Log in with an administrator account to the computer with the agent installed on it.

  2. Open Orion Agent Settings in the Control Panel.

    If you get an error when opening Agent Settings in the Control Panel:

    • Navigate to the C:\ProgramData\SolarWinds\Agent directory and Permanently Grant Access to the directory for your user when prompted.
    • Navigate to the agent installation directory (by default C:\Program Files (x86)\SolarWinds\Agent) and Permanently Grant Access to the directory for your user when prompted.

  3. Select the Agent Communication Mode.

  4. Edit the Connection Settings.

    If you select Orion Server Initiated Communication, you can adjust the Agent Shared Secret:

    • The Agent Shared Secret is provided for security. When you install the agent, you must set a shared secret. When the SolarWinds Platform server connects to the agent, it verifies the secret to connect.
    • Don't use double quotes in the Shared Secret.

  5. Click OK to save your changes.

  6. If the certificate changed since the last time you provisioned the agent, review the used certificate and confirm it if you trust it.

When communication between the agent and the SolarWinds Platform server is successful, the agent is listed on the Manage Agents page with the updated communication mode.

Linux/Unix-based devices

  1. Log in to the computer with the agent installed on it.
  2. Open a terminal window.
  3. Run the following command as root:
    /opt/SolarWinds/Agent/bin/swiagentaid.sh init
  4. Configure the agent communication mode and polling engine information.
  5. Enter 7 to save your changes.

When communication between the agent and the SolarWinds Platform server is successful, the agent is listed on the Manage Agents page with the updated communication mode.