Documentation forSolarWinds Platform Self-Hosted

Manually deploy an agent on Amazon Web Services

You can manually deploy agents to a virtual machine using Remote Desktop Connection in two ways.

Requirements for manual agent deployment

  • Agent-initiated communication: The poller must have a public IP address which is visible from the node with the agent installed. Ports 17778 (outbound) on the agent machine and 17778 (inbound) on your SolarWinds Platform polling engine must both be open.
  • Server-initiated communication: The node with the agent installed must have a public IP address. Port 17790 must be open. You must also connect the agent to the SolarWinds Platform server by clicking Settings > All Settings in the menu bar. Under Node & Group Management go to Manage Agents > Add Agent > Connect to a previously installed agent > Next. Enter the name, IP address, and port number for the agent and click Server-initiated communication.

Install through the command prompt

  1. Click Settings > All Settings in the menu bar.

  2. Under Product Specific Settings, click Agent & Remote Collector. Then, on the Agent Management view, click Download Agent Software.

    In Orion Platform 2020.2 and earlier, click Agent Settings to get to the Agent Management view with the Download Agent Software link.

  3. Click Windows, and click Next.
  4. Click Mass Deploy to Multiple Machines, and click Next.
  5. Download the MSI and MST files.
  6. Run a command prompt as administrator from the context menu.
  7. Enter the following command:

    msiexec /i "SolarWinds-Agent.msi" TRANSFORMS="SolarWinds-Agent.mst"

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

Deploy the agent manually using the interactive wizard

  1. Click Settings > All Settings in the menu bar.

  2. Under Product Specific Settings, click Agent & Remote Collector. Then, on the Agent Management view, click Download Agent Software.

    In Orion Platform 2020.2 and earlier, click Agent Settings to get to the Agent Management view with the Download Agent Software link.

  3. Click Windows, and click Next.
  4. Click Install Manually, and click Next.
  5. Click Download .MSI.
  6. Copy the MSI file to the client machine, and run it.

  7. On the Welcome page, click Next.

  8. On the License Agreement page, review the EULA. If you agree, select the checkbox, and then click Next.

  9. (Optional) If you do not want to install SolarWinds Platform Agent in the default location, browse to the desired location and select it.

  10. Click Install to start the installation.

  11. When the installation is complete, configure the agent:

    • Agent Initiated communication

      1. Select Agent Initiated Communication.

      2. Enter the SolarWinds Platform server IP address or hostname.

      3. Enter the port.

      4. Enter the SolarWinds Platform administrator account credentials.

      5. Optional: To configure a proxy for accessing the SolarWinds Platform server, click Proxy settings, select Manual proxy configuration, and fill in the proxy details.

    • Orion Server Initiated Communication

      1. Select SolarWinds Platform server Initiated Communication.

      2. Review the Passive Agent Port and adjust it if necessary.

      3. Enter the Agent Shared Secret.

      4. Optional: To configure a proxy for accessing the SolarWinds Platform server, click Proxy settings, select Manual proxy configuration, and fill in the proxy details.

  12. When you confirm the agent configuration, check the certificate and confirm it if you trust it.

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