2 About the Cartridge Components

This chapter provides information about the components of the Oracle Communications Network Integrity NETCONF Network Discovery and UIM Integration cartridge.

This cartridge contains the following actions:

Abstract Discover Netconf Devices

The Abstract Discover Netconf Devices is an abstract action that can be extended in Oracle Communications Service Catalog and Design - Design Studio to discover specified network objects.

This action contains the following processors run in the following order:

Netconf Connection Initializer

The Netconf Connection Initializer processor accepts connection parameters from the netconfParameters scan parameter group and establishes a NETCONF connection with the device. All properties are populated into a JavaBean class named NetconfProperties. NETCONF Connection is established using NetconfProperties.

Generic Netconf Yang Collector Processor

The Generic NETCONF YANG Collector Processor collects variables from a device for discovery. It uses attributes from generic YANG models required to retrieve device details. This processor runs when the deviceType parameter is set to Generic Device. For more information, see About Poll Lists.

Generic Netconf Data Discovery

The Generic Netconf Data Discovery processor frames a NETCONF request to get the required attribute values from device, collects response from device and generate Java binding objects for collected response.

This processor is conditional: it is only run when the deviceType parameter is set to Generic Device.

Vendor-Based Netconf Yang Collector Processor

The Vendor-based Netconf Yang Collector Processor collects variables to be discovered from a device. This processor contains attributes from vendor-specific YANG models which are required to get device details. For more information, see About Poll Lists.

This processor is conditional: it is only run when the deviceType parameter is set to Cisco XR Device.

Vendor Netconf Data Discovery

The Vendor Netconf Data Discovery processor frames a NETCONF request to get required attribute values from the device, collects a response from the device and generates Java binding objects for the collected response.

This processor is conditional: it is only run when the deviceType parameter is set to Cisco XR Device.

Netconf Logical Data Modeler

The Netconf Logical Data Modeler processor models the data that is collected by the YANG Collector processor. Modeling includes building the hierarchical relationship of logical device and child interfaces.

Netconf Physical Data Modeler

The Netconf Physical Data Modeler processor models the data that is collected by the YANG Collector processor. Modeling includes building the hierarchical relationship of physical devices, equipment, equipment holders, and physical ports.

Discover Netconf Devices

The Discover Netconf Devices action scans devices and provides a physical and logical hierarchical model of what is discovered. This action also models the associations between the physical and logical hierarchies.

This action extends the Abstract Discover Netconf Devices action.

The Discover Netconf Devices action contains the following processors, run in the following order:

  • Netconf Connection Initializer (inherited)
  • Generic Netconf Yang Collector Processor (inherited)
  • Generic Netconf Data Discovery (inherited)
  • Vendor based Netconf Yang Collector Processor (inherited)
  • Vendor Netconf Data Discovery (inherited)
  • Netconf Logical Modeler (inherited)
  • Netconf Physical Modeler (inherited)

Import Netconf Device from UIM

The Import Netconf Device from UIM action imports logical device and physical device trees from Oracle Communications Unified Inventory Management (UIM). Import scan parameters are available on the Create Scan page in Network Integrity to configure import filters.

This import action extends the Abstract Import from UIM action (from the UIM Integration cartridge) and inherits all its processors. For more information about the inherited processors in this action, see Network Integrity UIM Integration Cartridge Guide.

The Import Netconf Device from UIM action contains the following processors run in the following order:

  1. Import UIM Initializer (inherited)
  2. ProcessNetconfImportScanInput
  3. Logical Device UIM Finder (inherited)
  4. Physical Device UIM Finder (inherited)
  5. Logical Device UIM MultiThread Importer (inherited)
  6. Physical Device UIM MultiThread Importer (inherited)
  7. Logical Device UIM Importer (inherited)
  8. Linked Physical Device UIM Importer (inherited)
  9. Logical Device UIM Persister (inherited)
  10. Physical Device UIM Importer (inherited)
  11. Linked Logical Device UIM Importer (inherited)
  12. Physical Device UIM Persister (inherited)

ProcessNetconfImportScanInput

This processor uses filters as input parameters and sets filter values based on the scan parameters. For more information about the scan parameter groups associated with this action, see Import Scan Parameter Group.

Detect Netconf Device Discrepancies

The Detect Netconf Device Discrepancies action detects discrepancies between discovery scan results of the Discover Netconf Devices action and the data imported from UIM.

This action extends the Abstract Detect UIM Discrepancies action (from the UIM Integration cartridge) and inherits all its processors. For information about the inherited processors, see Network Integrity UIM Integration Cartridge Guide.

This action contains the following processors run in the following order:

  1. UIM Discrepancies Filter Initializer (inherited)
  2. Netconf Discrepancy Filters Initializer
  3. Discrepancy Detector (inherited)

Netconf Discrepancy Filters Initializer

This processor adds the following filters to ignore association discrepancies between logical and physical devices:

  • Disregard Association+ and Association- discrepancies on Logical Device
  • Disregard Association+ and Association- discrepancies on Device Interface

Note:

Discrepancy detection between logical and physical devices is required only when a different import action is used to import both logical and physical devices.

Resolve Netconf Device Discrepancies

The Resolve Netconf Device Discrepancies action resolves discrepancies on logical and physical hierarchies and associations between logical and physical entities in UIM.

This action extends the Abstract Resolve in UIM action (from the UIM Integration cartridge) and inherits all its processors. For information about the inherited processors, see Network Integrity UIM Integration Cartridge Guide.

The Resolve Netconf Device Discrepancies action contains the following processors run in the following order:

  1. UIM Resolution Framework Initializer (inherited)
  2. UIM Resolution Initializer (inherited)
  3. UIM Resolution Framework Dispatcher (inherited)