This chapter describes the Oracle Communications Network Integrity Optical Circuit Assimilation cartridge.
The Optical Circuit Assimilation cartridge enables you to derive end-to-end circuits that traverse through your synchronous digital hierarchy (SDH) networks. The Optical Circuit Assimilation cartridge uses topological link and cross-connect data from existing action results to assimilate circuits.
The Optical Circuit Assimilation cartridge can use scan results from the following types of actions as input:
Discover TMF814
Discover SNMP
File Transfer and Parsing
Assimilate Optical Circuits
When the input is an existing set of assimilation data, the Optical Circuit Assimilation cartridge performs additional levels of assimilation. The first level of assimilation results consists of the parent hierarchy, such as from multiple systems. Subsequent assimilation actions assimilate the circuits that span the multiple systems. The completed assimilation results shows the complete hierarchy of circuits.
The Optical Circuit Assimilation cartridge has the following limitation.
In some cases, it can happen that the Optical Circuit Assimilation cartridge fails to discover a network circuit present in inventory without reporting a discrepancy. This is due to the default behavior of the Network Integrity Base detection cartridge.
In general, if a discovery scan finds Device1 with circuits A and B in the network, and the same device exists in inventory, but with circuits A, B, and C, Network Integrity reports an Entity- discrepancy on circuit C in the network.
In the above example, Network Integrity can fully compare the results for Device1 using the network discovery results and the inventory results.
However, by default, when Device1 is not listed in the discovery results (or, for this cartridge, in the assimilation results), Network Integrity does not report circuit discrepancies on the device.
You can extend the Optical Circuit Assimilation cartridge to detect Entity- discrepancies on root entities using one of the following approaches:
Extend the Base detection cartridge or the Optical Circuit Assimilation cartridge by introducing a custom discrepancy detection action that reports discrepancies on root entities.
Extend the Optical Circuit Assimilation cartridge with a custom discrepancy detection action (specifically, the Extra Circuit Filter Initializer processor) that checks missing circuits on the final assimilation scan. Copy fully-traced circuits to the assimilation scan results as shadow entities.
See Network Integrity Developer's Guide for more information about cartridge extensibility and discrepancies.
The Optical Circuit Assimilation cartridge has the following types of dependencies.
To open, view, and extend the Optical Circuit Assimilation cartridge, you must first download the cartridge ZIP file from the Oracle software delivery web site:
The Optical Circuit Assimilation cartridge ZIP file has the following structure:
Network_Integrity_Cartridge_Projects/OpticalAssimilation_Cartridge
Network_Integrity_Cartridge_Projects/Optical_Model
The OpticalAssimilation_Cartridge project contains the extendable Design Studio files.
See Network Integrity Concepts for guidelines and best practices for extending cartridges. See Design Studio Help for information about importing projects and opening files in Design Studio.