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

TL;DR-Sweepy-Icon (1).png
This page describes installing the Lansweeper IT Agent Discovery on Windows, Linux, and MacOS including requirements and installation instructions.


IT Agent Discovery is currently a preview feature, so please anticipate occasional adjustments and improvements as we refine its performance. If you'd like to give feedback, you can join the IT Agent Discovery conversation.

Lansweeper's IT Agent Discovery is a lightweight, cross-platform scanning agent that can run on Windows, Linux, and Mac computers. IT Agent Discovery automatically collects an inventory from the computer it's installed on, securely sends scanned data to your Lansweeper Site over HTTPS, and can scan computers outside your network and over the internet.

On this page:

Benefits of IT Agent Discovery

IT Agent Discovery offers a range of advantages compared to other scanning agents, including:

  • Direct Discovery Results: IT Agent is able to transmit discovery results directly to your Lansweeper Site, eliminating the need for a Lansweeper On-premises scan server.
  • Cross-Platform Auto-Updates: IT Agent can automatically update Windows, Linux, and macOS machines, expanding beyond the Windows-only auto-update capability of LsAgent.
  • Expanded Device Data: IT Agent gathers comprehensive data on devices, including additional information like user details on macOS. This enriched dataset is mapped within your Lansweeper Site, providing enhanced visibility of your network.
  • Silent Installation Across Platforms: IT Agent supports silent deployment on Windows, Linux, and macOS. This empowers administrators to implement the agent seamlessly, minimizing disruptions to end-users. In contrast, LsAgent restricts silent installs to Windows.
  • Reduced Vulnerability Risk: IT Agent for Windows, built on .NET 6.0, mitigates vulnerability risks in comparison to LsAgent for Windows.

Is IT Agent Discovery or LsAgent right for me?

While IT Agent Discovery offers many advantages, it may not be the optimal choice for every environment. To determine the right scanning agent for your needs, consider the following questions:

  • Do you primarily use Lansweeper Sites to view and manage your assets rather than Lansweeper On-premises?
  • Does the computer you want to scan have internet access?
  • Does the Windows computer you want to scan run on Windows 7 SP1 or Server 2012 or later?

If you've answered YES to all of these questions, then IT Agent Discovery is right for you.
If you've answered NO to any of these questions, then install LsAgent instead.

Requirements

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

Connection requirements

The computer running IT Agent Discovery must allow the following outbound connections to connect to the IT agent.

URL Description
https:// discovery-gateway.lansweeper.com/  Authenticates, logs in, and syncs data to Lansweeper Sites.

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

Supported operating systems

The IT Agent Discovery can be installed on the following operating systems.

Windows

  • Windows 7 SP1 (with extended security updates installed) and 8.1 (x64)
  • Windows 10 1607 or higher (x64)
  • Windows 11 22000 or higher (x64)
  • Windows Server 2012 or higher (x64)

Linux

.deb packages:
  • Debian 10 or higher (x64) (Internal only: Arm64 might follow)
  • Ubuntu 16.04, 18.04, 20.04 or higher (x64) (Internal only: Arm64 might follow)
.rpm packages:
  • CentOS Linux 7 (x64)
  • CentOS Stream Linux 8 or higher (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 IT Agent Discovery on Windows

You can use three methods to install the IT Agent Discovery on a Windows computer.

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

Install IT Agent Discovery on Windows interactively 

  1. Ensure the connection requirements are met and your Windows operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. Choose the Lansweeper Site to which you want to link the IT Agent Discovery. 
  4. Go to Scanning > Discovery sources, then go to Download installers/packages > Download IT Agent installer.
  5. Run the downloaded installer.
  6. Select Yes to allow the app to make changes to your device.
  7. Select I accept the agreement.
  8. Choose the installation directory and select Next.
  9. While keeping the installer open, open a browser and navigate to your Lansweeper Site.
  10. Go to Scanning > Discovery sources > Link discovery source and select Copy linking code.
  11. Paste the Lansweeper linking code, then select Next.
  12. Select Next to begin the installation.

Once the installation is complete, you can view your IT Agent Discovery in your Lansweeper Site by going to Scanning > Discovery sources > All sources.

Install IT Agent Discovery on Windows silently

Method 1

  1. Ensure the connection requirements are met, and your Windows operating system is supported.
  2. In your Lansweeper Site, go to Scanning > Discovery sources, then go to Download installers/packages. Select Download IT Agent installer and Download IT Agent silent installation configuration.
  3. Select Link discovery source or Link an Installation, then Copy linking code.
  4. On your Windows computer, open the downloaded lansweeperitagentinstallation.cfg file.
  5. 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 IT Agent Discovery
    cloudtoken=cloudtokenvalue
    #proxyserver=myproxyserver.domain.local
    #proxyport=8080
  6. In an elevated command prompt, enter the following command, replacing X.X.X in Lansweeper-IT-agent-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 > Discovery sources > Download installers/packages > IT Agent installer > Version and locate your installer.
    Lansweeper-IT-agent-discovery-X.X.X-windows-x64-installer.exe --optionfile lansweeperitagentinstallation.cfg

Once the installation is complete, you can view your IT Agent Discovery in your Lansweeper Site by going to Scanning > Discovery sources > All sources.

Method 2 

  1. Ensure the connection requirements are met, and your Windows operating system is supported.
  2. In your Lansweeper Site, go to Scanning > Discovery sources, then go to Download installers/packages > Download IT Agent installer.
  3. Select Link discovery source or Link an Installation, then Copy linking code.
  4. 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-IT-agent-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 > Discovery sources > Download installers/packages > IT Agent installer > Version and locate your installer.
    Lansweeper-IT-agent-discovery-X.X.X-windows-x64-installer.exe --mode unattended --accepteula 1 --path "C:\Program Files\Lansweeper IT Agent Discovery" --cloudtoken cloudtokenvalue

Once the installation is complete, you can view your IT Agent Discovery in your Lansweeper Site by going to Scanning > Discovery sources > All sources.

Uninstall IT Agent Discovery on Windows

To uninstall the IT Agent Discovery on WIndows, either:

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

Install IT Agent Discovery on Linux

Only silent installs are currently supported for the IT Agent Discovery on Linux.

Install IT Agent Discovery on Linux silently

  1. Ensure the connection requirements are met, and your Linux operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. Choose the Lansweeper Site to which you want to link the IT Agent Discovery. 
  4. Go to Scanning > Discovery sources, then go to Download installers/packages and navigate to the IT Agent Discovery section.
  5. Locate the Linux OS and select Download IT Agent repository package for deb or rpm, depending on your Linux distribution. 
  6. Select Link discovery source or Link an Installation, then Copy linking code.
  7. 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-it-agent.
      5. Once there is an update, update the package by entering sudo apt update && apt upgrade lansweeper-it-agent
    • 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-it-agent.
      5. Once there is an update, update the package by entering sudo yum update && yum upgrade lansweeper-it-agent

Once the installation is complete, you can view your IT Agent Discovery in your Lansweeper Site by going to Scanning > Discovery sources > All sources.

Uninstall IT Agent Discovery on Linux

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

Debian and Ubuntu: sudo dpkg -r lansweeper-it-agent 

Red Hat, CentOS, and SUSE: sudo rpm -e lansweeper-it-agent

Install IT Agent Discovery on macOS

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

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

Install IT Agent Discovery on macOS interactively

  1. Ensure the connection requirements are met, and your macOS operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. Choose the Lansweeper Site to which you want to link the IT Agent Discovery. 
  4. Go to Scanning > Discovery sources, then go to Download installers/packages and navigate to the IT Agent Discovery section.
  5. Locate the macOS with DMG format. Select Download IT Agent disk image to download the installer.
  6. Run the IT Agent 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.
  7. Select I accept the agreement > Next.
  8. Select the installation directory. By default, the directory is /Library/Application Support/Lansweeper IT Agent Discovery. Select Next.
  9. While keeping the installer open, open a browser and navigate to your Lansweeper Site.
  10. Go to Scanning > Discovery sources > Link discovery source and select Copy linking code.
    Linking with cloud 14.png
  11. Paste the Lansweeper linking code in the installer, then select Next.

Once the installation is complete, you can view your IT Agent Discovery in your Lansweeper Site by going to Scanning > Discovery sources > All sources.

Install IT Agent Discovery on macOS silently

Method 1 - PKG deployment

  1. Ensure the connection requirements are met, and your macOS operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. Choose the Lansweeper Site to which you want to link the IT Agent Discovery. 
  4. Go to Scanning > Discovery sources, then go to Download installers/packages and navigate to the IT Agent Discovery section.
  5. Select Download IT Agent package and IT Agent Discovery macOS package silent installation configuration to download both files.
  6. Go to Scanning > Discovery sources > Link discovery source and select Copy linking code.
  7. In the downloaded IT Agent 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/LansweeperITAgent-Preinstall.cfg" # Don't change this path!
    [ -f $PreinstallConfig ] && chmod 744 $PreinstallConfig
    cat > $PreinstallConfig << EOF
    mode=unattended
    accepteula=1
    path=/Library/Application Support/Lansweeper IT Agent Discovery
    cloudtoken=cloudtokenvalue
    #proxyserver=myproxyserver.domain.local 
    #proxyport=8080
    EOF
    chmod 744 $PreinstallConfig
  8. Enter the following command: sudo ./tmp/LansweeperPreinstallScript.sh
  9. Enter the following command, replacing X.X.X in LansweeperITDiscovery-X.X.X with the version number of your installer: sudo installer -pkg Lansweeper-IT-agent-discovery-X.X.X-osx-installer.pkg -target /
    Note: The version numbers for your installer can be found in your Lansweeper Site. Go to Scanning > Discovery sources > Download installers/packages.

Once the installation is complete, you can view your IT Agent Discovery in your Lansweeper Site by going to Scanning > Discovery sources > All sources.

Method 2 - DMG Deployment

  1. Ensure the connection requirements are met and your macOS operating system is supported.
  2. Open a browser and navigate to https://app.lansweeper.com.
  3. Choose the Lansweeper Site to which you want to link the IT Agent Discovery. 
  4. Go to Scanning > Discovery sources, then go to Download installers/packages and navigate to the IT Agent Discovery section.
  5. Select Download IT Agent disk image to download and store the .dmg file on your machine.
  6. Go to Scanning > Discovery sources > Link discovery source and select Copy linking code.
  7. In an elevated command prompt, enter hdiutil attach Lansweeper-IT-agent-discovery-0.9.0-16-osx-installer.dmg to mount the dmg file.
  8. Enter cd "/Volumes/Lansweeper IT Agent Discovery" to navigate to the volume.
  9. Enter the following command, replacing cloudtokenvalue with the copied linking code and replacing X.X.X in Lansweeper-IT-agent-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-IT-agent-discovery-X.X.X-X-osx-installer.app/Contents/MacOS/installbuilder.sh --mode unattended --accepteula 1 --path "/Library/Application Support/Lansweeper IT Agent Discovery" --cloudtoken cloudtokenvalue

Once the installation is complete, you can view your IT Agent Discovery in your Lansweeper Site by going to Scanning > Discovery sources > All sources.

Uninstall IT Agent Discovery on macOS

To uninstall IT Agent Discovery on macOS, you can either:

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

Was this article helpful? Yes No
25% helpful (1/4)

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:
‎03-06-2024 01:31 PM
Updated by: