5 Discovering Devices

This section describes how to use Oracle Communications Network Integrity to discover devices.

About Discovering Devices

Discovery is the process of scanning a live network to discover a set of individual IP addresses or particular network equipment. The discovery process is carried out by associating the scan with a particular protocol, such as SNMP, TL1, or CORBA, with custom scan actions, such as MIB II, and with vendor-specific properties, if required. Both the scope of the scan and the details of its recurrence are also configured through the scan profile. After the scan is complete, the discovered data results are output in MTOSI or MTNM XML format.

Starting a Scan

To start a scan:

  1. Click the scan you want to start in the Manage Scans table.

  2. Carry out one of the following:

    • From the Actions menu, select Start Scan

    • Right-click the scan and select Start Scan

    • Click the Start Scan button.

    The scan is executed immediately.

The scan is started immediately.

Stopping a Scan

To stop a running scan:

  1. Select the scan you want to stop in the Manage Scans table.

  2. Carry out one of the following:

    • From the Actions menu, select Stop Scan

    • Right-click the scan and select Stop Scan

    • Click the Stop Scan button.

A running scan does not stop immediately when you click Stop Scan. If a processor had already started before you clicked Stop Scan, the processor continues to run until its completion; the next processor in the sequence looks for the value of the set condition and the custom code in its invoke method, which will stop the processor; if the condition is True, the scan is stopped before the next processor starts and all the results of the scan are deleted.

See Network Integrity Developer's Guide for more information about adding the custom code in the processor's invoke method to stop the processor.

Viewing a Scan Status

To view the status of a completed scan or to monitor the status of a running scan, click the scan you want to view in the Manage Scans table. The Scan Status information is generated in the bottom section of the Manage Scans page.

  • The scan heading takes the form Scan: Scan_Name. Scan completion status is shown under the tabs in the form Scan Status: Completed/In progress.

  • The Progress bar, in blue, shows the progress of a live scan in percentage terms. When it reaches 100 per cent, scan status changes to Completed.

  • Start Time displays the time at which the scan commenced. The time is displayed in the format MM-DD-YYYY HH:MM:SS, and specifies the local time zone and year; For example, 2009-07-12 3:45:00 PM.

  • End Time displays the time at which the scan ended. The time is displayed in the format MM-DD-YYYY HH:MM:SS, and specifies the local time zone and year; For example, 2009-07-12 4:12:13 PM.

  • Duration lists the time taken for the scan to complete. The time is displayed in the format DDd HHh MMm SSs, where the capital letters are numeric values corresponding to day, hour, minute, and second, and the lower case letters are printed verbatim; For example: 2d 7h 14m 22s. The bigger units will not be printed if they are 0; For example: 27m 13s.

  • Total indicates the total number of network addresses that this scan has processed.

  • In Progress indicates the total number of network addresses that are actively being processed by the scan.

  • Completed indicates the total number of network addresses for which the scan has completed.

  • Error indicates the total number of network addresses for which the scan has failed.

To view further details of a scan result, such as the object tree for a particular scanned device, see "Viewing the Details of a Scan Result" for more information.

To view discrepancy detection, see "About Discrepancy Detection" for more information.

Viewing the Details of a Scan Result

By clicking an individual device in a scan run, you can display a tree browser called the Object Tree that lists the device, the device type, and all of its children and their individual device types.

For example, by clicking an equipment, you can drill down to its constituent shelves, slots, cards and ports. Each device type is identified by a different icon, and the object display is tiered at the level of each device type to make the relationships more obvious.

By clicking an individual object in the Object Tree, for example: a card, a read-only dialog is displayed that outlines the name and type of the card, as well as other identifying information such as its part number and serial number, and lists its child equipments (if any) and other hierarchical information, such as the ports listed on the card.