Documentation forSolarWinds Service Desk

Discovery Agent Installation

Prerequisites

Windows Prerequisites

The Agent Deployment is supported on the following platforms:

  • Windows 7.x

  • Windows 8.x

  • Windows 10

We support the following windows servers:

  • Windows Server 2008 R2 (October 2009)
  • Windows Server 2012 (September 2012)
  • Windows Server 2012 R2 (October 2013)
  • Windows Server 2016 (September 2016)
  • Windows Server 2019 (October 2018)

Windows XP, Windows Vista, and Windows Server 2003 are not supported.

Mac Prerequisites

  • MacOSX 10.6 and above

(We do not currently provide Agent deployment for Linux OS)

The following domains must be whitelisted in your network:

US based customers:

  • opendns.com - For SolarWinds to map your assets, must have access to machine’s external IP

  • agt.samanage.com

EU based customers:

  • opendns.com - For SolarWinds to map your assets, must have access to machine’s external IP
  • agt.samanage.com
  • agteu.samanage.com

SolarWinds Discovery and your Infrastructure

Bandwidth Usage

The Agent uses minimal bandwidth as all information collected is compressed.

  • The average size of the Agent collected data file is between 50 and 200 KB.

  • The Agent runs at preset intervals (by default, inventory scans are scheduled every 24 hours) to provide a balance between up to date maintenance and the potential overload on the endpoint device.

Agent Connectivity

The Discovery Agent connects to the internet via the HTTPS (TCP Port 443).

Agent Inventory Scans

The Agent reports upon completion of each scan. If the machine is not connected to the internet or is turned off, the Agent will resume inventory scans when the machine is reconnected. Once the machine is connected to the internet, the Agent can connect to the SolarWinds server.

Security

Discovery Agent Security

The Agent only connects to the SolarWinds server, therefore no communication is initiated with other destinations. In addition, since the Agent only initiates requests, it will not receive requests from any other device or server, internal and/or external to your network.

All data transport is encrypted using TLS 1.2. This provides higher protection against potential exploits.

SOC 2

SolarWinds is certified and complies with strict information security policies and procedures, encompassing the security, availability, processing, integrity, and confidentiality of customer data.

ISO 27001

SolarWinds is ISO 27001 certified for internationally recognized Information Security Management System (ISMS) best practices and required data security processes.

TRUSTe

SolarWinds has been certified by TRUSTe for its data privacy practices and complies with the highest standards for protecting your personal information.

Installation

Best Practices

The Discovery Agent gives you incredible insight into your computer. It is recommended to first deploy the Agent on your endpoint device. Once you are well versed in the deployment and setup processes, you are ready to proceed with a wider distribution of the Discovery Agent throughout your company.

Single Computer Deployment Instructions

Now that you have reviewed the prerequisites and are assured of the measures taken to ensure your organization’s security, you are ready to begin. You can easily download everything you need from one screen.

You may deploy the Agent on Windows and MacOS. From the Installation menu select Windows or MacOS, then click Download.

Download Agent Setup for Windows

  1. Download the Discovery Agent setup file and save it on your local computer.

  2. Launch the Discovery Agent wizard and follow the instructions.

  3. Upon viewing the Welcome message, click Next to begin.

  4. Select I accept the agreement and click Next.

  5. To being installation, click Next.

  6. Click Finish.

    Once installation is complete, the Agent will begin reporting on the preconfigured parameters (i.e. hardware, software etc.) and will appear in your SolarWinds instance momentarily.

Silent Installation Using Command Line

If you want to install the Discovery Agent using windows command line:

  1. Open terminal.

  2. Navigate to downloaded folder.

  3. Execute the installer with the following command line arguments.

  4. Execute the proxy command line parameters:

    --mode unattended - performs silent install and hides the splash screen

    enable_proxy 1 --proxy_address *[address]* --proxy_port *[port]*  --proxy_username *[username]* --proxy_password *[password]*

    [address], [port], [username], [password] would be replaced with the appropriate information based on the related proxy

When executing the installer, administrative rights are not required. However, you will be prompted to allow installation.

When running an admin-enabled command window, there is no prompt.

Removal Instructions

To remove the Agent, open the Control Panel > Programs and Features > Uninstall a program.

Download agent setup for Mac

  1. Download the SolarWinds MacOS/X Agent package.

  2. Double-click to mount and open the volume if it's not mounted automatically (the volume name is "Solarwinds Discovery Agent").

  3. Double click on the Solarwinds_Discovery_Agent_[VERSION]_osx_installer file to launch the installer.

  4. Click Next to begin.

  5. Select I accept the agreement and click Next.

  6. To begin Installation, click Next.

  7. Set up is now complete. Click Finish.

Installation will complete and run an inventory scan for the first time. This may take several minutes to complete.

  1. Upon completion, the installer returns with 'Install Succeeded' message.

  2. Click Close.

  3. You can unmount the SolarWinds agent volume by clicking Eject or dragging the icon in to the trash.

Silent Installation Using Command Line

If you want to install the Discovery Agent using command line:

  1. Open terminal.

  2. Navigate to /Volumes/Solarwinds Discovery Agent.

  3. sudo ./Solarwinds_Discovery_Agent_#{installer_version}_osx_installer.app/Contents/MacOS/installbuilder.sh --mode unattended

Removal Instructions

To remove from command line:

sudo /Applications/Solarwinds\ Discovery\ Agent.app/Contents/Resources/uninstaller.sh

Discovery Agent Across Your Network

Now that you have completed single deployment, you are ready to proceed with a wider distribution of the Discovery Agent throughout your company.

There are 2 ways to deploy. Pick the approach that best fits your network.

You may select:

  1. Active Directory

  2. Domain Logon

Using Active Directory Group Policy Option

Active Directory is most recommended as Domain Logon requires each user to be an Admin on their device and prevents auto-start of the Agent. For enterprise deployment (Windows): use Active Directory Group Policy Option (GPO) to deploy the Discovery Agent automatically on all computers that join the domain.

  1. Open the "Active Directory users and computers tool."

  2. Download the Discovery Agent setup file and save it on your local computer.

  3. Copy the agent setup file to shared network folder (for example \\NETLOGON).

  4. Create a new batch file that will deploy the agent on the computer that joins the domain, if the agent was not previously deployed. Here is an example:

    @echo off
    REM === Agent already deployed on the computer?
    if exist "C:\Program Files\Solarwinds Discovery Agent\agent\src\mini_kernel\service.*" goto END
    If exist "C:\Program Files(x86)\Solarwinds Discovery Agent\agent\src\mini_kernel\service.*" goto END
    REM === Deploying agent in silent mode
    "\\SERVER\FOLDER\Solarwinds_Discovery_Agent_{Installer_version}_installer.exe" --mode unattended
    REM === Script done
    :END

Modify the above highlighted values:

  1. SERVER and FOLDER are your server name and shared folder name (for example \SERVERETLOGON). Verify that the agent setup file is located on the shared folder.

  2. Save the batch file on your desktop as deploySAM.bat

  3. Copy and paste the deploySAM.bat from your desktop to the Script Startup Folder.

  4. When the computer starts, the deploySAM.bat will execute and deploy the agent if it was not previously installed on the local computer.

  5. Add the silent install switch to your login script.

For additional information

Using Domain Logon Script

Recommended for Enterprise deployment (Windows): Use a Domain Logon Script to deploy the Discovery Agent on all computers that log into the domain.

Your local user accounts must have local administrator rights on their computers to use the domain logon script procedure.

  1. Download the Discovery Agent setup file and save it on your local computer

  2. Copy the agent setup file to a shared network folder (for example \\NETLOGON)

  3. Modify your existing domain logon script, or use the script below. The script runs when a computer logs into the domain, checks that the agent was not previously deployed, and deploys the agent:

    @echo off
    REM === Agent already deployed on the computer?
    if exist "C:\Program Files\Solarwinds Discovery Agent\agent\src\mini_kernel\service.*" goto END
    If exist "C:\Program Files(x86)\Solarwinds Discovery Agent\agent\src\mini_kernel\service.*" goto END
    REM === Deploying agent in silent mode
    "\\SERVER\FOLDER\Solarwinds_Discovery_Agent_{Installer_version}_installer.exe" --mode unattended
    REM === Script done
    :END

  4. Modify the above highlighted values:

    SERVER and FOLDER are your server name and shared folder name (for example \\SERVER\NETLOGON).

  1. Verify that the agent setup file is located on the shared folder.

    --mode unattended

Discovery Agent Installation is complete.  Please refer to the SolarWinds Discovery Guide for additional details.  The following section will guide you through the Scanner Installation process.