Running your first discovery scan

↩ Getting Started

Network discovery scans a subnet — or queries a vendor controller — to find devices automatically and add them to your inventory. This is the fastest way to populate JOATOS.

Before you start

• At least one site with a Site Collector assigned.
• Any credentials the scan needs (e.g. an SNMP community string).

Creating a discovery source

1. Select Discovery in the sidebar (Network Discovery).
2. Select Add Source.
3. Fill in the form:
   • Name — e.g. Main Office SNMP.
   • Method — choose one of:
     • SNMP Subnet Scan — sweep a subnet via SNMP
     • UniFi Controller — pull devices from a UniFi controller
     • Aruba CX Switch — query an Aruba CX switch
     • MikroTik Router — query a MikroTik router
     • ICMP Ping Only — find live hosts by ping, without polling
   • Site — which site this scan belongs to.
   • Subnet (CIDR) — for subnet/ICMP methods, e.g. 192.168.1.0/24.
   • Device Host / IP — for controller/device methods, the address to query.
   • Saved Credential — choose a stored credential, or enter details inline.
   • Scan Interval — how often to rescan: 5 minutes, 15 minutes, 30 minutes, 1 hour, 6 hours, or 24 hours.
   • Enabled — leave checked to activate.
4. Select Create Source.

Running a scan

• Each source runs automatically on its scan interval.
• To run one immediately, select the Run scan (play) icon on that source.

Reviewing results

The Recent Scans section lists each run with a status badge — Pending, Running, Completed, or Failed — and a summary such as "12 found, 3 new, 9 updated". Select a scan to see its detail and log.

Discovered devices are added to your inventory and appear under Devices. From there you can set their type, link them to assets, and refine monitoring.

Notes & tips

• Ping All Devices on the Discovery page triggers an immediate ICMP check across your monitored devices.
• For API methods you can tick Queue device even if API unavailable to still record a basic entry when the host answers a ping.
• Re-running a scan updates existing devices rather than creating duplicates.

Related

• Devices
• Adding your first credentials
• Creating your first site