Documentation forSolarWinds Service Desk

Scanner installation

On this page

Introduction

Before you install the SolarWinds Service Desk (SWSD) Discovery Scanner, review the prerequisites, security, and best practices below. The information can help you determine the best setup for your organization based on your current infrastructure.

Navigation

Setup > Discovery & Assets > Installation.

Prerequisites

Hardware and software requirements

The Discovery Scanner should be installed on a dedicated virtual or physical machine running Windows or Linux.

The dedicated machine should be on the same subnet/network as devices, or it should be able to access the devices.

SolarWinds recommends Installation of Nmap, SNMP Client, ODBC driver, SQLCmd utility, and Free TDS library before installing the scanner. See Prerequisite packages for more information.

Requirement Supported software and hardware
Operating System

Red Hat 7.4 or newer

Ubuntu 18.04 or higher

Windows 10 1809 or newer

Windows Server 2016 version 1607

Windows Server 2019

Hardware

Dual Core CPU

4 GB RAM

40 GB disk space

Firewall requirements

The following domains and ports must be allowed.

Purpose Destination IP TCP/UDP Destination Port Protocol
Report asset data to the SWSD platform

agt.samanage.com

+ agteu.samanage.com
(EU accounts only)

TCP 443 HTTPS
Obtain the external IP address for monitored devices opendns.com UDP 53 DNS

Prerequisite packages

The following table lists the packages required by the Discovery Scanner.

SolarWinds strongly recommends that you install the necessary packages below before installing the Discovery Scanner.
Package Description Needed for Linux OS (Ubuntu and Red Hat)? Needed for Windows OS?
Nmap Performs network scans using raw IP packets to identify hosts available on the network. Yes Yes
SNMP client Queries information from routers and additional SNMP-enabled devices, such as printers and switches. Yes No
SqlCmd utility

Connects to a Microsoft SQL Server database that is defined in the SCCM connections.

Install the proper ODBC driver before installing the SqlCmd utility.
No Yes
Free TDS library Enables the Discovery Scanner to communicate with Microsoft SQL Server. Yes No

Additional prerequisites

The Discovery Scanner collects and organizes information about managed devices on your network using specific protocol tools. The following table provides a list of all tools the scanner uses to collect information about your managed devices.

Information Type 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 Administrators group permissions and a member of the local Distributed COM Users group.

Pre-installation decisions

Determine whether you will install on a Linux server or Windows machine. Follow the corresponding Linux and/or Windows package requirements below.

Package installation commands

See the section below that corresponds with the operation system running on your host server.

Linux installation

The following table lists the commands used to install the packages required by the Discovery Scanner. Run the commands (with elevated privileges) on your Linux server.

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

Prerequisite: For customers using Ubuntu versions earlier than 22.04, it is necessary to upgrade OpenSSL from version 1.1 to 3.0. This update is crucial to ensuring the successful installation and operation of the agent and to securing OpenSSL with the latest security fixes. For new installations being installed on Ubuntu 22.04 or later, OpenSSL 3.0 is preinstalled and no upgrade of OpenSSL is required

Windows installation

The following table lists the commands used to install the packages required by the Discovery Scanner. Run the commands on your Windows machine.

Task Installation
Install Network Mapper (Nmap)
  1. Download Nmap from the following location:
    https://nmap.org/dist/nmap-7.91-setup.exe.

  2. Follow the on-screen instructions to complete the installation. If your web browser does not prompt you to run or save the file, copy and paste the URL into the browser address bar.

Install the Microsoft Command Line Utility for SQL Server (SqlCMD)

For best results, SolarWinds recommends installing SqlCMD version 15.

Microsoft ODBC Driver 17 for SQL Server may also be required. See the system requirements for details.

  1. Download the latest SqlCMD utility from the following location: https://docs.microsoft.com/en-us/sql/tools/sqlcmd-utility?view=sql-server-ver15

  2. Follow the on-screen instructions to complete the installation.

Best practices

  • If your company spans multiple locations that are not interconnected (such as the USA, Europe, and the Middle East) SolarWinds recommends deploying the Discovery Scanner in each location. 

  • Ensure that the Discovery Scanner can access all parts of the networks that contain the asset data you want to collect.

  • Determine the frequency of network scans. The default scanning frequency is set for every 24 hours. To reduce high bandwidth use on your network, consider scanning your targeted network subnets once a day.

  • Determine how many scans you need to collect your device data. After you determine the frequency of your scans (for example, once a day), schedule the scans so they complete during the appropriate time and date.

    Scheduled scans cannot begin during their currently scheduled interval if a previous scan has not completed. Instead, after the previous scan is completed, the scheduled scan will begin during its next scheduled interval.
  • Do not install both the Discovery Agent and the Discovery Scanner together on the same machine.

    • SolarWinds recommends installing the Discovery Agent on each computer running Windows or MacOS. The Discovery Agent provides additional information that enhances the Discovery Scanner results.

    • For Linux computers and other devices (such as network equipment and connected devices), install the Discovery Scanner.

  • Install the Discovery Agent on computers that were discovered by the Discovery Scanner. The Discovery Scanner discovers computers that are not monitored by a Discovery Agent. You will receive limited information on that specific endpoint device. 

    After the Scanner agent is installed and the first scan is complete, you will receive detailed information on hardware, BIOS, and installed software titles for computers where the agent is installed.

    The Scanner will detect and report computers that were already reported by the Agent.  As the Agent has precedence over the Scanner, these devices are identified as duplicates and will only display once.  All computers display automatically on the Computers index page under the Inventory tab and not in Network Devices. However, if you don't see a computer on the Computers index page as expected, check the Network Devices index page.

Download and install the SolarWinds Discovery Scanner

After you review the prerequisites, pre-installation decisions, and best practices, install the Discovery Scanner on your network.

The following sections describe how to download and install the Discovery Scanner on your Linux and Windows machines.

If you cannot download the installer to your Linux machine, download it to a Windows machine and then install it remotely.

Download the installation file (Linux and Windows)

  1. In SWSD, navigate to Setup > Discovery & Assets > Installation.

  2. Scroll down to Discovery from the left pane or from the tile on the right. The SolarWinds Service Desk Discovery pane opens.

  3. Next to Discovery Scanner, select the operating system running on the device where you will be installing the scanner, and then click Download. A unique package is generated for your SWSD instance.

    Optionally, click on either Installation Guide or Discovery Guide to open the guide in the SolarWinds Service Desk Success Center.

  4. Copy the installation file.
  5. Install the scanner:

If you are installing the scanner on a Windows machine you can use the GUI (see Install for Linux or Windows by using the GUI).

Install using a setup wizard on a Linux or Windows machine

Perform the following steps to install the Discovery Scanner on a machine running a supported version of Linux or Windows.

  1. Be sure prerequisites requirements are met.

  2. Double-click the installer.

  3. Click Forward to begin.


  4. If you agree with the license agreement, select I accept the agreement, and then click Forward.

  5. In the Ready to Install dialog, click Forward.

  6. Allow the SolarWinds Discovery Scanner Setup to complete the installation process. When complete click Forward.

  7. Click Finish to close the wizard.

Install remotely on a Linux machine using PuTTY

Use PuTTY when installing the Discovery Scanner 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.

  1. Be sure prerequisites requirements are met.

  2. Download PuTTY (www.putty.org).

  3. Open a Command Prompt window.

  4. 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.

    For example:

    "C:\Program Files\PuTTY\pscp.exe" -scp [PATH_TO_DOWNLOADED_FILE] [linux_user@linux_ip]

  5. Close the Command Prompt window.

  6. Log in to your Linux server using PuTTY.

  7. Execute the following commands in the terminal:

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

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

The installation is complete.

Records created during installation

The following records were created in your SWSD instance:

  • A Scanning Device

  • The subnet in which the scanner was installed

  • The router the Scanner is using to connect outside of its subnet

Uninstall the scanner

Uninstall the scanner on a Windows machine

Open a Command Prompt window and run the following command:

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

--mode unattended is optional

Uninstall the scanner on a Linux machine

Open a Terminal window and run the following command:

sudo /usr/share/SolarwindsDiscoveryScanner/agent/src/mini_kernel/utils/linux/uninstaller.sh

Related topics