1. SNMP Discovery and UIM Integration Cartridge Guide
  2. Overview

1 Overview

This chapter provides an overview of the Oracle Communications Network Integrity Generic SNMP cartridge.

This chapter contains the following sections:

About the Generic SNMP Cartridge

The Generic SNMP cartridge provides functionality for the following:

  • Generic management information base (MIB) MIB-II logical discovery and modeling

  • Generic device logical discovery and modeling of asynchronous transfer mode (ATM) media configurations

  • Generic device physical discovery and modeling

This cartridge produces both logical and physical device hierarchies that represent a discovered device. The logical hierarchy includes a logical device, child interfaces, sub-interfaces (collectively called interfaces), and device interface configurations. The physical hierarchy includes physical device, equipment, equipment holders, and physical ports. In addition, this cartridge creates associations between the physical and logical hierarchies. The first association is at the device level, between the physical device and the logical device, and the second association is at the interface level between physical ports and Interfaces.

This cartridge discovers the following network entities:

  • Physical device
  • Logical Device
  • Chassis
  • Shelf
  • Card
  • Port
  • Interface / Sub-Interface

Discovery scans require that devices support the following MIBs to acquire complete and meaningful results and to properly model both the physical and logical sides.

  • For MIB-II logical discovery, the following MIBs are required:

    • RFC1213-MIB

    • IF-MIB (RFC 2863)

    • IANAifType-MIB

    • IP-MIB (RFC 4293)

  • For Generic device physical discovery, the ENTITY-MIB (RFC 2737) is required.

  • For Generic devices, the ATM-MIB (RFC 2515) is required.

The discovery of a specific device fails if the target device does not support MIB-II or any of the MIBs being used. This does not necessarily mean the scan in its entirety fails. For example, if you have a scan with a broad scope (for example, multiple IP addresses), only the devices that do not meet the required criteria fail to be rendered; other devices within the scan may succeed. A user can inspect the failed device to determine the cause of the failure.

This cartridge is designed to be used on a standalone basis displaying the model hierarchy in Network Integrity. The cartridge provides no integration with other products but may be extended.

CPU Utilization-enabled Discovery

The Generic SNMP cartridge enables you to discover devices based on their CPU utilization by setting a threshold value (in percentage) in the Discover Generic SNMP scan. If the CPU utilization value of a device exceeds the user-specified threshold value, the scan for that device is skipped. The discovery scans are run only for those devices whose CPU utilization value is less than the user-specified threshold value.

In the Discover Generic SNMP scan, you can specify the CPU utilization threshold value between 1% and 99%. If a device's CPU utilization is greater than the specified threshold value, the scan for that device stops, the status of the scan changes to Failed, and the following error message is displayed in the scan results: 

The device's CPU Utilization of device_cpu_value was greater than the threshold value set by the user.

Where:

device_cpu_value is the CPU utilization value of the device.

For example, if you specified 50% as the CPU utilization value and if the device's CPU utilization is 60%, the Network Integrity application skips scanning that device because its CPU utilization (60%) is greater than the specified threshold value (50%). In this case, the following error message is displayed in the scan results:

The device's CPU Utilization of 60 was greater than the threshold value set by the user.

To support the discovery of devices based on CPU utilization, a new scan parameter group, CPU Utilization Parameters, has been added in the NetworkIntegritySDK cartridge. This scan parameter group adds the CPU Utilization % field to the Network Integrity UI Scan Configuration screen. The CPU Utilization % field accepts a value between 1 to 99. See Network Integrity Developer's Guide for more information.

When creating a discovery scan based on CPU utilization, ensure that you do the following:

  • On the General tab, from the Scan Action list, select Discover Generic SNMP.

  • In the Scan Action Parameters section, from the Select Parameter Group list, select CPU Utilization Parameters.

  • In the CPU Utilization % field, specify a value between 1 to 99.

    See Network Integrity Help for information about creating a scan.

Note:

The CPU utilization feature is disabled by default. To enable it, Network Administrators must follow these steps:
  • Create a collector processor with the appropriate Device MIBs to gather CPU utilization values from the device.
  • Place the created collector processor before the Generic Device CPU Set Processor.
  • Set the collected CPU utilization value in the 'device_set_cpu' variable inside Generic Device CPU Set Processor to activate this feature.

About Cartridge Dependencies

This section provides information on dependencies that the Generic SNMP cartridge has on other entities.

Run-Time Dependencies

This cartridge requires that the Address_Handlers cartridge be deployed to Network Integrity.

Design-Time Dependencies

The Generic SNMP cartridge has the following dependencies:

  • Address_Handlers

  • Generic_SNMP_Model

  • MIB_II_SNMP cartridge

  • NetworkIntegritySDK

  • ora_ni_uim_device

  • UIM_Integration_Cartridge

Opening the Cartridge Files in Design Studio

To review and extend the Generic SNMP cartridge, you must first download the Oracle Communications Generic SNMP Cartridge software from the Oracle software delivery web site:

https://edelivery.oracle.com

The software contains the Generic SNMP cartridge ZIP file, which has the following structure:

  • \UIM_Cartridge_Projects\

  • \Network_Integrity_Cartridge_Projects\

  • \SNMP_MIBs\

  • Address_Handlers-R7.iar

  • Generic_SNMP_Cartridge-R7.iar

See Design Studio Online Help and Oracle Communications Network Integrity Developer's Guide for information about opening files in Design Studio.

Building and Deploying the Cartridge

See Design Studio Online Help for information about building and deploying cartridges.