Setup Guide : Network-Based Asset Discovery Tool

Wavity offers a Network-Based Asset Discovery tool designed to help you automatically detect devices connected to your network. By scanning your network, the tool identifies all devices and creates or updates corresponding asset records within the Wavity application.

It achieves this by utilizing the MAC address of each device, which serves as a unique identifier, allowing the system to accurately track and manage assets. This ensures that the information within the Wavity platform stays current and reliable, helping you maintain an up-to-date inventory of all devices across your network for better visibility and management.

This guide walks you through the process of setting up and using the Network-Based Asset Discovery tool, so you can efficiently manage your network assets.

Prerequisites

Before beginning the setup, ensure you have the following:

1. Host Machine: A Linux machine (or compatible environment) to run the Wavity Discovery utility.

2. Docker Installation: Docker must be installed on the host machine.

3. Wavity Network Utility Docker Image: Download the image from Docker Hub (Wavity Network Utility).

4. Defined IP Address Range: Determine the IP range for scanning, targeting the specific network segments where your assets reside.

Step 1: Running the Docker Image for the Network Scan

Before starting the scan, confirm that you have already configured the mapping of network scan results to the appropriate fields in your Wavity environment (see Step 2).

Execute the following command to launch the scan:

docker run \

--network host \

--env TENANT_URL="https://{tenant_url}/oneteam/customer/shared/devices" \

--env SCAN_INTERVAL="5" \

--env SCAN_NETWORK="<IP Address range>" \

--env SCAN_MAX_RETRIES="0" \

--env SCAN_HOST_TIMEOUT="5" \

--env SCAN_VERBOSE="true" \

--env SCAN_EXTRA_OPTIONS="-Pn" \

wavity/netscan:2.0.0-SNAPSHOT

Key Parameters:

• TENANT_URL: Your unique Wavity link (e.g.,

https://acme.wavity.com/oneteam/customer/shared/devices).

• SCAN_INTERVAL: The interval between scans, for example, 5 seconds.

• SCAN_NETWORK: The target IP range to scan (e.g., 192.168.32.0/24).

This command searches your network, automatically adding new devices as assets and updating existing ones based on their MAC addresses.

Step 2: Mapping Network Scan Results to Wavity

To ensure discovered devices are stored correctly in Wavity, complete this one-time configuration:

1. Access the Asset Discovery Section:

  • Log into Wavity and navigate to the General Settings page.
  • Locate the Asset Discovery section (Note: This page is accessible only by administrators).

2. Configure Application and Field Mapping:

  • Select the Wavity application where the devices should be recorded.
  • Map the relevant fields (such as asset type, MAC address, and IP address) to ensure accurate data capture.
  • Click Save to finalize the configuration.

This setup guarantees that scan results are correctly integrated into your asset management system.

Step 3: Managing Scan Results and Assets

After the scan completes, the Network-Based Asset Discovery Tool automatically manages your assets:

  • New Assets: Any devices discovered during the scan are added as new assets.
  • Updated Assets: Existing devices are updated with the latest information

This automated process ensures that your asset management is always up-to-date, eliminating manual data entry and reducing the chances of errors.

‍