This website uses cookies. By clicking Accept, you consent to the use of cookies. Click Here to learn more about how we use cookies.
Accept
Reject
Community FAQ
cancel
Turn on suggestions
Showing results for 
Show  only  | Search instead for 
Did you mean: 

Install Network Discovery

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.

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

Connection requirements

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

URL Description
https://discovery-gateway.lansweeper.com/ (port 443) Authenticates, logs in, syncs data, and gets auto updates from your Lansweeper Site.
https://download.lansweeper.com/ (port 443) Downloads updates automatically when a new version is released.

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

Hub system requirements

Specifications Minimum for 2 sensors Recommended for up to 5 sensors Recommended for up to 10 sensors Recommended for up to 100 sensors
CPU x64, single-core 1 GHz x64, quad-core 2 GHz x64, octa-core 2 GHz x64, octa-core 4 GHz
RAM 2 GB RAM 16 GB RAM 32 GB RAM 256 GB RAM
Free disk space 1 GB 10 GB 50 GB 500 GB
Internal network speed 100 Mbps 1000 Mbps 1000 Mbps 1000 Mbps
External network speed (to your Site) 20 Mbps 100 Mbps 300 Mbps 300 Mbps

Sensor system requirements

Specifications Minimum Recommended
CPU x64, single-core 1 GHz x64, dual-core 2 GHz
RAM 1 GB RAM 4 GB RAM
Free disk space 500 MB 1 GB
Network speed 100 Mbps 1000 Mbps

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:

  • tools\gatherlogs\gatherlogs.ps1
  • sensors\IT\logs\Lansweeper.IT.Sensor.log
  • sensors\OT\logs\Lansweeper.IT.Sensor.log
  • hub\logs\Lansweeper.Discovery.Hub.log
  • update\logs\Lansweeper.Discovery.Update.log
  • Windows Installer:
    • C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper_Network_Discovery_installer.log
    • C:\Users\%USERNAME%\AppData\Local\Temp\installbuilder_installer_00000.log (if the installation was not succesful)
    • C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper_Network_Discovery_uninstaller.log
    • C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper.IT.Hub.log
  • MacOS: /tmp/Lansweeper_Network_Discovery*.log

When reaching out to Lansweeper for troubleshooting, we offered a built-in log collector tool, so we have more info during the analysis of the issue.

Gather the logs on Windows using C:\Program Files\Lansweeper Network Discovery\tools\gatherlogs\gatherlogs.ps1(using an elevated PowerShell prompt). This will return a .zip file, which you share with our support department.

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. 
  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. 
  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
    #hubcode=MyHubCode generated in hub UI > Settings > Data transfer > Hub code (only required for distributed deployment of sensors across multiple systems, connecting to a remote hub)
  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. 
  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. 
  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.
        These packages are required to update Lansweeper repositories: ca-certificates and openssl.
      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. To install the Network Discovery hub, enter sudo env LINKING_CODE=cloudtokenvalue apt install lansweeper-network-discovery-hub
        • Optional: To install the IT sensor for your IT assets, enter sudo env HUB_CODE=MyHubCodeGeneratedinHubUI-Settings-DataTransfer-HubCode apt install lansweeper-network-discovery-it-sensor.
        • Option: To install the OT sensor for your OT assets, enter sudo env HUB_CODE=MyHubCodeGeneratedinHubUI-Settings-DataTransfer-HubCode apt install lansweeper-network-discovery-ot-sensor
        • After the install is done, set the hub location in this way:
      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.

Optional: Link your Linux sensor to a remote Windows/Linux/macOS Network Discovery hub

  1. Go to the install directory of the Linux sensor and open appsettings.json.
  2. For an IT sensor, change "HubUrl": "https://localhost:59525/IT/Sensor" to "HubUrl": "https://MyRemoteHubIPaddress:59525/IT/Sensor".
  3. For an OT sensor, change "HubUrl": "https://localhost:59525/OT/Sensor" to "HubUrl": "https://MyRemoteHubIPaddress:59525/OT/Sensor".
  4. Add a file called hubcode.txt (with chmod 744, encoding UTF-8) in your install directory. Paste the hub code retrieved from https://MyRemoteHubIPaddress:59525 > settings > data transfer > Hub in the hubcode.txt file.
  5. Once the file is saved, restart the sensor service using either of the following commands:
    • sudo systemctl restart lansweeper-network-discovery-it-sensor
    • sudo systemctl restart lansweeper-network-discovery-ot-sensor

      This will make the sensor retrieve the certificate from the hub (located in C:\Program Files\Lansweeper Network Discovery\hub\ssl\Lansweeper_Discovery_Internal_Communication.cer) and install it as a trusted certificate on the sensor. Next, the sensor will use the hub code to authenticate itself within the hub, making it a trusted new sensor.

Your sensor will appear as a newly added sensor in the list at https://MyRemoteHubIPaddress:59525/Sensors.

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:

    1. sudo dpkg -r lansweeper-network-discovery-ot-sensor
    2. sudo dpkg -r lansweeper-network-discovery-it-sensor
    3. sudo dpkg -r lansweeper-network-discovery-hub

  • Red Hat, CentOS, and SUSE:

    1. sudo rpm -e lansweeper-network-discovery-it-sensor
    2. sudo rpm -e lansweeper-network-discovery-ot-sensor
    3. sudo rpm -e lansweeper-network-discovery-hub

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

Link Network Discovery to Lansweeper Site

You can optionally add all results from Network Discovery to your inventory in Lansweeper Site.

  1. Open a browser and navigate to https://app.lansweeper.com.
  2. If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery.
  3. Go to Scanning > Discovery systems, and select Link discovery system.
  4. In the pop-up, select Create new code.
  5. Select an expiration period, select Apply and Copy code.
  6. Open the Lansweeper Network Discovery hub UI (hosted at https://localhost:59525 by default) and select Linking options.
  7. Select Cloud-based inventory for all assets.
  8. Enter your newly created code, and select Link with Lansweeper Site.

Remove Network Discovery from Lansweeper Site

If required, you can remove Network Discovery, all its sensors, and all data it has brought in from your Lansweeper Site:

  1. Open a browser and navigate to https://app.lansweeper.com.
  2. If you have multiple Lansweeper Sites, select the site you want to remove Network Discovery from.
  3. Go to Scanning > Discovery systems > All systems.
  4. Select the relevant Network Discovery system.
  5. Finally, select Delete system.
Removing a Network Discovery system from your Lansweeper Site will remove all linked sensors and all asset data it has ever brought in.

Next steps

Now that you've installed Network Discovery, learn how to Configure Network Discovery.

Frequently asked questions (FAQ)

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

0 Kudos

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:
Monday
li.common.scroll-to.top