6 About Design Studio Construction

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

Model Collections

Table 6-1 shows the MIB-II model collection used in the Cisco Router and Switch SNMP cartridge.

Table 6-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 6-2 shows the Cisco model collection.

Table 6-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 (for example, Chassis, Backplane, Module).
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.

Logical Specification Lineage

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

Example 6-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 provides an example of a physical specification lineage.

Example 6-2 shows a physical specification lineage.

Example 6-2 Physical Specification Lineage

physicalDeviceGeneric
     [0..*] equipmentGeneric
           [0..*] equipmentHolderGeneric
                 [0..1] equipmentGeneric
           [0..*] physicalPortGeneric
           [0..*] equipmentGeneric

Discovery Action

Table 6-3 shows the discovery action in the Cisco Router and Switch SNMP cartridge.

Table 6-3 Discover Generic Cisco SNMP Action

Result Category	AddressHandler	Scan Parameters	Model	Processors
Device	IPAddressHandler	version port snmpReadCommunity snmpTimeout snmpRetries username contextName authProtocol authPassword privacyProtocol privacyPassword Note: These scan parameters must be added for the Create Scan web service request even if the values are left empty.	MIB-II Model and Cisco 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

Figure 6-1 displays the Discover Generic Cisco SNMP action chain.

Figure 6-1 Discover Generic Cisco SNMP Action Flow

Discovery Processors

Table 6-4 shows the processors of the Discover Generic Cisco SNMP action.

Table 6-4 Discover Generic Cisco SNMP Action Processors

Processor Name	Variable
MIB-II Properties Initializer	Input: N/A Output: snmpIfTypeMap Property map containing a listing of ifTypes to string name. snmpVendorNameMap Property map containing listing of sysObjectId suffixes to vendorName.
Cisco SNMP Properties Initializer	Input: N/A Output: ciscoProductMap A mapping from the vendor portion of the sysObjectId to the Cisco Device model name. ciscoVendorNumber 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.
CPU Property Initializer	Input: N/A Output: cpuProperties This class is used to initialize and set the default CPU value for the device.
Cisco CPU Collector	Input: N/A Output: cpmCPUTotal5secRev cpmCPUTotal1minRev cpmCPUTotal5minRev
Device CPU Set Processor	Input: N/A ciscoCPUCollectorResponseDocument SNMP discovered data produced by the Cisco CPU Collector. cpuProperties This class is used to initialize and set the default CPU value for the device. Output: N/A
CPU Utilization Compare Processor	Input: N/A cpuProperties This class is used to initialize and set the default CPU value for the device. Output: N/A
MIB-II SNMP Collector	Input: N/A Output: mibiisnmpCollectorResponseDocument (implicit) Polled SNMP data, see "About Poll Lists".
MIB-II SNMP Modeler	Input: mibiisnmpCollectorResponseDocument Discovered SNMP 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 The logical device that was created by the MIB-II Modeler processor.
Cisco SNMP Logical Collector	Input: N/A Output: ciscoSNMPLogicalCollectorResponseDocument (implicit) Polled SNMP data, see "About Poll Lists".
Cisco SNMP Physical Collector	Input: N/A Output: ciscoSNMPPhysicalCollectorResponseDocument (implicit) Polled SNMP data, see "About Poll Lists".
Cisco SNMP Logical Modeler	Input: ciscoSNMPLogicalCollectorResponseDocument SNMP discovered data produced by the Cisco SNMP Logical Collector. ciscoVendorNumbers The vendor numbers that are considered Cisco. Only Cisco devices are discovered. 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 of sysObjectId (vendor-specific portion) to Cisco device model names/numbers. ciscoVendorTypesMap A mapping of entPhysicalVendorType OID to equipment part names/numbers. 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: physicalDevice This is the physical device that is created in this Cisco SNMP Physical Modeler.