Skip Headers
Oracle® Communications Network Integrity Cisco Router and Switch UIM Integration Cartridge Guide
Release 7.1

E23705-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

9 About Design Studio Construction

This chapter provides information on the composition of the Network Integrity Cisco Router and Switch UIM Integration cartridge from the Oracle Communications Design Studio perspective.

Model Collections

Table 9-1 shows the MIB II model collection.

Table 9-1 MIB II Model Collection

Specifications Information Model Entity Type Intended Usage/ Notes

deviceGeneric

LogicalDevice

Represents any root object discovered on the network.

interfaceGeneric

MediaInterface

Represents any interface discovered under deviceGeneric.

GenericMedia

DeviceInterfaceConfigurationItem

Represents IpAddresses that are applied to an interfaceGeneric.

IPAddresses

DeviceInterfaceConfigurationItem

Ip Addresses container

IPAddress

DeviceInterfaceConfigurationItem

Ip Address details container


Table 9-2 shows the Cisco model collection.

Table 9-2 Cisco Model Collection

Specifications Information Model Entity Type Intended Usage/ Notes

physicalDeviceGeneric

PhysicalDevice

Represents any Cisco Physical Device discovered on the network.

equipmentHolderGeneric

EquipmentHolder

Represents any equipment container.

equipmentGeneric

Equipment

Represents any piece of equipment (i.e. Chassis, Backplane, Module, etc)

physicalPortGeneric

PhysicalPort

Represents any physical port.

AtmMedia

DeviceInterfaceConfigurationItem

Represents an ATM media configuration that can be applied to an interface or sub-interface.

VirtualChannelLink

DeviceInterfaceConfigurationItem

Represents a single Virtual Channel Link within an ATM Media configuration.

VPI

DeviceInterfaceConfigurationItem

Holds the VPI value and is contained within the Virtual Channel Link.

VCI

DeviceInterfaceConfigurationItem

Holds the VCI value and is contained within the Virtual Channel Link.

VirtualChannelLinkData

DeviceInterfaceConfigurationItem

Contains the Virtual Channel Link characteristics and is contained with the Virtual Channel Link.

AtmInterfaceConfigurationData

DeviceInterfaceConfigurationItem

Contains the ATM configuration applied to an interface.

FrameRelayMedia

DeviceInterfaceConfigurationItem

Represents a Frame Relay media configuration that can be applied to an interface or sub-interface.

DLCI

DeviceInterfaceConfigurationItem

Represents a single DLCI and is contained within a Frame Relay media configuration.

FrameRelayData

DeviceInterfaceConfigurationItem

Contains the Frame Relay characteristics.

FrameRelayExtendedData

DeviceInterfaceConfigurationItem

Contains additional Frame Relay characteristics.

VlanMembership

DeviceInterfaceConfigurationItem

Represent the VLAN Membership media configuration that can be applied to an interface or sub-interface.

Vlan

DeviceInterfaceConfigurationItem

Represents a single VLAN and is contained within a VLAN Membership.


Table 9-3 shows Cisco_UIM_Model information.

Table 9-3 Cisco_UIM_Model Information

Specification Information Model Entity Type

cisco3640

Physical Device

cevChassis3640

Equipment

cat6509

Physical Device

cevChassisCat6509

Equipment

artificial6509ContainerGbic

Equipment

artificial6509MSFCCard

Equipment

artificial6509PowerSupplyHolderCard

Equipment

artificial6509PowerSupplySlot

Equipment Holder

cisco7206VXR

Physical Device

cevChassis7206Vxr

Equipment

cevBackplaneCat6000

Equipment

cevBackplaneCat6500

Equipment

cevCat6kWsc6000cl

Equipment

cevCat6kWsc6kvtt

Equipment

cevCat6kWsf6kPfc

Equipment

cevCat6kWsx6248Rj45

Equipment

cevCat6kWsx6348Rj45

Equipment

cevCat6kWsxSup1a2ge

Equipment

cevContainerClock

Equipment Holder

cevContainerDaughterCard

Equipment Holder

cevContainerFanTraySlot

Equipment Holder

cevContainerGbic

Equipment Holder

cevContainerPowerSupplyBay

Equipment Holder

cevContainerSlot

Equipment Holder

cevContainerVtt

Equipment Holder

cevCpu7200Npe300

Equipment

cevCpuCat6kMsfc

Equipment

cevCpuCat6kWsxSup1a2ge

Equipment

cevFanWSC6k9SlotFan

Equipment

cevModuleCat6000Type

Equipment

cevModuleUnknownCard

Equipment

cevModuleVipPortAdapters

Equipment

cevPa8e

Equipment

cevPaAtmdxMmOc3

Equipment

cevPaE3MuxCbr120e1

Equipment

cevPmCpm2e2w

Equipment

cevPmM4t

Equipment

cevPortAMDP2

Physical Port

cevPortDCUATMPort

Physical Port

cevPortFe

Physical Port

cevPortFEIP

Physical Port

cevPortGigBaseLH

Physical Port

cevPortMueslix

Physical Port

cevPortQuiccSerial

Physical Port

cevPortUnknown

Physical Port

cevPowerSupplyAC1360W

Equipment

cevPowerSupplyC7200AC

Equipment

cevSensorClock

Equipment

cevSensorFanTrayStatus

Equipment

cevSensorModuleDeviceTemp

Equipment

cevSensorModuleInletTemp

Equipment

cevSensorModuleOutletTemp

Equipment

cevSensorModulePowerOutputFail

Equipment

cevSensorPSFan

Equipment

cevSensorPSInput

Equipment

cevSensorPSOutput

Equipment

cevSensorVtt

Equipment

cevWicSerial1t

Equipment


Logical Specification Lineage

Example 9-1 shows a logical specification lineage. This lineage shows the intended relationship between specifications.

Example 9-1 Logical Specification Lineage

deviceGeneric
     [0..*] interfaceGeneric
           [0..1] GenericMedia
                 [0..1] IP Addresses
                       [0..*] IpAddress
                              IpAddress (characteristic)
                              Prefix (characteristic)
                              IpVersion (characteristic)
           [0..1] Atm Media
                 [0..1] IP Addresses
                       [0..*] IpAddress
                              IpAddress (characteristic)
                              Prefix (characteristic)
                              IpVersion (characteristic)
                 [0..1] AtmInterfaceConfigurationData
                 [0..*] VirtualChannelLink
                       [0..1] VPI
                       [0..1] VCI
                       [0..1] VirtualChannelLinkData
           [0..1] FrameRelayMedia
                 [0..1] IP Addresses
                       [0..*] IpAddress
                              IpAddress (characteristic)
                              Prefix (characteristic)
                              IpVersion (characteristic)
                 [0..*] DLCI
                       [0..1] FrameRelayData
                       [0..1] FrameRelatExtendedData
           [0..1] VlanMembership
                 [0..1] IP Addresses
                       [0..*] IpAddress
                              IpAddress (characteristic)
                              Prefix (characteristic)
                              IpVersion (characteristic)
                 [0..*] Vlan

Physical Specification Lineage

This section displays the specification lineages for the three out-of-the-box supported devices integrated with UIM:

cisco3640

Example 9-2 shows a specification lineage for cisco3640. This lineage shows the intended relationship between specifications.

Example 9-2 cisco3640 Specification Lineage

cisco3640   cevChassis3640      cevContainerSlot         cevPmCpm2e2w            cevPortAMDP2            cevContainerDaughterCard               cevWicSerial1t                  cevPortQuiccSerial         cevPmM4t            cevPortMueslix

cisco7206VXR

Example 9-3 shows a specification lineage for cisco7206VXR. This lineage shows the intended relationship between specifications.

Example 9-3 cisco7206VXR Specification Lineage

cisco7206VXR    cevChassis7206Vxr        cevCpu7200Npe300        cevContainerSlot           cevModuleUnknownCard              cevPortFEIP           cevPaAtmdxMmOc3             cevPortUnknown           cevModuleVipPortAdapters            cevPortMueslix           cevPaE3MuxCbr120e1            cevPortUnknown            cevPortDCUATMPort           cevPowerSupplyC7200AC           cevPa8e            cevPortAMDP2

cat6509

Example 9-4 shows a specification lineage for cat6509. This lineage shows the intended relationship between specifications.

Example 9-4 cat6509 Specification Lineage

cat6509
   cevChassisCat6509
      cevBackplaneCat6000
         cevContainerVtt
            cevCat6kWsc6kvtt
               cevSensorVtt
         cevSensorVtt
         cevContainerClock
                cevCat6kWsc6000cl
                cevSensorClock
                cevSensorClock
              cevBackplaneCat6500
                cevContainerVtt
                cevCat6kWsc6kvtt
                       cevSensorVtt
                cevSensorVtt
                 cevContainerClock
                cevCat6kWsc6000cl
                        cevSensorClock
                cevSensorClock
        
           cevContainerFanTraySlot
        cevFanWSC6k9SlotFan
              cevSensorFanTrayStatus
        cevContainerPowerSupplyBay
        artificial6509PowerSupplyHolderCard
                artificial6509PowerSupplySlot
                cevPowerSupplyAC1360W
                       cevSensorPSFan
                cevSensorPSInput
                cevSensorPSOutput
   cevContainerSlot
        cevCat6kWsxSup1a2ge
        cevCpuCat6kWsxSup1a2ge
                cevSensorModuleOutletTemp
                cevSensorModulePowerOutputFail
                 cevSensorModuleInletTemp
                cevSensorModuleDeviceTemp
                 cevContainerDaughterCard
                cevWicSerial1t
                cevPortQuiccSerial
                cevCat6kWsf6kPfc
                cevSensorModuleOutletTemp
                       cevSensorModuleInletTemp
                    artificial6509MSFCCard
                cevModuleCat6000Type
                          cevSensorModuleOutletTemp
                        cevSensorModuleInletTemp
                cevCpuCat6kMsfc
        artificial6509ContainerGbic
              cevPortGigBaseLH
        cevCat6kWsx6248Rj45
        cevSensorModulePowerOutputFail
        cevSensorModuleInletTemp
        cevSensorModuleDeviceTemp
           cevPortFe
        cevCat6kWsx6348Rj45
           cevSensorModulePowerOutputFail
        cevSensorModuleInletTemp
           cevSensorModuleDeviceTemp
   cevPortFe

Discovery Action

Table 9-4 shows the discovery action in the Cisco Router and Switch UIM Integration cartridge.

Table 9-4 Discover Enhanced Cisco SNMP Action

Result Category AddressHandler UI Parameters Model Processors

Device

IPAddressHandler

  • version

  • Enum {v1, v2c, v3}

  • port, String

  • snmpReadCommunity, String

  • snmpTimeout, String

  • snmpRetries, String

  • username, String

  • contextName, String

  • authProtocol, Enum {MD5, SHA}

  • authPassword, String

  • privacyProtocal Enum {DES}

  • privacyPassword, String

MIB II Model, Cisco Model, and Cisco UIM Model

  • MIB II Properties Initializer

  • Cisco SNMP Properties Initializer

  • MIB II SNMP Collector

  • MIB II SNMP Modeler

  • Cisco SNMP Logical Collector

  • Cisco SNMP Physical Collector

  • Cisco SNMP Logical Modeler

  • Cisco SNMP Physical Modeler

  • Cisco Enhanced Modeler


Figure 9-1 depicts the action chain for the discover action.

Figure 9-1 Discover Action Chain

Discover Action Chain

Table 9-5 shows discovery actions for various discovery processors.

Table 9-5 Discover Enhanced Cisco SNMP Action Processors

Processor Name Variable

MIB II Properties Initializer

Input: N/A

Output:

  • snmpIfTypeMap

    Property map containing listing of ifTypes to string name.

  • snmpVendorNameMap

    Property map containing listing of sysObjectId suffixes to vendorName.

Cisco SNMP Properties Initializer

Input: N/A

Output:

  • ciscoProductsMap

    A mapping from the vendor specific portion of the sysObjectId to Cisco Device model name

  • ciscoVendorNumbers

    A list containing supported Cisco vendor numbers.

  • ciscoVendorTypesMap

    A mapping from entPhysicalVendorType to Cisco equipment part name.

MIB II SNMP Collector

Input: N/A

Output:

MIB II SNMP Modeler

Input:

  • mibiisnmpCollectorResponseDocument

    SNMP discovered data produced by the MIB II SNMP Collector.

  • snmpIfTypeMap

    Property map containing listing of ifTypes to string name.

Output:

  • deviceInterfaceMap

    A map that contains interfaces with IfIndex as key.

  • logicalDevice

    This is the logical device that was created in the MIB II Modeler.

Cisco SNMP Logical Collector

Input: N/A

Output:

Cisco SNMP Physical Collector

Input: N/A

Output:

Cisco SNMP Logical Modeler

Input:

  • ciscoSNMPLogicalCollectorResponseDocument

    SNMP discovered data produced by the Cisco SNMP Logical Collector.

  • ciscoVendorNumbers

    A list containing supported Cisco vendor numbers.

  • deviceInterfaceMap

    A map that contains interfaces with IfIndex as key.

  • logicalDevice

    This is the logical device that was created in the MIB II Modeler.

  • mibiisnmpCollectorResponseDocument

    SNMP discovered data produced by the MIB II SNMP Collector.

Output:

  • ciscoLogicalDevice

    This is the logical device that was created in the Cisco SNMP Logical Modeler.

Cisco SNMP Physical Modeler

Input:

  • ciscoSNMPPhysicalCollectorResponseDocument

    SNMP discovered data produced by the Cisco SNMP Physical Collector.

  • ciscoProductsMap

    A mapping from the vendor specific portion of the sysObjectId to Cisco Device model name.

  • ciscoVendorTypesMap

    A mapping from entPhysicalVendorType to Cisco equipment part name.

  • logicalDevice

    This is the logical device that was created in the MIB II Modeler.

  • mibiisnmpCollectorResponseDocument

    SNMP discovered data produced by the MIB II SNMP Collector.

  • snmpVendorNameMap

    Property map containing listing of sysObjectId suffixes to vendorName.

Output: N/A

Cisco Enhanced Modeler

Input:

  • logicalDevice

    This is the logical device that was created in the MIB II Modeler.

Output: N/A


Import Action

Table 9-6 shows the import action in the Cisco Router and Switch UIM Integration cartridge.

Table 9-6 Import Cisco from UIM Action

Result Category AddressHandler UI Parameters Model Processors

Device

N/A

  • LogicalDevice ID, String

  • LogicalDevice ID Qualifier, Enum

  • {Equals, Equals ignore case, Begins with, Begins with ignore case, Ends with, End with ignore case, Contains, Contains ignore case}

  • Name, String

  • Name Qualifier, Enum {Equals, Equals ignore case, Begins with, Begins with ignore case, Ends with, End with ignore case, Contains, Contains ignore case}

  • Management IP Address, String Management IP Address Qualifier, Enum {Equals, Equals ignore case, Begins with, Begins with ignore case, Ends with, End with ignore case, Contains, Contains ignore case}

  • Assignment State, Enum {None, Unassigned, Pending Unassign, Pending Assign, Disconnected, Transitional, Ported, Unavailable, Pending Unavailable, Pending Available, Assigned}Admin State, Enum {None, Installed, End of Life, Pending Install, Pending Unavailable, Unavailable, Pending Remove, Planned}

  • Admin State, Enum {None, Installed, End of Life, Pending Install, Pending Unavailable, Unavailable, Pending Remove, Planned}

  • MIB II Model

  • Cisco Model

  • Cisco UIM Model

  • Cisco UIM Initializer

  • Logical Device UIM Finder

  • MIB II UIM Importer

  • Physical UIM Modeler

  • MIB II UIM Persister

  • Physical Device UIM Finder

  • Physical Device UIM Importer

  • Physical Device UIM Persister


Figure 9-2 depicts the action chain for the import action.

Figure 9-2 Import Action Chain

Import Action Chain

Table 9-7 shows import actions for import discovery processors.

Table 9-7 Actions For Import Processors

Processor Name Variable

Cisco UIM Initializer

Input: N/A

Output:

  • physicalDeviceIdSet

    Instantiated cache to hold a set of Physical Device IDs imported from UIM inventory as part of Logical Device association.

Logical Device UIM Finder

Input: N/A

Output:

  • uimLogicalDeviceIDs

    A list of String IDs. Each ID fetches a single Logical Device entity from UIM. The list of logical devices matches the search criteria input in the Network Integrity UI

  • uimWSConnection

    Holds the UIM Web services Port object, which is used to run Web service operations.


Table 9-8 shows processors that are encompassed in a For Each that iterates through the uimLogicalDeviceIDs list produced by the “Logical Device UIM Finder”.

Table 9-8 Actions For Import Processors (For Each)

Processor Name Variable

MIB II UIM Importer

Input:

  • uimLDevID

    A single Logical Device ID that can be use to fetch a Logical Device entity from UIM.

  • uimWSConnection

    Holds the UIM Web services Port object, which is used to run Web service operations.

Output:

  • ldev

    Network Integrity-representation of Logical Device. The tree can be traversed by following the DeviceInterface relationship.

  • uimLDev

    UIM WS representation of Logical Device tree.

Physical UIM Modeler

Input:

  • ldev

    Network Integrity representation of Logical Device. The tree can be traversed by following the DeviceInterface relationship.

  • physicalDeviceIdSet

    Set of Physical Device IDs imported from UIM inventory as part of Logical Device association

  • uimLDev

    The UIM WS representation of the Logical Device tree produced by the MIB II UIM Importer.

  • uimWSConnection

    Holds the UIM Web services Port object, which is used to run Web service operations.

Output:

  • pdev

    Network Integrity representation of Physical Device

  • uimPDev

    UIM WS representation of Physical Device tree.

MIB II UIM Persister

Input: N/A

Output: N/A


Table 9-9 shows actions for import processors.

Table 9-9 Actions For Import Processors

Processor Name Variable

Physical Device UIM Finder

Input:

  • physicalDeviceIdSet

    Set of Physical Device IDs imported from UIM as part of Logical Device association.

  • uimWSConnection

    Holds the UIM Web services Port object, which is used to run Web service operations.

Output:

  • standalonePhysicalDeviceIDList

    List of standalone physical device IDs.


Table 9-10 shows processors that are encompassed in a For Each that iterates through the standalonePhysicalDeviceIDList list produced by the “Physical Device UIM Finder”.

Table 9-10 Actions For Import Processors (For Each)

Processor Name Variable

Physical Device UIM Importer

Input:

  • standalonePDevID

    A single Physical Device ID that can be use to fetch a Physical Device entity from UIM

  • uimWSConnection

    Holds the UIM Web services Port object, which is used to run Web service operations.

Output:

  • ldev

    Network Integrity-representation of Logical Device. The tree can be traversed by following the DeviceInterface relationship.

Physical Device UIM Persister

Input: N/A

Output: N/A


Discrepancy Detection Action

Table 9-11 shows the discrepancy detection action in the Cisco Router and Switch UIM Integration cartridge.

Table 9-11 Detect Enhanced Cisco Discrepancies Action

Result Category AddressHandler UI Parameters Model Processors

Device

N/A

N/A

N/A

  • MIB II UIM Filters Initializer

  • Cisco UIM Filters Initializer

  • Discrepancy Detector


Figure 9-3 depicts the action chain for the discrepancy action.

Figure 9-3 Discrepancy Action Chain

Discrepancy Action Chain

Table 9-12 shows discrepancy detection processors.

Table 9-12 Detect Enhanced Cisco Discrepancies Action Processors

Processor Name Variable

MIB II UIM Filters Initializer

Input: N/A

Output: N/A

Cisco UIM Filters Initializer

Input: N/A

Output: N/A

Discrepancy Detector

Input: N/A

Output: N/A


Discrepancy Resolution Action

Table 9-13 shows the discrepancy resolution action in the Cisco Router and Switch UIM Integration cartridge.

Table 9-13 Resolve Cisco in UIM Action

Resolution Action Label Result Source AddressHandler UI Parameters Model Processors

Correct in UIM

Device

N/A

N/A

N/A

  • Resolution Framework Initializer

  • Cisco UIM Resolution Initializer

  • MIB II UIM Resolution Initializer

  • Resolution Framework Dispatcher


Figure 9-4 depicts the action chain for the discrepancy resolution action.

Figure 9-4 Discrepancy Resolution Action Chain

Discrepancy Resolution Action Chain

Table 9-14 shows discrepancy resolution processors.

Table 9-14 Discrepancy Resolution Processors

Discovery Processor Variable

Resolution Framework Initializer

Input: N/A

Output:

  • baseResolutionElement

    An initialized BaseResolutionElement object, which contains a map of Discrepancies to their appropriate Discrepancy Handler.

  • uimWebService

    A handle for the UIM Web service.

MIB II UIM Resolution Initializer

Input:

  • baseResolutionElement

    The baseResolutionElement object as produced by the Resolution Framework Initializer

  • uimWebService

    A handle for the UIM Web service.

Output: N/A

Discrepancy Detector

Input:

  • baseResolutionElement

    The baseResolutionElement object as produced by the Resolution Framework Initializer.

  • uimWebService

    A handle for the UIM Web service.

Output: N/A

Resolution Framework Dispatcher

Input:

  • baseResolutionElement

    The baseResolutionElement object as produced by the Resolution Framework Initializer.

Output: N/A