Documentation forSolarWinds Platformand Orion Platform

Deploy an agent manually to a Linux/Unix-based computer

This SolarWinds Platform topic applies only to the following products:

Hybrid Cloud Observability EssentialsHybrid Cloud Observability Advanced


Use this method to install agents if you cannot use push deployment to Linux/Unix-based devices over SSH. For example, when the device is behind a NAT or is hosted in the cloud. This approach uses wget, curl, or perl to download the installation files from your chosen polling engine. This agent installation method is known as a pull deployment.

Pull deployment requires that the SolarWinds Platform Web Console is accessible from the target Linux computer.

  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 Unix/Linux, and Next.
  4. Click Manually Install by Downloading Files via URL, and click Next.
  5. Select your Distribution and Communication Mode.
  6. Enter the Connection Settings.
  7. Click Generate Command.
  8. Copy and paste the command in the terminal open to the Linux/Unix computer. The command downloads the software from the selected polling engine.
  9. Optional: For Server-initiated communication (passive), in the SolarWinds Platform Web Console click Settings > All Settings > Node & Group Management > 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.

    When the installation is successful and communication between the agent and the SolarWinds Platform server has been established, the agent appears in the agent list on the Manage Agents page.

  10. On the Manage Agents page, select the new agent, and then click Choose Resources.
  11. Select the items you want to monitor, and click Submit.

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.

You can choose to copy the installer file to the Linux/Unix computer manually and then install it instead of using wget, curl or perl.

  1. On the Download Agent Software page, select your distribution.
  2. Click Download Agent Software File for Manual Installation.
  3. Move the file to the Linux/Unix computer and extract it.
  4. Follow the instructions in the readme.txt file.

Select your distribution

Agents are supported on the following Linux/Unix operating systems.

  • Amazon Linux 2 / AMI, 64-bit
  • CentOS 6.x, 32-bit
  • CentOS 6.x, 7.x, 8.x, 64-bit
  • IBM AIX 7.x
  • Oracle Linux 6.x, 7.x, 8.x, 64-bit
  • Raspbian Jessie 8.0
  • Red Hat Enterprise Linux 5.11, 6.x, 32-bit
  • Red Hat Enterprise Linux 5.11, 6.x, 7.x, 8.x, 64-bit
  • SUSE Linux Enterprise Server 11.x - 15.x, 64-bit
  • SUSE Linux Enterprise Server 11.x, 32-bit
  • Ubuntu 14.x - 16.x, 32-bit
  • Ubuntu 14.x - 20.x, 64-bit

Linux distributions not listed above, such as Debian or Fedora, are not supported.

If your operating system is not listed, select the closest match to your Linux/Unix distribution. SolarWinds cannot guarantee that the software will work as intended on a non-supported OS, but will attempt to install the software for the distribution you select.