Skip to main content

Autodiscovery

Device42 Autodiscovery jobs

Device42 offers a number of different autodiscovery tools, some of which are internal to Device42 while some run externally, as discussed below. You may run the autodiscovery tools in any combination and/or order that makes sense for your environment, and all can be run on a regular schedule, thus enabling the automation of a significant portion of your network documentation.

Start with the network

Running network discovery first is recommended, and is important because it lays the framework for rest of your discoveries. By discovering your network first, you bring in the in-use subnets that will contain all of the to-be-discovered IP addresses and construct the layer 2 framework by discovering VLANs with live MAC addresses. Note that this is not a requirement, but that if IPs are discovered before adding subnets, those IPs will end up in a "catch-all" subnet named "undefined". In this case, you can simply manually add relevant subnets before re-running the discovery.

Discovery credentials

WARNING: Please do not set up an autodiscovery / scan using critical production account credentials! Depending on permissions granted & your configured password policies, account lock-out could result in an otherwise completely avoidable outage. You, the customer, are responsible for any such behavior that might result if you choose to ignore this requirement.

Cloning Discovery Jobs

You can now clone an autodiscovery job while editing it to create a copy of the job with all its settings, which lets you replicate the job without having to manually re-enter all the job details. You can then modify the cloned job for your specific purposes. Click on a discovery Job Name in a View listing to select the job you want to clone and then click Edit. Click the ellipse menu in edit mode and then click Clone Job.

Enter a New Name for the cloned job and click Create.

Agent-based Discovery

There exist special situations in which an agent simply makes more sense, and for that reason, we over optional autodiscovery agents for many platforms. Learn more on the Device42 Agent-based discovery docs page.

Agent-based Offline Discovery & Upload Tool

There are some edge cases where discovery is desired but the network (or lack of network!) doesn’t allow communication back to the main Device42 appliance (for a variety of reasons).

Whether remote collectors can’t be deployed or policy simply doesn’t allow it, we've got the solution: See the Device42 Offline Agent-based discovery page here, or simply click here to download the Offline Discovery Data Processing Tool / Agent Log Upload Utility.

Blade systems Discovery

HP & IBM Blade System (or Blade Center) chassis and blade details can be discovered using SNMP. This is discussed in more detail at: Blade Systems Autodiscovery. Cisco UCS Manager is supported as well. You can grab chassis, blade, service profile information, and more. Details can be found at: cisco-ucs-auto-discovery

Cloud Platform Discovery

Connect to Amazon AWS, Alibaba Cloud, Microsoft Azure, Digital Ocean, Google Cloud, Linode, and Openstack from the cloud discovery under Discovery > Cloud. Cloud discovery details can be found here: Cloud Platforms Autodiscovery

DNS Autodiscovery

DNS autodiscovery is built into Device42, and can do zone transfer(s) from your DNS server(s). It can be run and/or scheduled from the Device42 web UI: Discovery > DNS Zone Sync (One way).

Hypervisor / *nix / Windows Autodiscovery

Hypervisors, Windows & Linux/UNIX discovery jobs can all be created using the main menu, Discovery -> HyperVisors / *nix / Windows.

  • Windows-based machine inventory details are discovered with WMI
  • Linux machines inventory details are discovered via SSH
  • VMWare hypervisor host and guest VM details are discovered using appropriate APIs <small(VMware, WMI)
  • Hyper-V hypervisors / guests are discovered as Windows machines using WinRM, and documented separately.

Click here for the VMware & VM discovery docs page, and find the Linux/UNIX discovery page here. Finally, learn more about Windows (and HyperV) discoveries are documented here.

IPMI Autodiscovery

Discover iLO, iDrac or other IPMI/BMC boards with basic hardware info and BMC IP and MAC address for a given IP range. If the server has already been discovered by OS level discovery methods, BMC IP and MAC address show up in device properties.

Discussed here in detail: discovery/ipmi-auto-discovery.md

Midrange / Mainframe discovery (IBM AS/400 and z/OS)

Device42 supports agent-less mainframe and mid-range discovery of both the IBM i / AS400 mid-range platform & the IBM z/OS mainframe platform.

Network / SNMP Autodiscovery

Run an SNMP discovery from the Device42 web UI main menu: Discovery > SNMP.

Using SNMP v1/v2c/v3 discovery for network devices, you can automate discovery of:

  • Network device inventory
  • Subnets/VLANs
  • IP to MAC associations
  • MAC to switch port associations
  • Switch port status and remote port associations

SNMP Network discovery is covered in more detail at: discovery/network-auto-discovery.mdx

Node data from Chef and Puppet

Send Ohai node data from Chef server to Device42: Sync node data from Chef https://github.com/device42/chef_to_device42_sync_py Sync puppet facts to Device42: Script to sync Puppet nodes information https://github.com/device42/puppet_to_device42_sync_py

Another Puppet integration script is available on API Autodisc repo that reads the YAML factor files and populates inventory details in Device42 using the RESTful API.

Other SNMP-based discovery

SNMP discoveries can also be used to discover many other types of devices: Power devices are usually discovered using SNMP, e.g. UPS, ATS, and other SNMP-compatible network-connected hardware; Many environmental sensors also support SNMP discovery/polling. To run an SNMP v1/v2c/v3 discovery against any SNMP-compatible endpoint, see the SNMP section of the SNMP/Network Discovery DOCS page.

Ping Sweep Utility

The open source, standalone ping sweep tool uses NMAP in the background to run ping sweeps against the selected network(s), uploading discovered IP, MAC, & reverse DNS details via Device42's the RESTful APIs; the tool is written in .NET.

There is also a ping sweep tool built in to Device42. Find it in the UI via the main menu, Discovery > Ping Sweep. (note that the UI based option, may, in the future, be depreciated, and that the standalone tool is much faster).

Remote Collector (RC)

The Device42 remote collector (RC) is a lightweight virtual appliance (a VM) that can be quickly deployed wherever is necessary, for example, places like a secure network segment. RCs can be selected to run autodiscovery jobs by simply choosing them when creating the job. Simply choose the desired RC from the "Remote Collector" drop-down when initially setting up a new autodiscovery job, or edit an existing discovery job, selecting the desired RC. Most autodiscovery jobs that can be launched from the Device42 "Discovery" menu support running from a deployed RC.

For more information, and full RC documentation, head to the dedicated Remote Collector page

Scripts for Linux, Solaris, Windows and Mac

Alternatively, there are a selection of open-source scripts on the Device42 GitHub page available for use: For Mac, Linux, and Solaris autodiscovery, use this repo: https://github.com/device42/nix_bsd_mac_inventory

Windows discovery scripts can be found here: Device42 GitHub repository. Windows scripts use PowerShell 2.0/iPython to get individual Windows host details and/or to get Windows machines from AD. Details are relayed to the Device42 Main Appliance (MA) via the API. The Linux, Solaris, and Mac scripts connect to remote servers using SSH to gather inventory data, sending that data back via Device42's RESTful API.

Using REST APIs

You can automate inventory management and integrate with your own scripts or other programs using the Device42 RESTful APIs as discussed at : Device42 API docs.

VMware / Citrix XenServer / oVirt / Redhat Virtualization / KVM

Hypervisors are discovered via the Device42 web UI: Discovery > HyperVisors / *nix / Windows. Using native APIs, Device42 connects to your VMWare vCenter server(s), ESX server(s), Citrix XenServer, oVirt, or Redhat Virtualization servers and retrieves host details, inventory details, and guest VM details.

Discussed in depth: discovery/virtual-machine-auto-discovery.md

Where next?

To dive deeper into specific Autodiscovery topics, take a look at this category's subpages in the sidebar.