This documentation applies to NMS version 5.4. An online version of the software can be found here.
The Discovery Manager enables you to manage discovery and to scan your network for everything that SevOne NMS can ping. This enables you to add multiple devices into SevOne NMS so that you can monitor the data from your network.
To access the Discovery Manager from the navigation bar, click the Devices menu and select Discovery Manager.
The Discovery Manager has four tabs.
The Watched Subnets tab enables you to define subnet blocks and IP address ranges to ping anything that is able to be pinged in specific segments of your network.
The Candidates tab displays everything in the network segments that was successfully pinged. The Candidates tab enables you to add anything that was successfully pinged into SevOne NMS for data collection, reports, alerts etc.
The Discovery Queue tab appears selected by default to enable you to view the status of the discovery of the object on the devices that are in SevOne NMS.
The Device Notes tab enables you to view the notes discovery creates. These notes help you troubleshoot plugin configuration issues and enable you to communicate such things as device outage plans.
The Discovery Queue tab displays the status of the discovery of the objects on the devices that are in SevOne NMS. This tab does not display information about candidates because objects on candidates are not discovered or polled by SevOne NMS.
There are two concurrent discovery queues.
High Priority Queue - For devices in the high priority discovery queue, SevOne NMS first discovers the device that was most recently queued with the high priority followed by the other devices in the high priority queue in the last in first out sequence.
Low Priority Queue - For devices in the low priority discovery queue, SevOne NMS first discovers the device that has been in the low priority queue the longest in the first in first out sequence.
There are two discovery processes.
Manual Discovery - The Manual Discovery process runs every two minutes to discover objects such as interfaces, CPUs, and their indicators on the devices you manually mark for discovery on the Device Manager. Typically the Manual Discovery process runs in the high priority queue but you can choose to decrease the Manual Discovery process to the low priority queue.
Automatic Discovery - The Automatic Discovery process runs as you schedule it to occur on the Cluster Manager Peer Settings tab to discover interfaces, CPUs, etc. on all devices in SevOne NMS even if you do not mark the device for discovery. Automatic Discovery runs in the low priority discovery queue.
The Discovery Queue tab displays the following information. Click Cancel All or select the check box for each device on which to stop discovery and click Cancel Selected to stop discovery.
Device Name - Displays the device name.
Queue - Displays Low for the low discovery queue or displays High for the high discovery queue.
Start Time - Displays the time the discovery process started.
Peer – Displays the name of the peer that performs the discovery and polls the device.
Core - Displays the identification of the core discovery process. A core discovery process spawns multiple discovery threads. Threads with the same Core ID are created by the same process.
Thread - Displays the identification of the thread that is currently performing the discovery action. A thread only discovers one device and then the thread is destroyed.
CPU % - Displays the percentage of CPU usage when the device is discovered.
Mem % - Displays the percentage of memory that the discovery action consumes. Discoveries with abnormally high memory usage may indicate a problem with the polled device. The discovery thread terminates when it consumes too much memory.
The Watched Subnets tab displays the list of subnets to scan for candidates and devices in your network.
Subnet Name - Displays the name of the subnet to scan.
Start IP Address - Displays the low end of the IP address range to scan.
End IP Address - Displays the high end of the IP address range or the subnet mask to scan.
Scan Time - Displays the scan start time when you schedule the subnet scan to occur on a regular basis.
Scan Time Zone - Displays the time zone for the scheduled scan time.
Scan Peer - Displays the name of the peer that performs the scan of your network.
Scan Action - Displays Add Device when anything the scan finds is to be added to SevOne NMS as a device on the Device Manager for discovery and polling. Displays Add Candidate when anything the scan finds is displayed on the Candidates tab on the Discovery Manager. No objects are discovered on candidates and no metrics are polled from candidates.
Scan Schedule - Displays schedule information when you schedule the subnet to scan on a regular basis. When this column is clear, the subnet is scanned when you select the check box and click Scan Now.
Check SNMP - Displays Yes when enable the device to send SNMP data to SevOne NMS or displays No when SevOne NMS does not find SNMP data on the device.
The Watched Subnets tab enables you to create any number of subnet blocks and IP address ranges to scan your network on a regular schedule for items that can be pinged.
Click Cancel Scan to cancel all scans that are currently in progress or select the check box for specific subnets and click Cancel Scan.
Click Scan Now to start a scan of all subnets or select the check box for specific subnets and click Scan Now.
Perform the following steps to add a subnet.
Click Add Subnet to display the Add Subnet pop-up.
In the Subnet Name field, enter the name of the subnet block or IP address range.
Click the Peer drop-down and select the peer that is to send out the ping commands to the network segment.
Click the Action drop-down.
Select Add Device to add everything that is able to be pinged to the Device Manager for object discovery and data polling.
Select Add Candidate to display everything that is able to be pinged on the Candidates tab where you can select specific candidates to add to the Device Manager for object discovery and data polling. No metrics are collected from candidates.
Select the Check SNMP check box to validate that the device/candidate is enable to send SNMP data to SevOne NMS.
Click Schedule field to display the Scan Time pop-up. If you do not schedule the subnet, the scan occurs only when you click Scan Now.
Click the Days tabs to scan the network on the dates that appear with a darker shade. Click Weekends to scan on weekends and/or click Weekdays to scan on weekdays.
Click the Start Time drop-down and select the time to start the scan.
Click the Time Zone drop-down and select a time zone.
Click Add to add the scan time to the Selected list.
Repeat these steps to add additional scan times. Each scan time must be unique.
Click Save to save the scan times.
To create an IP address range, select the IP Address Range option and perform the following steps.
In the Start IP Address field, enter the low end of the IP address range.
In the End IP Address field, enter the high end of the IP address range.
To create a subnet block, select the Subnet Block option and perform the following steps.
In the IP Address field, enter an IP address.
In the Subnet Mask field, enter a subnet mask.
Select the Create Device Group for Subnet check box to create a device group for the devices you add to SevOne NMS as a result of the scan for the subnet.
Click Add to add the block or range to the list to watch.
Repeat the previous steps to create additional ranges.
If you do not schedule the subnet to scan on a regular basis, select the check box for the subnet and click Scan Now. If you schedule the subnet to scan on a regular basis the subnet is scanned on the schedule you define until you remove the subnet.
The Candidates tab displays the results of the scans that occur from the Watched Subnets tab. Click on a row to display additional information. The Edit Device topic describes this additional information. For a candidate, the additional information section enables you to add the candidate as a device and to edit the SNMP settings to attempt to detect SNMP availability. If you choose to add a candidate to SevOne NMS, you can change these settings on the Edit Device page. Candidates are grouped by the subnet scan that found the candidate and enable you to contract or expand each subnet group section.
Candidate Name – Displays the candidate/device name.
IP Address – Displays the candidate/device IP address.
Pingable – Displays when SevOne NMS can ping the candidate/device or displays when SevOne NMS cannot ping the candidate/device.
SNMP – Displays when you enable the candidate/device to send SNMP data to SevOne NMS or displays when SevOne NMS cannot detect SNMP availability on the candidate/device.
Peer – Displays the name of the peer that would discover and poll the device if you were to add the candidate to SevOne NMS.
Status – Displays one of the following.
Candidate – Black normal font indicates this is a candidate. No objects are discovered and no metrics are polled for reports or alerts from a candidate. You must add the candidate as a device to SevOne NMS if you want to poll the objects on the device for metrics to include in reports and alerts.
In Progress – This candidate is being added as a device to SevOne NMS but no objects have been discovered on the device and no poll metrics are available for reports or alerts.
In SevOne NMS – Blue italic font indicates the device is in SevOne NMS and data is being polled and monitored for reports and alerts. The Device Manager displays all devices in SevOne NMS.
Blocked – Red italic font indicates a candidate is blocked and you cannot add the candidate as a device to SevOne NMS.
- Click next to a candidate to edit the IP Address and Peer columns and to display additional information.
The additional information section on the right displays the settings that would be used in the device configuration should you choose to add the candidate as a device to SevOne NMS. The additional information provides the following buttons.
Click Add Device to add the candidate as a device in SevOne NMS. You can then edit these configuration settings on the Edit Device page.
Click Edit SNMP Settings to edit the candidate SNMP settings.
Perform the following steps to filter the candidates that display in the list.
Select the check box for each candidate to manage, click , and select the following options.
Select Block to prevent the candidate from being added as device to SevOne NMS.
Select Unblock to enable users to add the candidate as a device to SevOne NMS.
Select Remove to remove the candidate/device from the list. The candidate/device can reappear in the list the next time a scheduled scan occurs.
Click Hide Added to remove the devices SevOne NMS currently monitors and polls from the display or click Show Added to display the devices that are in SevOne NMS in the list.
Click Hide Blocked to remove the candidates you block from the list or click Show Blocked to display the candidates you block in the list.
Select the check box for each candidate you want to add to SevOne NMS and click Add Devices to add the candidate as a device to SevOne NMS. When the device is in SevOne NMS, its objects are discovered and metrics are polled for reports and alerts. When the Status column displays In SevOne NMS you cannot re-add the device.
Perform the following steps to add a new candidate to the list.
Click Add Candidate to display the Add Candidate pop-up.
In the IP Address field, enter the IP address of the candidate.
In the Candidate Name field, enter the name of the candidate.
Click the Peer drop-down and select the peer to scan for the candidate and to monitor the candidate if you add the candidate to SevOne NMS as a device.
Click the SNMP Version drop-down and select the SNMP version the candidate uses.
For SNMPv1 and SNMPv2, in the SNMP Read Community String field, enter the SNMP read community string for SevOne NMS to use to monitor the candidate should you choose to add the candidate as a device.
For SNMPv3, perform the following steps.
In the SNMP Username field, enter the user name SevOne NMS needs to authenticate onto the device.
Click the SNMP Authentication Type drop-down.
Select None (usmNoAuthProtocol) to not use an authentication method to send or receive messages.
Select MD5 (usmHMACMD5AuthProtocol) to use MD5 authentication protocol for messages.
Select SHA (usmHMACSHAAuthProtocol) to use SHA authentication protocol for messages.
If you select MD5 or SHA in the previous step, in the SNMP Password field, enter the password SevOne NMS needs to authenticate onto the device.
Click the SNMP Encryption Type drop-down.
Select None to not use encryption to send or receive messages.
Select AES to use the Advanced Encryption Standard encryption method.
Select DES to use the Data Encryption Standard encryption method.
If you select AES or DES in the previous step, in the SNMP Encryption Key field, enter the localized key the authentication protocol on the device requires to authenticate messages.
Click Save.
You can use any spreadsheet application to create a .csv format file with the information described below. You must complete all required fields and you can leave the optional fields blank (delimited by a comma). If SevOne NMS can ping the candidates, they appear on the Candidates tab.
Click Import CSV to display a pop-up.
Enter the following fields or copy the following from the .csv file.
SNMPv1 and SNMPv2
Name, IP Address, Description, 1st Level Device Group/Device Group1,1st Level Device Group / Device Group2, 1st Level Device Group/Device Group3, 1st Level Device Group/Device Group4, SNMP Ver, SNMP Port, SNMP RO, SNMP RW, Poll Frequency, Time Zone, Peer
SNMPv3
Name, IP Address, Description, 1st Level Device Group/Device Group1, 1st Level Device Group/ Device Group2, 1st Level Device Group/Device Group3, 1st Level Device Group/Device Group4, SNMP Ver, SNMP Port, SNMP Username, SNMP Password, Authentication Type, Encryption Type, Encryption Key, SNMP RO, SNMP RW, Poll Frequency, Time Zone, Peer
The fields in the file are:
Name - (Required) This can be a FQDN, a common name, or the IP address for the device (SevOne recommends that you do not use the IP address for the device name).
IP Address - (Required) Enter an IP address for the device. If the device name is DNS resolvable, this does not have to be the device's actual IP address because the default settings on the Cluster Manager Cluster Settings tab enable SevOne NMS to update this to the appropriate IP address upon first discovery.
Description - (Optional) Users can search for devices by device description.
Group 1, Group 2, Group 3, Group 4 - (Optional) Enter up to four device group names. You define device groups on the Device Groups page. If you have not defined device groups yet, you can leave these blank. The .csv file enables you to associate a device with up to four device groups. Use the / (slash) as the delimiter between the upper level device groups down to the device group level into which to add the device and use the , (comma) as the delimiter between each group name field (1st Level Group/2nd Level Group, Type/Router, Location/Delaware, Manufacturer/Cisco).
Hint: The lower section of the Device CSV Importer provides a Group drop-down to display the list of your device groups for reference purposes.
SNMP Ver - (Required if you want to use SNMP performance trending) Enter the SNMP version number 1, 2, or 3.
SNMP Port - (Optional) Enter the SNMP port number on the device from which SevOne NMS is to collect SNMP data. Leave this blank to default to port 161.
SNMP Username - (Required for SNMPv3 only) Enter the user name SevOne NMS needs to authenticate onto the device.
SNMP Password - (Required for SNMPv3 only) Enter the password SevOne NMS needs to authenticate onto the device.
Authentication Type - (Required for SNMPv3 only) Enter one of the following: None, MD5, or SHA.
Encryption Type - (Required for SNMPv3 only) If you enter either MD5 or SHA for the Authentication Type, enter one of the following: None, AES, or DES.
Encryption Key - (Required for SNMPv3 only) If you enter either AES or DES for the Encryption Type, enter the encryption key SevOne NMS needs to authenticate onto the device.
SNMP RO - (Required if the device uses a string that is different from the strings on the Cluster Manager) Enter the SNMP read only string.
SNMP RW - (Required if the device uses a string that is different from the strings on the Cluster Manager) Enter the SNMP read write string.
Poll Frequency - (Optional) Enter the polling frequency. Leave this blank to default to a five minute poll frequency.
Time Zone - (Optional) Enter the time zone of the physical location of the device. Leave blank to use the time zone from the Cluster Manager Cluster Settings tab. For thresholds and work hours calculation, you should enter the device time zone.
Hint: The lower section of the Device CSV Importer provides a Time Zone drop-down to display the list of time zones that you make available on the Cluster Manager Cluster Settings tab for reference purposes.
Peer - (Optional) When you have a multi-peer SevOne NMS cluster and you want to specify the peer to discover and poll the device, enter the name of the peer. If you leave this blank in a multi-peer cluster, the peer on which you run the Device CSV Importer discovers and polls the device. Leave this blank in a single peer cluster.
Hint: The lower section of the Device CSV Importer provides a Peer drop-down to display the list of peers for reference purposes.
Click Save.
A message appears below the text field to display the success or failure of the import. If an error occurs during the import, the message describes the error and the offending lines display. All devices that do not have errors display on the Candidates tab. Fix all errors in the import file and repeat the steps.
The Device Notes tab enables you to view the notes discovery creates. These notes help you troubleshoot plugin configuration issues and to communicate such things as device outage plans. The notes list displays the notes that meet your filter criteria, color coded by severity. Notes can have eight severity levels and the Cluster Manager Cluster Settings tab enables you to define which severity levels are to create notes.
Severity – Displays the note severity.
Time – Displays the note creation time.
Message – Displays the note content.
- Click to view the entire message when the note exceeds the allotted space.
You must select a device and click Apply Filter to display notes because your network creates many device notes. After you select a device, all other filters are optional and cumulative.
The Filters section enables you to define the notes to appear in the list. If a device has more than 3500 notes that meet your filter criteria, notes download to a file that you can view in an .html format.
Click the Device drop-down and select a device to display notes for a specific device. You must select a device to display notes in the list.
Click the Severities drop-down and select each severity level for which to display notes. The default Cluster Manager Cluster Settings tab creates discovery notes for all severities except the Debug level.
Click the Time Span drop-down and select a time span to display notes for the time span you select.
Click the Time Zone drop-down and select a time zone for the time span.
Select the Display notes added by users check box to display notes users add for the device.
Select the Display notes added by discovery check box to display notes discovery creates.
Select the Display object configuration changes created during discovery check box to display notes the object generates that pertain to configuration changes that occur during discovery.
You can export the list of device notes to an .html format or to a .csv format.
Click Export HTML to export the notes to an .html file. When there are more than 3500 notes that meet your filter criteria, notes download even if you do not click this.
Click Export CSV to export the notes to a .csv file.
Perform the following steps to add a note. Notes you add have the Notice severity level.
Click Add Note to display the Add Note pop-up.
Enter the note text.
Click Save.