→ The Lansweeper Customer Excellence Awards 2024 - Submit Your Project Now! Learn More & Enter Here

cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
sophie
Lansweeper Employee
Lansweeper Employee

TL;DR-Sweepy-Icon (1).png
This page provides information on installing Network Discovery, and how you can start remote discovery of your IT and OT assets.


Network Discovery is currently a preview feature, so please anticipate occasional adjustments and improvements as we refine its performance.

Lansweeper's Network Discovery enables you to discover all IT and OT assets within your network. By utilizing the necessary discovery credentials, Network Discovery gathers all asset details both on the local machine and on remote IT assets.

On this page:

Requirements

During Preview, Network Discovery can produce duplicate assets. Optionally, you can resolve duplicate assets by going to Inventory > Duplicate conflicts and resolving the duplicates manually, or by going to Scanning > Discovery systems, unlinking the Network Discovery system(s), and removing all related data.

Connection requirements

The computer running the hub component of Network Discovery must allow the following outbound connections, when you've linked the hub with your Lansweeper Site:

URL Description
https://discovery-gateway.lansweeper.com/  Authenticates, logs in, syncs data, and gets auto updates from your Lansweeper Site.

If the computer running Network Discovery requires a proxy server, you can provide the details using a silent installation method.

Supported operating systems

Network Discovery can be installed on the following operating systems.

Windows

  • Windows 10 21H2 or higher (x64)
  • Windows 11 22000 or higher (x64)
  • Windows Server 2012 or higher (x64)

Linux

.deb packages:
  • Debian 10 up to penultimate version (x64)
  • Ubuntu 16.04, 18.04, 20.04 up to penultimate version (x64)
.rpm packages:
  • CentOS Linux 7 (x64)
  • CentOS Stream Linux 8 up to penultimate version (x64)
  • Fedora 36 up to penultimate version (x64)
  • openSUSE 15 up to penultimate version (x64)
  • Oracle Linux 7 up to penultimate version (x64)
  • Red Hat Enterprise Linux 7 up to penultimate version (x64)
  • SUSE Enterprise Linux (SLES) 12 SP2 up to penultimate version (x64)

MacOS

  • macOS 10.15 up to penultimate version (x64)

System requirements

Specifications Minimum Recommended
Processor x64, Quad-core 1 GHz or higher x64, Quad-core 2 GHz or higher
Memory 4 GB RAM 16 GB RAM
Disk size Hub: 100 GB
Sensor: 50 GB
Hub: 250 GB (caching)
Sensor: 100 GB (logging storage)
Network speed 100 Mbps or higher 1000 Mbps or higher

Installation paths and logs

By default, Network Discovery will be installed in the following locations:

  • Windows: C:\Program Files\Lansweeper Network Discovery
  • Linux:
    • /opt/lansweeper-hub
    • /opt/lansweeper-it-sensor
    • /opt/lansweeper-ot-sensor
  • macOS: /Application Support/Lansweeper Network Discovery

By default, logs can be found in the following locations:

  • sensors\logs\Lansweeper.IT.Sensor.log
  • hub\logs\Lansweeper.Discovery.Hub.log
  • Windows Installer:
    • C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper_Network_Discovery_installer.log
    • C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper_Network_Discovery_uninstaller.log
    • C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper.IT.Hub.log
  •  

Install Network Discovery on Windows

Install Network Discovery on Windows interactively

  1. Ensure your Windows operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery. 
    While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
  4. Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
  5. Locate the Windows OS and select Download Network Discovery installer and Download Network Discovery silent installation configuration
  6. Optionally, select Link Discovery system. In the pop-up, select Create new code, choose an expiration date, select Apply and select Copy code.
  7. Run the installer.
  8. Select I accept the agreement > Next.
  9. Choose which directory to install Network Discovery, then Next.
  10. Select Install Hub and Install IT Sensor
    • Specify another hostname for the machine hosting the hub if you’re only installing the IT Sensor.
    • Specify another TCP port if you want to override the default port for Hub to Sensor communication.
  11. Select Next.
  12. If you copied a linking code earlier, you can paste it here. Otherwise, you can link your Lansweeper later from the Hub.
  13. Select Next.
  14. Select Open Hub after finishing the installer > Finish.

Now that Network Discovery is installed, check out the Hub and configure Network Discovery.

Install Network Discovery on Windows silently

Method 1

  1. Ensure your Windows operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery. 
    While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
  4. Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
  5. Locate the Windows OS and select Download Network Discovery installer and Download Network Discovery silent installation configuration
  6. Select Link Discovery system. In the pop-up, select Create new code.
  7. Choose an expiration date, select Apply and select Copy code.
  8. On your Windows computer, open the downloaded lansweepernetworkdiscoveryinstallation.cfg file.
  9. In the file, replace cloudtokenvalue with your copied linking code. If the computer requires a proxy server, remove the # for proxyserver=myproxyserver.domain.local and proxyport=8080
    mode=unattended
    accepteula=1
    path=C:\Program Files\Lansweeper Network Discovery
    components=hub,itsensor,otsensor
    hubinstance=localhost
    hubport=59525
    installnpcapdriver=1
    dcomautoconfig=1
    #cloudtoken=cloudtokenvalue
    #proxyserver=myproxyserver.domain.local
    #proxyport=8080
  10. In an elevated command prompt, enter the following command, replacing X.X.X in Lansweeper-network-discovery-X.X.X with the version number of your installer:
    Lansweeper-network-discovery-X.X.X-windows-x64-installer.exe --optionfile lansweepernetworkdiscoveryinstallation.cfg
    The version numbers for your installer can be found in your Lansweeper Site. Go to Scanning > Download installers/packages > Network Discovery installer > Version and locate your installer.

Now that Network Discovery is installed, check out the Hub and configure Network Discovery.

Method 2

  1. Ensure your Windows operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery. 
    While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
  4. Go to Scanning > Discovery systems> Download installers/packages and navigate to the Full Network Discovery section.
  5. Locate the Windows OS and select Download Network Discovery installer
  6. Select Link Discovery system. In the pop-up, select Create new code.
  7. Choose an expiration date, select Apply and select Copy code.
  8. Enter the following command in an elevated command prompt, replacing cloudtokenvalue with the copied linking code. If the computer requires a proxy server, add parameters --proxyserver proxyserveraddress and --proxyport 8080. Replace X.X.X in Lansweeper-network-discovery-X.X.X with the version number of your installer.
    Lansweeper-network-discovery-X.X.X-windows-x64-installer.exe --mode unattended --accepteula 1 --path "C:\Program Files\Lansweeper Network Discovery Discovery" --cloudtoken cloudtokenvalue
    The version numbers for your installer can be found in your Lansweeper Site. Go to Scanning > Download installers/packages > Network Discovery installer > Version and locate your installer.

Now that Network Discovery is installed, check out the Hub and configure Network Discovery.

Uninstall Network Discovery on Windows

To uninstall the Network Discovery on Windows, either:

  • On your Windows computer, open the Start menu, then go to Control Panel > Add or remove programs and locate Lansweeper Network Discovery. Select Uninstall.
  • Open a command prompt and enter: 
    "C:\Program Files\Lansweeper Network Discovery\uninstall.exe" --mode unattended 

Install Network Discovery on Linux

Only silent installs are currently supported for Network Discovery on Linux.

  1. Ensure your Linux operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery. 
    While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
  4. Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
  5. Locate the Linux OS and select Download Lansweeper repository package for deb or rpm, depending on your Linux distribution.
  6. Select Link Discovery system. In the pop-up, select Create new code.
  7. Choose an expiration date, select Apply and select Copy code.
  8. Depending on your Linux distribution, follow the instructions below, replacing cloudtokenvalue  with the copied linking code:
    • Debian and Ubuntu:
      1. Install the repository package. Copy it to your machine.
      2. In a terminal, enter sudo dpkg -i ./lansweeper-repository.deb.
      3. Enter sudo apt update to make the system aware of the repository.
      4. Enter sudo env LINKING_CODE=cloudtokenvalue apt install lansweeper-network-discovery-hub.
        • For the IT sensor, enter sudo env apt install lansweeper-network-discovery-it-sensor.
        • For the OT sensor, enter sudo env apt install lansweeper-network-discovery-ot-sensor.
      5. Once there is an update, update the packages by entering 
        sudo apt update && apt upgrade lansweeper-network-discovery-hub
        sudo apt update && apt upgrade lansweeper-network-discovery-it-sensor
        sudo apt update && apt upgrade lansweeper-network-discovery-ot-sensor
    • Red Hat, CentOS, and SUSE:
      1. Install the repository package. Copy it to your machine.
      2. In a terminal, enter sudo yum install ./lansweeper-repository-1-0-x86_64.rpm.
      3. Enter sudo yum update to make the system aware of the repository.
      4. Enter sudo env LINKING_CODE=cloudtokenvalue.
      5. Enter sudo yum install lansweeper-network-discovery-hub.
        • For the IT sensor, enter sudo yum install lansweeper-network-discovery-it-sensor.
        • For the OT sensor, enter sudo yum install lansweeper-network-discovery-ot-sensor.
      6. Once there is an update, update the packages by entering 
        sudo yum update && yum upgrade lansweeper-network-discovery-hub
        sudo yum update && yum upgrade lansweeper-network-discovery-it-sensor
        sudo yum update && yum upgrade lansweeper-network-discovery-ot-sensor

Now that Network Discovery is installed, check out the Hub and configure Network Discovery.

Uninstall Network Discovery on Linux

To uninstall Network Discovery Linux, open your terminal and run the following commands, depending on your environment.

  • Debian and Ubuntu: sudo dpkg -r lansweeper-network-discovery
  • Red Hat, CentOS, and SUSE: sudo rpm -e lansweeper-network-discovery

Install Network Discovery on macOS

There are multiple you can use to install the Network Discovery on a macOS computer.

If the computer running Network Discovery requires a proxy server, use a silent install method.

Install Lansweeper Network Discovery on macOS interactively 

  1. Ensure your macOS operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery. 
    While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
  4. Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
  5. Locate the macOS with DMG format. Select Download Network disk image to download the installer.
  6. Select Link Discovery system. In the pop-up, select Create new code.
  7. Choose an expiration date, select Apply and select Copy code.
  8. Run the Network Discovery installer on your macOS machine. In the resulting pop-up, double-click the name of the installer, then Next.
    If the software is blocked, click the Apple icon in the upper-left corner of your screen. Select System Preferences > Security & Privacy > Open Anyways.
  9. Select I accept the agreement > Next.
  10. Select the installation directory. By default, the directory is /Library/Application Support/Lansweeper Network Discovery. Select Next.
  11. Paste the Lansweeper linking code in the installer, then select Next.

Now that Network Discovery is installed, check out the Hub and configure Network Discovery.

Install Network Discovery on macOS silently

Method 1 - PKG deployment

  1. Ensure your macOS operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery. 
    While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
  4. Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
  5. Select Download Network Discovery package and Network Discovery macOS package silent installation configuration to download both files.
  6. Select Link Discovery system. In the pop-up, select Create new code.
  7. Choose an expiration date, select Apply and select Copy code.
  8. In the downloaded Network Discovery package silent installation configuration file, replace cloudtokenvalue with your copied linking code and modify the content to suit your needs. If the computer requires a proxy server, remove the # for proxyserver=myproxyserver.domain.local and proxyport=8080
    #!/bin/sh
    PreinstallConfig="/tmp/LansweeperNetworkDiscovery-Preinstall.cfg" # Don't change this path!
    [ -f $PreinstallConfig ] && chmod 744 $PreinstallConfig
    cat > $PreinstallConfig << EOF
    mode=unattended
    accepteula=1
    path=/Library/Application Support/Lansweeper Network Discovery
    cloudtoken=cloudtokenvalue
    #proxyserver=myproxyserver.domain.local
    #proxyport=8080
    EOF
    chmod 744 $PreinstallConfig
  9. Enter the following command: sudo ./tmp/LansweeperPreinstallScript.sh

  10. Enter the following command, replacing X.X.X in LansweeperNetworkDiscovery-X.X.X with the version number of your installer: sudo installer -pkg Lansweeper-network-discovery-X.X.X-osx-installer.pkg -target / 

    The version numbers for your installer can be found in your Lansweeper Site. Go to Scanning > Discovery systems > Download installers/packages.

Now that Network Discovery is installed, check out the Hub and configure Network Discovery.

Method 2 - DMG deployment

  1. Ensure your macOS operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery. 
    While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
  4. Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
  5. Locate the macOS with DMG format. Select Download Network disk image to download the installer.
  6. Select Link Discovery system. In the pop-up, select Create new code.
  7. Choose an expiration date, select Apply and select Copy code.
  8. In an elevated command prompt, enter hdiutil attach Lansweeper-network-discovery-0.9.0-16-osx-installer.dmg  to mount the dmg file.
  9. Enter cd "/Volumes/Lansweeper Network Discovery" to navigate to the volume.
  10. Enter the following command, replacing cloudtokenvalue with the copied linking code and replacing X.X.X in Lansweeper-network-discovery-X.X.X-X-osx-installer.dmg with the version number of your installer. If the computer requires a proxy server, add parameters --proxyserver proxyserveraddress and --proxyport 8080.
    sudo Lansweeper-network-discovery-X.X.X-X-osx-installer.app/Contents/MacOS/installbuilder.sh --mode unattended --accepteula 1 --path

Now that Network Discovery is installed, check out the Hub and configure Network Discovery.

Uninstall Network Discovery on macOS

To uninstall Network Discovery on macOS, you can either:

  • Go to /Library/Application Support/Lansweeper Network Discovery and execute uninstall.app.
  • Open a command prompt and enter:
    sudo "/Library/Application Support/Lansweeper Network Discovery/uninstall.app/Contents/MacOS/installbuilder.sh" --mode unattended

Start Network Discovery

Now that Network Discovery is installed, you can check out the Hub and start Network Discovery.

  1. If you haven't been redirected to the Hub from the previous steps, open a browser and navigate to https://localhost:59525.
  2. Go to Sensors to ensure the sensor is present.
  3. Go to Discover > Agentless discovery.
    Lansweeper-Discover.png
  4. Enter an IP address to scan.
  5. Under Discovery type select Credential-free device recognition.
  6. Select Discover.
  7. Go to Discovery queue to validate the scan has worked as expected.
    Lansweeper-Discovery-Queue.png
  8. To see the details of a discovered asset, go to Discovery results and select a result.

Change the default certificate

  1. Generate your own .pfx file and password. For more information on creating a .pfx file, see How to create a .pfx file.
  2. In your installation folder, open appsettings.json.
  3. Search for "Certificate".
  4. Change the "Path" and the "Password" values to the values of the .pfx file you've generated earlier.
  5. Save the appsettings.json file.
  6. Restart the Lansweeper Network Discovery Hub service.

Frequently asked questions (FAQ)

For a list of answers to frequently asked questions, check out Network Discovery: Frequently Asked Questions.

Was this article helpful? Yes No
100% helpful (2/2)

New to Lansweeper?

Try Lansweeper For Free

Experience Lansweeper with your own data.
Sign up now for a 14-day free trial.

Try Now

New to Lansweeper?

Try Lansweeper For Free

Experience Lansweeper with your own data.
Sign up now for a 14-day free trial.

Try Now
Version history
Last update:
3 weeks ago
Updated by: