Already a NinjaOne customer? Log in to view more guides and the latest updates.

Legacy Network Discovery for Networked Devices

Topic

This article describes how to use the NMS network discovery utility in your environment to detect and manage networked devices in your organization.

Environment

NinjaOne Network Management System (NMS)

Description

NMS Network Discovery allows you to scan your network for new devices and convert them to management by NinjaOne NMS. This process is separate from the current Network Discovery closed beta process and will be deprecated as part of the upcoming NinjaOne 13.0 release.

Refer to NinjaOne NMS: System Requirements before installing the NinjaOne Network Management System (NMS) agent.

View additional tutorials in our video library

Index

NMS Agent Architecture

This section describes the agent architecture of NinjaOne NMS.

  • To use NinjaOne's network management suite, deploy the NinjaOne NMS agent separately for every customer whose SNMP-capable devices you want to monitor.
  • The NMS agent is a separate installation from the NinjaOne monitoring agent, but you can install both agents in parallel. The NMS agent performs network discovery (manually) and will add the associated devices to the system.

The following diagram illustrates the NMS agent architecture:

Figure 1: The network discovery dataflow (click to enlarge)

Run NMS Network Discovery Ad Hoc

Follow these steps to perform a one-time scan and discovery.

  1. In the upper-right section of the NinjaOne console, click the + icon, then select Add device.
  2. Click NMS network discovery.
add_NMS network discovery.png
Figure 2: Adding through NMS network discovery (click to enlarge)
  1. The Network discovery (Ad Hoc) configuration modal will open. From the drop-down lists, select an organization and location. If an organization has only one area, the Location field should auto-populate based on the chosen organization.
  2. Select a device from the Network probe drop-down menu to perform the network discovery. This list will contain all online Windows devices with the NinjaOne Agent installed that are running one of the following operating systems:
    • Windows 10
    • Windows 11
    • Windows Server 2016
    • Windows Server 2019
    • Windows Server 2022
  3. In the IP targets box, enter comma-separated IP addresses, IP ranges, and subnets for your discovery range. For example:
    • 192.168.1.1, 192.168.1.2, 192.168.1.3
    • 192.168.1.1 - 192.168.1.50
    • 192.168.1.0/24
  4. If your credential is not listed, click Create credential, then select a credential type (SNMP v1, SNMP v2, SNMP v3, Telnet, or SSH). New fields will be displayed as shown in the Credential Types table below.
NMSNEET_Settings.png
Figure 3: Configure and run discovery (click to enlarge)

SNMP Considerations

Network Discovery uses SNMP to discover, profile, and monitor your devices.

  • SNMP community leverages a string to access the router network device, and is only available with the SNMPv1 and SNMPv2c protocols.
  • SNMPv3 requires username/password authentication and an encryption key.

Credential Types

Credential TypeCredential Settings
SNMP v1 and v2
  • Name
  • Port
  • Community String
SNMP v3
  • Name
  • Port
  • (Optional) Context
  • Username
  • Authentication Type
    • From the drop-down list, select an authentication type or select None.
  • Password
  • Confirm Password
  • Encryption Type
    • From the drop-down list, select an encryption type or select None.
Telnet/SSH
  • Name
  • Type
  • Username
  • Password
  • Confirm Password
  • Enable Username
  • Enable Password
  • Confirm Enable Password

When you have completed your entries, click Add. Your credentials are now available from the Credential drop-down lists.

Additional Credential Options

As an option, you can select an additional credential:

  • From the second SNMP drop-down menu: If necessary, NinjaOne will also try this credential in addition to the first one selected.
  • From the Telnet/SSH drop-down menu: NinjaOne uses Telnet/SSH credentials to back up the configuration.

Applying Ping Conditions Through Additional Settings

Ping is useful for testing network connectivity by sending data packets and measuring the response time.

SettingDescription
Ping timeout (ms)Specify how long to wait for a reply, in milliseconds. The initial packet is sent, waits for a reply, and gives up at a preset timeout.
Ping packet TTLAllows you to set TTL (time to live) at a specified threshold.
Pings per nodeSpecifies the number of pings sent to each host to test if the host successfully responds to each.
Delay between pings (ms)Specify the number of milliseconds that pass between each ping.

For any device not previously used as a network probe, NinjaOne will create a new service that promotes the device to become the NMS delegate. The service is named Ninja NMS Manager Service, and the corresponding process name is nmsmanager.exe.

To apply ping conditions for network discovery:

  1. Click Advanced settings.
add_NMS network discovery_modal_advanced settings.png
Figure 4: Advanced network discovery settings (click to enlarge)
  1. If your device is not local (for example, on a VPN), We suggest increasing the ping timeout and TTL. Click Apply and then click Run Discovery. You can also click the X in the upper-right corner of the modal at any time to stop the current discovery process.
add_NMS network discovery_advanced settings_modal.png
Figure 5: Configure advanced network discovery settings (click to enlarge)

Add Devices to Your Organization

Once network discovery is complete, select the checkboxes to add one or more devices to your organization.

SSH is required and should only be available on the default port 22. If the Telnet/SSH column contains a green check mark, you have correctly configured the device for configuration backups to show in NinjaOne.

To cancel the process, click Stop discovery, then click Back to adjust your discovery configuration settings.

  1. From the IP type drop-down menu, refine your search by selecting one of the following:
    • All IPs
    • All responding
    • All SNMP responding
    • Existing devices
    • Offline devices
  2. Click Review to finalize your selections.

Important Notes

  • You can use the search box to locate specific devices.
  • While all discovered devices will be in the selected organization, you can change the location of individual devices after adding them to NinjaOne from the Search tab or the device settings.
  • You cannot select devices already added to your organization.

Assign Device Roles

The device role determines which NinjaOne NMS policy this device will use. On the Review page, assign a role to each device in the Device role column if the system did not determine its role during discovery.

  1. Select one or more devices in the list, then click Edit.
  2. Select a role from the drop-down menu, then click Apply. To edit device details, click a device row, adjust the device name and role, then click Apply. You can also change a device's role after adding it to your organization. To learn how to edit device roles, refer to NinjaOne Endpoint Management: Device Roles.
NetworkDiscovery_EditDeviceDetails_NoDrop.png
Figure 6: Edit device detailss options (click to enlarge)
  1. When your device review is complete, click Finish, then click Confirm. To return to the Review page, click Cancel.
  2. When the success notification window appears, click Close, or click Network probe to view the discovery device details. On the Network Probe device Overview tab, navigate to General Monitoring Hosts to view the devices added through network discovery.
NetworkDiscovery_MonitoredHosts.png
Figure 7: The device overview (click to enlarge)

In NinjaOne, you can now view your discovered devices in the Devices list, ordered by device name, associated customer, and assigned policy (which is dictated by the device role). For more information, refer to Find and Manage Endpoints from the Devices Search Page.

FAQ

Next Steps