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
Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type.
Showing results for 
Show  only  | Search instead for 
Did you mean: 

Install IT Agent Discovery

sophie
Lansweeper Employee
Lansweeper Employee

on ‎06-26-2023 01:38 PM - edited Friday by 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.

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 using TLS 1.2 or higher:

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 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 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
CPU x64, single-core 1 GHz x64, dual-core 2 GHz
RAM 2 GB RAM 8 GB RAN
Free disk space 500 MB 1 GB
Network speed 100 Mbps 1000 Mbps

Installation paths and logs

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

  • Windows: C:\Program Files\Lansweeper IT Agent Discovery
  • Linux: /opt/lansweeper-it-agent
  • macOS: /Application Support/Lansweeper IT Agent 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_IT_Agent_Discovery_installer.log
    • C:\Users\%USERNAME%\AppData\Local\Temp\installbuilder_installer_00000.log (if the installation was not successful)
    • C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper.IT.Hub.log
    • C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper_IT_Agent_Discovery_uninstaller.log
  • MacOS: /tmp/Lansweeper_IT_Agent*.log

When contacting 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 IT Agent Discovery\tools\gatherlogs\gatherlogs.ps1 (using an elevated PowerShell prompt). This will return a .zip file, which you share with our support department.

he default path to check the status of your IT Agent: https://localhost:59530/status/hub or https://localhost:59530/status (as soon as IT Agent is a single file)

Install IT Agent Discovery on Windows

You can also run IT Agent Discovery on Windows computers as a foreground application, included as a logon script. For more information, see Set up and run IT Agent Portable. 

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 systems, 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. Select Link Discovery system. In the pop-up, select Create new code.
  11. Choose an expiration date, select Apply and select Copy code.
  12. Paste the Lansweeper linking code in the installer, then select Next.
  13. 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 systems > All systems. You can view the asset details discovered with your IT Agent Discovery in Inventory > All assets.

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 systems, then go to Download installers/packages. Select Download IT Agent installer and Download IT Agent silent installation configuration.
  3. Select Link Discovery system. In the pop-up, select Create new code.
  4. Choose an expiration date, select Apply and select Copy code.
  5. On your Windows computer, open the downloaded lansweeperitagentinstallation.cfg file.
  6. 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
  7. 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 systems > 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 systems > All systems. You can view the asset details discovered with your IT Agent Discovery in Inventory > All assets.

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 systems, then go to Download installers/packages > Download IT Agent installer.
  3. Select Link Discovery system. In the pop-up, select Create new code.
  4. Choose an expiration date, select Apply and select Copy code.
  5. 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 systems > 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 systems > All systems. You can view the asset details discovered with your IT Agent Discovery in Inventory > All assets.

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 systems, 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 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. If you are not using a proxy, enter sudo env LINKING_CODE=cloudtokenvalue apt install lansweeper-it-agent.
        If you are using a proxy, enter sudo env LINKING_CODE=cloudtokenvalue proxyserver=myproxyserver.domain.local proxyport=8080 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_64.rpm.
      3. Enter sudo yum update to make the system aware of the repository.
      4. If you are not using a proxy, enter sudo env LINKING_CODE=cloudtokenvalue yum install lansweeper-it-agent.x86_64.
        If you are using a proxy, enter sudo env LINKING_CODE=cloudtokenvalue proxyserver=myproxyserver.domain.local proxyport=8080 yum install lansweeper-it-agent.x86_64.
      5. Once there is an update, update the package by entering sudo yum update && yum upgrade lansweeper-it-agent.x86_64. 

Once the installation is complete, you can view your IT Agent Discovery in your Lansweeper Site by going to Scanning > Discovery systems > All systems. You can view the asset details discovered with your IT Agent Discovery in Inventory > All assets.

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 systems, 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 systems and select Link Discovery system. In the pop-up, select Create new code.
  11. Choose an expiration date, select Apply and select Copy code.
  12. 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 systems > All systems. You can view the asset details discovered with your IT Agent Discovery in Inventory > All assets.

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 systems, 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 systems and 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 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
  9. Enter the following command: sudo ./tmp/LansweeperPreinstallScript.sh
  10. 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 systems > Download installers/packages.

Once the installation is complete, you can view your IT Agent Discovery in your Lansweeper Site by going to Scanning > Discovery systems > All systems. You can view the asset details discovered with your IT Agent Discovery in Inventory > All assets.

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 systems, 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 systems and 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-IT-agent-discovery-0.9.0-16-osx-installer.dmg to mount the dmg file.
  9. Enter cd "/Volumes/Lansweeper IT Agent 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-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 systems > All systems. You can view the asset details discovered with your IT Agent Discovery in Inventory > All assets.

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

Next steps

Now that you've finished installing IT Agent Discovery, learn how to configure IT Agent Discovery.

Frequently asked questions (FAQ)

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

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

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:
Friday
Updated by:
Lansweeper Tech Support