Install Network Discovery

[sophie]

This page provides information on installing and configuring Network Discovery, currently in beta, allowing remote discovery of IT and OT assets.

---

Full Network Discovery is currently a beta feature with limited support and is subject to change. If you'd like to join the beta, sign up here.

Remotely discover more information about your IT and OT assets with Lansweeper's Network Discovery.

For a full comparison of Network Discovery versus IT Agent Discovery and OT Discovery, see New beta capability - Discover more asset details.

On this page:

• Requirements 
  • Beta requirements 
  • Supported operating systems 
• Install Network Discovery on Windows 
  • Install Network Discovery on Windows interactively 
  • Install Network Discovery on Windows silently 
  • Uninstall Network Discovery on Windows 
• Install Network Discovery on Linux
  • Uninstall Network Discovery on Linux 
• Install Network Discovery on macOS 
  • Install Lansweeper Network Discovery on macOS interactively  
  • Install Network Discovery on macOS silently 
  • Uninstall Network Discovery on macOS 
• Configure Network Discovery 

Requirements

Before installing Network Discovery, make sure the requirements below are met.

• Beta requirements
• Supported operating systems

Beta requirements

During Beta, Network Discovery can produce duplicate assets. To join the beta, log in to your Lansweeper Site, and go to Configuration > Site settings. Copy the Site ID, then fill in the sign up form here. We'll then enable Network Discovery on the site you've specified.

Optionally, you can resolve duplicate assets by going to Scanning > Discovery sources, unlinking the Network Discovery source(s), and removing all related data.

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 or higher (x64) 
• Ubuntu 16.04, 18.04, 20.04 or higher (x64)

.rpm packages:

• CentOS Linux 7 (x64)
• CentOS Stream Linux 8 (x64)
• Fedora 36 or higher (x64)
• openSUSE 15 or higher (x64)
• Oracle Linux 7 or higher (x64)
• Red Hat Enterprise Linux 7 or higher (x64)
• SUSE Enterprise Linux (SLES) 12 SP2 or higher (x64)

MacOS

• macOS 10.15 or higher (x64)

Install Network Discovery on Windows

Install Network Discovery on Windows interactively

1. Ensure the beta requirements are met, and 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 beta, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery sources.
4. Go to Scanning > Discovery sources > 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 source. 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 the beta requirements are met, and 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 beta, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery sources.
4. Go to Scanning > Discovery sources > 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 source. 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:
    
    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.

    Lansweeper-network-discovery-X.X.X-windows-x64-installer.exe --optionfile lansweepernetworkdiscoveryinstallation.cfg

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

Method 2

1. Ensure the beta requirements are met, and 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 beta, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery sources.
4. Go to Scanning > Discovery sources > 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 source. 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.
   
   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.

   Lansweeper-network-discovery-X.X.X-windows-x64-installer.exe --mode unattended --accepteula 1 --path "C:\Program Files\Lansweeper Network Discovery Discovery" --cloudtoken cloudtokenvalue

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 the beta requirements are met, and 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 beta, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery sources.
4. Go to Scanning > Discovery sources > 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 source. 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_x64.rpm.
     3. Enter sudo yum update to make the system aware of the repository.
     4. Enter sudo env LINKING_CODE=cloudtokenvalue yum install lansweeper-network-discovery-hub.
        • For the IT sensor, enter sudo env yum install lansweeper-network-discovery-it-sensor.
        • For the OT sensor, enter sudo env yum install lansweeper-network-discovery-ot-sensor.
     5. 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 the beta requirements are met, and 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 beta, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery sources.
4. Go to Scanning > Discovery sources > 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 source. 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 the beta requirements are met, and 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 beta, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery sources.
4. Go to Scanning > Discovery sources > 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 source. 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 sources > Download installers/packages.

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

Method 2 - DMG deployment

1. Ensure the beta requirements are met, and 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 beta, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery sources.
4. Go to Scanning > Discovery sources > 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 source. 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

Configure Network Discovery

Now that Network Discovery is installed, you need to check out the Hub and configure 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. You can also view you discovered assets in your Lansweeper Site Inventory.

To provide feedback or request support for Network Discovery, visit New beta capability - Discover more asset details.