On this page
In SolarWinds Service Desk (SWSD) you can use the information in the following sections to install the Discovery Agent on a single Linux machine. After the agent is installed, it automatically updates future code enhancements and all core libraries it runs on.
Setup > Discovery & Assets > Installation.
Ensure that the following prerequisite requirements are met before installing.
The Discovery Agent is supported on the following platform:
|Operating System||Ubuntu 18.04 or higher|
The following domains and ports must be allowed.
|Purpose||Destination IP||TCP/UDP||Destination Port||Protocol|
|Report asset data to the SWSD platform||
|Obtain the external IP address for monitored devices||opendns.com||UDP||53||DNS|
The first step in the installation process is to download the Linux Discovery Agent. After downloading, you have the following options for installing it on a single computer:
Perform a silent installation using a command line.
Navigate to Setup > Discovery & Assets > Installation.
Next to Discovery Agent Linux, Ubuntu is preselected. Click Download.
Run the Discovery Agent setup wizard
At the Welcome screen, click Next to begin.
Select I accept the agreement, and then click Next.
In the Ready to Install dialog, click Next.
When prompted, click Finish to complete the installation.
When the installation is complete, the Discovery Agent runs an inventory scan for the first time. This may take several minutes to complete.
When the scan is completed, the installer displays an Install Succeeded message. Click Close.
The agent then begins reporting on the preconfigured parameters (that is, hardware, software, etc.). It may take a few moments for the information to display in your SWSD instance.
Install remotely on a Linux machine using PuTTY
Use PuTTY when installing the Discovery Agent from a Windows machine. These instructions also apply to any other SSH client.
If you cannot download the installer and run the wizard on your Linux machine, download the installer to a Windows machine. Then complete the following steps to transfer the installer to the Linux machine and run it remotely. Although these instructions use PuTTY, you can perform the same actions using any SSH client.
Be sure prerequisite requirements are met.
Download PuTTY (www.putty.org).
Open a Command Prompt window.
To transfer the file using SCP, execute the following command:
"C:\Program Files\PuTTY\pscp.exe" -scp
followed by the path to the installation file on your computer.
"C:\Program Files\PuTTY\pscp.exe" -scp [PATH_TO_DOWNLOADED_FILE] [linux_user@linux_ip]
Close the Command Prompt window.
Log in to your Linux server using PuTTY.
Execute the following commands in the terminal:
tar -xzvf Solarwinds_Discovery_Agent_[version]_installer.tar.gz
The installation is complete.
Uninstall the Agent on a Linux machine
Open a Terminal window and run the following command:
After you enable the Discovery Agent, the agent inventory automatically updates every 24 hours. The agent runs as a separate package and triggers a refresh based on that schedule.
To optimize for outbound bandwidth utilization, the agents randomize the next inventory refresh within a 24-hour time frame. This process prevents all agents from reporting at the same time.
Optionally, you can force the agent on a targeted machine to manually push an update. To push the update, open a terminal and run the following commands or copy the code into the terminal. If the terminal does not return an error message, the procedure completed successfully.
sudo /usr/share/SolarwindsDiscoveryAgent/agent/ruby/run.sh /usr/share/SolarwindsDiscoveryAgent/agent/src/mini_kernel/cmd.rb -f