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

• cisco7206VXR

• cat6509

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

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: mibiisnmpCollectorResponseDocument (implicit) Polled SNMP data. See Chapter 6, "About Poll Lists."
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: ciscoSNMPLogicalCollectorResponseDocument (implicit) Polled SNMP data. See Chapter 6, "About Poll Lists."
Cisco SNMP Physical Collector	Input: N/A Output: ciscoSNMPLogicalCollectorResponseDocument (implicit) Polled SNMP data. See Chapter 6, "About Poll Lists."
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

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

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

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