1. Online Help
  2. Working with Scan Results

4 Working with Scan Results

This section describes how to work with the results of scans carried out using Oracle Communications Network Integrity.

About Scan Results

This page enables you to use scan results.

Refer to the following sections:

About the Scan Results Page

You can use the Scan Results page to search for and display a table of scan results. For a selected scan result, it also displays a list of scan result details that you can use to search for discrepancies.

Searching for Scan Results

You can search for scan runs using the Search pane on the Scan Results page. Use the basic search functionality described in this section, or to enhance the search criteria, click Advanced.

To carry out an advanced search for a scan run, there are a number of separate tasks to carry out:

Specifying the Range and Type of Scans

To specify the range and type of scan to return in the search:

  1. Expand the Search pane.

  2. In the Match section, select whether to generate a response that matches all of the search criteria, or a response that matches any of the search criteria, by clicking All or Any.

  3. In the Restrict to Previously Selected Scans section, check the box to search scan results already selected, or uncheck the box to ignore them. The default is checked: search scan runs already selected.

  4. Expand the tag group. Click a single tag, or multiple tags, as required. Multiple tag selections are combined in an OR condition when the query is generated (even when Match All is selected in the Match section above). When a parent tag is selected, the children are automatically selected.

  5. In the Latest Completed Result Only section, check the box to return information using only the most recent completed scan run, or uncheck the box to return information using all scan results. The default is checked.

Specifying the Scan Name and Associated Scan Action

To specify the scan name and the scan action associated with the scan:

  1. In the Name section, enter the name of the scan you are searching for.

  2. In the Scan Action section, associate the scan with a custom scan action, such as Inventory Import or Discovery, for example.

Specifying the Scan Status

To specify the status of the scan:

  1. Go to the Status section.

  2. Choose one of the following:

    • Running

    • Suspended

    • Completed

    • Stopped

    • Stopping

Specifying the Scan Type

To specify the scan type:

  1. Go to the Type section.

  2. Select the operator.

  3. Choose from the list of types.

Setting the Scan Start and End Times

To set the time when the scan began running, and the time when the scan completed:

  1. In the Scan Start Time fields, set the start time by selecting the required condition:

    • Not Between: Specify a range of times during which the scan did not take place.

    • Before: Specify a time before which the scan took place

    • After: Specify a time after which the scan took place

    • On or After: Specify a time on which, or after which, the scan took place. This is the default.

    • Between: Specify a range of times during which the scan took place

  2. In the Scan End Time fields, carry out the same procedure to set the end time for the scan.

Setting the Discrepancy Detection Start and End Times

To set the time when the discrepancy detection job began running, and the time when it completed:

  1. In the Discrepancy Detection Start Time field, set the start time by selecting the required condition:

    • Not Between: Specify a range of times during which the discrepancy detection job did not take place.

    • Before: Specify a time before which the discrepancy detection job took place

    • After: Specify a time after which the discrepancy detection job took place

    • On or After: Specify a time on which, or after which, the discrepancy detection job took place. This is the default.

    • Between: Specify a range of times during which the discrepancy detection job took place

  2. Click the calendar icon to display the date and time selector

  3. Select the date and time, specifying whether the time is AM or PM.

  4. Click Save to confirm, or click Cancel to exit without saving.

  5. In the Discrepancy Detection End Time field, carry out the same procedure for the discrepancy detection job end time.

Setting the Critical Discrepancy Severity Requirements

To set the discrepancy severity requirements:

  1. In the Critical Discrepancies field, use one of the following conditions:

    • Equals: Specify discrepancies of critical severity

    • Does Not Equal: Specify discrepancies not of critical severity

    • Less Than: Specify discrepancies of a severity lower than critical

    • Between: Specify a range of severities

    • Not Between: Specify a range of severities in which the required severity is not included.

  2. Complete the second field by selecting the discrepancy type applicable to the scan.The values on this list depend on the scan action selected.

Setting the Major Discrepancy Severity Requirements

To set the major discrepancy severity requirements:

  1. In the Major Discrepancies field, use one of the following conditions:

    • Equals: Specify discrepancies of major severity

    • Does Not Equal: Specify discrepancies not of major severity

    • Less Than: Specify discrepancies of a severity lower than major

    • Greater Than: Specify discrepancies of a severity higher than major

    • Between: Specify a range of severities

    • Not Between: Specify a range of severities in which the required severity is not included.

  2. Complete the second field by selecting the discrepancy type applicable to the scan.The values on this list depend on the scan action selected.

Setting the Minor Discrepancy Severity Requirements

To set the minor discrepancy severity requirements:

  1. In the Minor Discrepancies field, use one of the following conditions:

    • Equals: Specify discrepancies of minor severity

    • Does Not Equal: Specify discrepancies not of minor severity

    • Less Than: Specify discrepancies of a severity lower than minor

    • Greater Than: Specify discrepancies of a severity higher than minor

    • Between: Specify a range of severities

    • Not Between: Specify a range of severities in which the required severity is not included.

  2. Complete the second field by selecting the discrepancy type applicable to the scan.The values on this list depend on the scan action selected.

Setting the Warning Discrepancy Severity Requirements

To set the warning discrepancy severity requirements:

  1. In the Warning Discrepancies field, use one of the following conditions:

    • Equals: Specify discrepancies of warning severity

    • Does Not Equal: Specify discrepancies not of warning severity

    • Greater Than: Specify discrepancies of a severity higher than warning

    • Between: Specify a range of severities

    • Not Between: Specify a range of severities in which the required severity is not included.

  2. Complete the second field by selecting the discrepancy types applicable to the scan.The values on this list depend on the scan action selected.

Carrying out the Search for the Scan Run

To search for the scan run:

  1. Add custom fields to enhance the search functionality as required. See "Adding Search Fields" for more information.

  2. Click Search to carry out the search or click Reset to revert to the default search options, and clear all input fields.

    The result of the search is displayed in the Search Results table. The table is populated with data that matches your search criteria.

About the Search Results Table

The Search Results table lists the outcomes for one or more Network Integrity scans. Each scan is defined by:

  • Name: the name of the scan

  • Scan Action: the scan action associated with the scan

  • Scan Type: the scan type based on the selected scan action:

    • Discovery

    • Import

    • Assimilation

  • Source: the data source assigned to the scan

  • Status: the current status of the scan

    • In progress

    • Completed (even if completed with errors)

    • No Scan Status - the scan was never run

  • Scan Error: the total number of errors encountered during the scan

  • Discrepancy type and total number:

    • Critical (denoted by C)

    • Major (denoted by M)

    • Minor (denoted by m)

    • Warning (denoted by w)

  • Scan Start Time: the time at which the scan started; in the form 4 hours ago or 10 days ago.

  • Scan Duration: the time taken for the scan to complete; in the form 1 minute.

  • Discrepancy Start Time: (optional) the time at which discrepancy detection was initiated at the end of the discovery scan; in the form 4 hours ago or 10 days ago

  • Discrepancy Duration: (optional) the time for discrepancy detection to complete; in the form 0 seconds.

Select a scan from the Search Results table to carry out these actions:

Displaying Scan Result Details

The Scan Result Details table lists information discovered as part of the scan. The list displays scan properties, such as name, type, status, duration, as well as an outline of discrepancy types - if discrepancy detection was enabled when the scan was configured was enabled - organized by severity (Critical, Major, Minor, and Warning).

To display scan result details:

  1. Click the scan in the Search Results table to display the scan result details.

  2. Use the Scan Result Details table to view, but not to edit, the following information:

    • Category: the category of each network element scanned; for example: device

    • Name: the device identifier. Click the device identifier to display detailed information about the entity. See "Viewing a Scan Result Detail" for more information.

    • C/M/m/w: the discrepancy types organized by severity (Critical, Major, Minor, and Warning), and total numbers

    • Network Address: the network address of the device

  3. (Optional) Click Review Discrepancies to examine discrepancies associated with a device. See "Using Network Integrity to Review Discrepancies" for more information.

Viewing a Scan Result Detail

To view detailed information about a particular device:

    1. From the Scan Result Details table, click a device name (in blue) to display the Scan Result Detail page.

      This page displays an entity tree for the device, that is, a hierarchical outline of all device information. The entity tree defines each entity by entity name and type.

    2. Drill down into the entity tree to view a particular root entity. For example, expand a cisco3640 entity to view the chassis, container slots, cards, and so on.

    3. Click any element in the tree to view the attribute and relationship details of that entity.

See "Viewing an Entity Detail" for more information.

Viewing an Entity Detail

The attribute and relationship details for each element in the entity tree displayed on the Scan Result Detail page can be viewed on a separate pane.

To view the attributes and relationships of a particular entity:

    1. From the Scan Result Detail page, select an element in the entity tree to display the Entity Detail pane.

      The Entity Detail pane opens to the right of the Scan Detail page. Use the arrow icons at the side of each pane to collapse and restore panes as required.

    2. Click any color-coded attribute or relationship to link to its location in the entity tree.

      For example, to link to a particular device interface in the entity tree, from the Device Interfaces list in the Relationships section, click the interface name. The Scan Result Detail page refreshes to display the particular device interface within the entity tree.

Displaying Addresses

You can view the list of IP addresses scanned. The list is shown in a read-only dialog, providing failure reasons (if applicable).

To display addresses:

  1. Carry out one of the following:

    • Right-click the scan run and select View Addresses

    • From the top-level of the Search Results page, select the View Addresses tab

  2. Use the Addresses table to view, but not to edit, the following information:

    • The address for a particular scan

    • The completion status of a particular address scan

    • The reason for an error in the discovery of an individual IP address; for example, a ping timeout

    • The start and end time for a particular scan

  3. When you are finished with the dialog, click Close to exit.

Displaying Scan Configurations

You can view the original scan configuration parameters. The details are presented in a read-only dialog, showing a list of parameters.

To display the scan configuration:

  1. Double-click the scan in the list of scans.

  2. Use the following tabs to view, but not to edit, general scan configuration information, such as:

  3. When you have viewed the scan configuration, you can carry out the following actions on the scan:

Displaying Scan Status Information

To display the status of a completed scan:

  1. Double-click the scan run in the Search Results table.

  2. Click the Status tab to view the following information:

    • Scan Progress: the overall status of the scan: this takes one of the values: Running, Stopped, Suspended, Completed, or Cancelled.

      • Progress: a progress bar indicating the percentage completion of the scan.

      • Total: the total number of scans completed.

      • In Progress: the total number of scans still in progress when the scan result details were requested.

      • Error: the total number of errored device scans.

      • Start Time: the time at which the scan started; in the form 4 hours ago or 10 days ago.

      • Duration: the time taken for the scan to complete; in the form 1 minute.

      • Actual Start Time: the time at which the scan started, in the form MM-DD-YYYY HH:MM:SS AM/PM; for example: 08-19-2010 4:59:37 PM.

      • Actual End Time: the time at which the scan ended, in the form MM-DD-YYYY HH:MM:SS AM/PM; for example: 08-19-2010 5:01:36 PM.

    • Discrepancy Detection Progress: the status of the discrepancy detection process (if selected).

      • Progress: a progress bar indicating the percentage completion of the discrepancy detection.

      • Total: the total number of discrepancy detections completed.

      • In Progress: the total number of discrepancy detections still in progress when the scan result details were requested.

      • Error lists the number of discrepancy detection processes that have run unsuccessfully.

        To investigate discrepancy detection failures, refer to the server logs from the Network Integrity application. See Network Integrity System Administrator's Guide for further information about logging.

        The designer of the cartridge pack should also be able to provide information about the cause of these errors.

      • Start Time: the time at which discrepancy detection was initiated at the end of the discovery scan; in the form 4 hours ago or 10 days ago.

      • Discrepancy Duration: the time taken for discrepancy detection to complete; in the form 0 seconds.

      • Actual Start Time: the time at which discrepancy detection started, in the form MM-DD-YYYY HH:MM:SS AM/PM; for example: 08-19-2010 5:01:36 PM.

      • Actual End Time: the time at which the discrepancy detection ended, in the form MM-DD-YYYY HH:MM:SS; for example: 08-19-2010 5:01:36 PM.

    • Discrepancy Counts: the total number and type of discrepancies.

      • Critical (denoted by C)

      • Major (denoted by M)

      • Minor (denoted by m)

      • Warning (denoted by w)

  3. Click Review Discrepancies to examine discrepancies associated with a device. See "Using Network Integrity to Review Discrepancies" for more information.

Displaying Common Scan Parameters

The top half of the General tabbed pane shows parameters common to all scans. The bottom half shows scan action parameters defined by cartridge pack developers. See "Displaying Scan Action Information" for more information.

To display the common properties and the tag list of a scan:

  1. Double-click the scan run in the Search Results table.

  2. Click the General tab to view the following information:

    • Name: The scan identifier.

    • Enabled: If the box is checked, the scan is enabled to be started. If the box is not checked, the scan could not be executed.

    • Detect Discrepancies: If this box is checked, discrepancy detection is automatically initiated at the end of the discovery scan. If the box is not checked, discrepancy detection did not occur.

    • Scan Action: The custom scan action associated with the scan; for example: Cisco Router or UIM Inventory.

    • Scan Type: A scan type based on the selected scan action. It may be one of the following:

      • Discovery

      • Import

      • Assimilation

    • Source: The data source assigned to the scan.

    • Description: A textual description of the scan.

    • Tags: Shows the tag list associated with this scan. See "Tagging a Scan" for more information.

Displaying Scan Action Information

The bottom half of the General tabbed pane shows scan action parameters defined by cartridge pack developers. The top half shows parameters common to all scans. See "Displaying Common Scan Parameters" for more information.

To display the scan action configuration details of the selected scan:

  1. Double-click the scan run in the Search Results table.

  2. Click the Scan Action tab to view the following information for the SNMP scan action:

    • Version: The version of the Simple Network Management Protocol (SNMP) protocol selected:

      • Version 1

      • Version 2c

      • Version 3

    • Community string: A string used to carry out authentication of clients.

    • Number of retries: The number of times that the scan was carried out. The default is zero, that is, the scan was carried out once.

    • Timeout (seconds): The time between scans. The default is 5.

    • Port: the port through which SNMP communication was carried out. The range of valid port numbers is from 0 to 65535. The default is 161.

    • User name: the user name used for authentication.

    • Authentication password: A password used for authentication. This field applies only to SNMP Version 3.

    • Authentication protocol: A protocol used for authentication. This field applies only to SNMP Version 3.

    • Privacy protocol: A privacy protocol used by the parties to the SNMP communication. This field applies only to SNMP Version 3.

    • Privacy password: A privacy password used by the parties to the SNMP communication. This field applies only to SNMP Version 3.

    • Context Name: The name of the context used in the SNMP communication. This field applies only to SNMP Version 3.

Displaying Scan Scope Information

To display the scope parameters of the selected scan:

  1. Double-click the scan run in the Search Results table.

  2. Click the Scope tab to view the following information per scan type:

    • Discovery/Import scan types: Displays a table listing columns of network addresses or network address ranges.

    • Assimilation scan type: Displays a table listing input scan details:

      • Scan Name: The scan identifier.

      • Scan Action: The custom scan action associated with the scan; for example: Cisco Router or UIM Inventory.

      • Scan Type: A scan type based on the selected scan action. It may be one of the following:

      • Source: The data source assigned to the scan.

      • Description: A textual description of the scan.

Displaying Scan Schedule Information

All times refer to the time on the Network Integrity server, as shown on the dialog. Scans are created, updated, displayed, and executed in server time. The local time zone of the client browser is not used for scheduling scans.

To display the schedule configuration for the selected scan:

  1. Click Display Scan in the Search Results table.

  2. Click the Schedule tab to view the following information:

    • Description: A description of the schedule.

    • Effective Date: The schedule begins on this date.

    • Start Time: The time at which the schedule starts.

    • Frequency: Shows how often the schedule takes place. The options are:

      • Daily: The time of day in 24 hour format.

      • Weekly: The day on which the schedule applies.

      • Monthly: The day of the month on which the schedule applies.

      • Yearly: The day of the year on which the schedule applies.

      • Once Only: A time and date on which the schedule applies on one occasion only.

    • Recurrence Pattern: Shows the recurrence pattern. See "Defining a Scan Schedule" for more information.

      If the scan has no schedules associated with it, the Scan Schedules table displays “No Schedules".

  3. Click Close to exit the dialog.

Displaying Scan Blackout Information

All times refer to the time on the Network Integrity server, as shown on the dialog. Blackout windows are created, updated, displayed, and executed in server time. The local time zone of the client browser is not used for scheduling blackout windows.

To display the blackout windows assigned to the selected scan:

  1. Double-click the scan run in the Search Results table.

  2. Click the Blackout tab to view the following information:

    • Description: A description of the blackout schedule.

    • Effective Date: The blackout schedule begins on this date.

    • Start Time: The time at which the blackout schedule starts.

    • Frequency: Select the recurrence pattern. The options are:

      • Daily: The time of day in 24 hour format.

      • Weekly: The day on which the blackout schedule applies.

      • Monthly: The day of the month on which the blackout schedule applies.

      • Yearly: The day of the year on which the blackout schedule applies.

      • Once Only: A time and date on which the blackout schedule applies on one occasion only. This is the default.

    • Recurrence Pattern: Shows the recurrence pattern. See "Creating a Blackout Window" for more information.

    • Duration: The time period covered by the blackout schedule:

      • Days: The number of days for which the blackout window applies.

      • Hours: The number of hours for which the blackout window applies.

      • Minutes: The number of minutes for which the blackout window applies.

Refreshing the Scan Results View

The table that displays scan results is not auto-refreshed. On the top-level of the Search Results pane, click Refresh to repeat the last executed search (including Display Scan Results, if there were no search criteria entered in the Search pane).