Documentation forSolarWinds Service Desk

Discovery Scanner Installation

Prerequisites

Requirements

Method Linux Compatibility Windows Compatibility Red Hat
Operating System Ubuntu version 18.04 or higher Windows 10 1809 or Windows Server 2016 version 1607 Red Hat 7.4 or newer We do not yet support 8.0 - 8.1
Hardware Requirements

Dual Core CPU
4 GB RAM
40 GB disk space

Prerequisite packages

The following packages are needed by the Discovery Scanner:

Linux (Ubuntu/Red Hat)

Windows

Nmap is used by both Linux and Windows OS to perform network scans using raw IP packets to determine what hosts are available on the network.

SNMP client is used to get information from routers and additional SNMP enabled devices such as printers and switches.

SqlCmd utility is used to connect to an MSSql database that is defined in the SCCM connections

Free TDS is a library that enables the scanner to communicate with Microsoft SQL Server.

 

 

Now determine if you will install on a linux server or Windows Machine.  Follow the corresponding Linux and/or Windows package requirements below.

To install the packages required by the Discovery Scanner please run the following commands on your linux server with elevated privileges:

Purpose Command

Update repository

sudo apt-get update

Install NMAP

sudo apt-get install nmap

Install SNMP Client

sudo apt-get install snmp snmp-mibs-downloader

Install free TDS

sudo apt-get install freetds-bin

To install the packages required by the Discovery Scanner please run the following commands on your Windows machine:

Purpose Command

Install NMAP

https://nmap.org/dist/nmap-7.80-setup.exe

Download and follow the instructions.

SqlCmd utility

https://www.microsoft.com/en-us/download/details.aspx?id=53591 (© 2020 Microsoft, available at https://www.microsoft.com/en-us/download/details.aspx?id=53591, obtained on January 27, 2020)

Click on the links above and begin download.  Follow the onscreen instructions.

The system requirements state that in some cases it is required to install Microsoft ODBC Driver 13.1 for SQL server as well.

Additional Prerequisites

The main function of the Discovery Scanner is to use Internet Standard Protocol to collect and organize information regarding all managed devices on your IP network. 

Within your organization, you can elect to collect this data in a variety of ways.  The table below provides a comprehensive list of all the information needed for each collection tool selected:

Tool SCCM vCenter

SNMP v1/v2c

SNMP v3

SSH WMI

Name

 

Dataserver

 

 

 

 

 

Username

 

*

Password

 

 

 

Port

 

 

 

 

 

Database

 

 

 

 

 

IP Address

 

 

 

 

 

Community

 

 

 

 

 

Authentication Key

 

 

 

 

 

Privacy Key

 

 

 

 

*The WMI Username should be an account with local “Administrator” group permissions or “Domain Admins” group permissions and a member of local “Distributed COM Users” group.

Security

Discovery Scanner Security

The processes used by the Discovery Scanner for data collection complies with the highest level of security you have come to know from SolarWinds.

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

Before you begin Installation of your Discovery Scanner, you want to review the checkpoints below.  They are provided to help determine the best setup for your organization based on your current infrastructure.  Once you review our Best Practices, you are ready to begin. 

Best Practices

As it is important to us that you derive the maximum benefit from your SolarWinds Discovery Scanner, we have put together a number of best practices that will assist you in the most efficient installation procedures.

  1. When your company spans across multiple locations that are not interconnected (e.g. USA, Europe, Middle East) it is recommended to deploy the Scanner in each location. 

  2. You want to ensure the Discovery Scanner has access to all the subnets you desire to collect asset data from your network.

  3. Determine frequency of scans. The default scanning frequency is set for every 24 hours.  Scanning once a day is designed to optimize the balance between getting fast updates on asset changes and reducing the load on the network.

  4. Review network load:

    1. Determine how many scanners will provide the maximum benefit. 

    2. Once length of scan is determined, ensure scans are scheduled to allow completion of each scan.

    When a scan is scheduled however the previous scan is not complete, the next scan will NOT start.  Upon completion of the scan, the next scan will only begin during the next scheduled interval.

  5. Working with the Discovery Agent and the Discovery Scanner concurrently.

    1. We recommend installing the Discovery Agent on each computer running Windows and/or MacOS.  The Agent provides greater information than the Scanner will supply for these computers.

    2. For Linux computers and other devices (network equipment and connected devices) → install the Discovery Scanner.

    3. The scanner will discover computers that are not monitored by a Discovery Agent.  You will receive limited information on that specific endpoint device.  It is recommended to install an Agent on the computers that were discovered by the Scanner for greater insight.

    4. Once the Agent is installed and the first scan is completed, you will receive detailed information on hardware, BIOS and installed software titles.

    The scanner will detect and report computers that were already reported by the Agent.  As the Agent has precedence over the scanner, these will be identified as duplicates and will only appear once.  All computers appear automatically in the Computers screen under your Inventory tab and not in Networked Devices.

How to Download and Install SolarWinds Discovery Scanner

After reviewing the prerequisites, security and factors to consider prior to Installation, install your Discovery Scanner to extract detailed information on every component of your IT infrastructure.

The following sections provide download and installation instructions of the Discovery Scanner on your Linux and Windows machines.

Download

  1. In your SolarWinds instance, hover over the menu icon on the top left corner and select Setup.

  2. Scroll down to Discovery. (This can be done from the left pane or icon on the right pane.)

  3. Click Installation.

  4. Determine if you are installing on an Ubuntu Windows and/or Red Hat machine.  Select the appropriate circle and click Download in the Discovery Scanner section.

    A unique package in generated for your SolarWinds instance.  Please be sure to copy this installation file to the Scanner you plan to use.

If you are installing on a Windows machine, please go directly to the GUI-based instructions.

To uninstall the scanner on a windows machine, use the command line:

"C:\Program Files (x86)\SolarWinds Discovery Agent\uninstall.exe" --mode unattended

Installation on your Linux Workstation or Server

Depending on the Linux machine configuration (Workstation or Server) the Discovery Scanner can be installed directly from the UI or remotely using an SSH client.

If the machine is a server, the installer must be downloaded from another machine and transferred to the Linux machine using SCP or any other transfer method.

The instructions below contain steps of remote installation using PuTTY.
These instructions apply to any other SSH client as well.

Linux Machine Configuration

The following describes how to install SolarWinds Discovery Scanner on a Linux (Ubuntu and/or Red Hat) server and/or Desktop.

Installation Using PuTTY

(PuTTY can only be used when installing via a Windows Machine)

When installing the Discovery Scanner on a server and you do not have the ease of installing via the GUI, we have provided the below instructions:

#

Procedure

Command

1

Enter the URL to download PuTTY

https://the.earth.li/~sgtatham/putty/latest/w64/putty-64bit-0.70-installer.msi

2

Open Windows command line and execute the command shown

"C:\Program Files\PuTTY\pscp.exe" -scp

followed by the discovery installation file’s path on your computer and the linux machine connection details. IE "C:\Program Files\PuTTY\pscp.exe" -scp [PATH_TO_DOWNLOADED_FILE]  [linux_user@linux_ip]:.

Once you have run the command:

  1. Log in to your linux server using PuTTY.

  2. Execute the following commands in the terminal:

    1. tar -xzvf Samanage_Discovery_Scanner_[version]_installer.tar.gz

    2. sudo ./Samanage_Discovery_Scanner_[version]_linux-x64_installer.run

Your installation is now complete and the following records were created in your SolarWinds instance.

  • A Scanning Device

  • The subnet in which the scanner was installed

  • The router that the scanner is using to connect outside of it’s subnet

For further information, please review the SolarWinds Discovery Manual to configure SolarWinds Discovery and to begin gathering information on your network devices.

Installation Using GUI

The directions below are good for Linux (Ubuntu and Rad Hat) and Windows OS

  1. Press Forward to begin.


  2. Select “I accept the agreement” and click Forward/Next.

  3. Click Forward/Next.

  4. Allow the SolarWinds Discovery Scanner Setup to complete the installation process, once complete click Forward/Next.

  5. Click Finish.

Discovery Scanner Installation is complete. Refer to the SolarWinds Discovery Guide for additional details.