The traffic sensor is currently in closed beta. Availability is limited, and setup and requirements may change during this phase.
If you’d like access, you can join the interest list.
Prerequisites
Review the Discovery Hub and Sensor requirements
Review the supported operating systems
Supported operating systems
We currently only support the following operating systems:
.deb packages:
Ubuntu 22.04 LTS (x64, current LTS and previous LTS)
.rpm packages:
Red Hat Enterprise Linux 8 (x64, current and previous minor release)
Access checklist
Before you start the installation and capture setup, confirm you have the access and permissions below.
Host access: SSH access to the sensor host, or console access
Privileges: a user account with
sudoorrootPackage install rights: permission to install required packages (for example
aptaccess)Capture permission: permission to read the traffic source (SPAN, TAP, or ERSPAN)
Install the sensor and hub
For ease of configuration and management during the beta phase, we strongly recommend deploying one dedicated hub per traffic sensor, with the hub and traffic sensor installed on the same machine.
In your preferred site, go to Discovery > Systems > Download installers/packages.
Select Network Discovery > Download Lansweeper repository package for the Linux Debian OS.
Alternatively, open a terminal and run:curl -L -o lansweeper-repository.deb https://download.lansweeper.com/deb-repository/stable/latestOpen a terminal and install the package you copied to your machine:
sudo dpkg -i ./lansweeper-repository.deb sudo apt updateIn your site, select Systems > Link discovery system > Create new code. Specify an expiration date, then select Apply and copy the generated code.
NOTE
The expiration date indicates when the linking code can no longer be used to establish a new connection between a site and your discovery system. Any existing connection between the system and your site will remain active after the expiration date.
Install the Network Discovery hub. Replace
YourCloudTokenHerewith your actual linking code and run:sudo env LINKING_CODE=YourCloudTokenHere apt install lansweeper-network-discovery-hubInstall the sensor. Replace
YourCloudTokenHerewith your actual linking code, andYourHubInstancewith the domain name where your hub is installed and run:sudo env HUB_CODE=YourCloudTokenHere HUB_INSTANCE=localhost HUB_PORT=59525 apt install lansweeper-network-discovery-traffic-sensorIf the sensor is not installed on the same host as the hub, replace
localhostwith your hub’s IP address or FQDN.
In your preferred site, go to Discovery > Systems > Download installers/packages.
Select Network Discovery > Download Lansweeper repository package for the Linux Red Hat OS.
Alternatively, open a terminal and run:curl -L -o lansweeper-repository.rpm https://download.lansweeper.com/rpm-repository/stable/latestOpen a terminal and install the package you copied to your machine:
sudo dnf install ./lansweeper-repository.rpm sudo dnf updateIn your site, select Systems > Link discovery system > Create new code. Specify an expiration date, then select Apply and copy the generated code.
NOTE
The expiration date indicates when the linking code can no longer be used to establish a new connection between a site and your discovery system. Any existing connection between the system and your site will remain active after the expiration date.
Install the Network Discovery hub. Replace
YourCloudTokenHerewith your actual linking code and run:sudo env LINKING_CODE=YourCloudTokenHere dnf install lansweeper-network-discovery-hubInstall the sensor. Replace
YourCloudTokenHerewith your actual linking code, andYourHubInstancewith the domain name where your hub is installed and run:sudo env HUB_CODE=YourCloudTokenHere HUB_INSTANCE=localhost HUB_PORT=59525 dnf install lansweeper-network-discovery-traffic-sensorIf the sensor is not installed on the same host as the hub, replace
localhostwith your hub’s IP address or FQDN.
Uninstall the sensor
On the host where the sensor is installed, run:
apt purge lansweeper-network-discovery-traffic-sensorAll information flows will stop after uninstalling the sensor.
On the host where the sensor is installed, run:
dnf remove lansweeper-network-discovery-traffic-sensorAll information flows will stop after uninstalling the sensor.
Next steps
Now that your hub and sensor are installed, the traffic sensor will immediately start to monitor traffic for new assets. Discovered assets will begin appearing in your site shortly after installation.
View assets discovered by the traffic sensor
To see a filtered view of all assets discovered by your traffic sensor:
Go to Discovery > Systems and select your traffic sensor.
Under Summary, locate the Assets section.
Select Open details to view all assets detected by this sensor.