About Design Studio Construction

7 About Design Studio Construction

This chapter provides information on the composition of the Oracle Communications Network Integrity Generic SNMP cartridge from the Oracle Communications Design Studio perspective.

Model Collections

Table 7-1 shows the MIB-II model collection used in the Generic SNMP cartridge.

Table 7-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 7-2 shows the Generic SNMP model collection.

Table 7-2 Generic SNMP Model Collection

Specifications	Information Model Entity Type	Intended Usage/ Notes
GenericPhysicalDeviceSpecification	PhysicalDevice	Represents any generic physical device discovered on the network.
GenericEquipmentHolderSpecification	EquipmentHolder	Represents any equipment container.
GenericEquipmentShelfSpecification	Equipment	Represents equipment shelf.
GenericEquipmentSpecification	Equipment	Represents equipment card.
GenericPhysicalPortSpecification	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.

Logical Specification Lineage

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

Example 7-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

Physical Specification Lineage

This section provides an example of a physical specification lineage.

Example 7-2 Physical Specification Lineage

GenericPhysicalDeviceSpecification
    [0..*]GenericEquipmentShelfSpecification
        [0..*]GenericEquipmentHolderSpecification
            [1]GenericEquipmentSpecification
                [0..*]GenericPhysicalPortSpecification
                [0..*]GenericEquipmentHolderSpecification
                    [1]GenericEquipmentSpecification
                        [0..*]GenericEquipmentHolderSpecification
                        [0..*]GenericPhysicalPortSpecification

Discovery Action

The Generic SNMP Cartridge supports the Discover Generic SNMP Device action. Table 7-3 shows the discovery action in the Generic SNMP cartridge.

Table 7-3 Discover Generic 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.	Generic_SNMP_Cartridge	CPU Property Initializer (inherited) Generic Device CPU Set Processor CPU Utilization Compare Processor (inherited) MIB II Properties Initializer (inherited) DI Name remodel Initializer (inherited) MIB II SNMP Collector (inherited) MIB II SNMP Modeler (inherited) Generic SNMP Logical Collector Generic SNMP Logical Modeler DI Name Remodeler (inherited) Generic SNMP Physical Collector Generic SNMP Physical Modeler

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.

Generic_SNMP_Cartridge

CPU Property Initializer (inherited)
Generic Device CPU Set Processor
CPU Utilization Compare Processor (inherited)
MIB II Properties Initializer (inherited)
DI Name remodel Initializer (inherited)
MIB II SNMP Collector (inherited)
MIB II SNMP Modeler (inherited)
Generic SNMP Logical Collector
Generic SNMP Logical Modeler
DI Name Remodeler (inherited)
Generic SNMP Physical Collector
Generic SNMP Physical Modeler

Discovery Processors

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

Table 7-4 Discovery Processors

Processor Name	Variable
CPU Property Initializer	Input: N/A Output: cpuProperties This class is used to initialize and set the default CPU value for the device.
Generic Device CPU Set Processor	Input: Custom CPU Collector processor Response Output: N/A
CPU Utilization Compare Processor	Input: cpuProperties This class is used to initialize and set the default CPU value for the device. Output: N/A
MIB-II PropertiesInitializer	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.
DI Name remodel Initializer (inherited)	Input:N/A Output: remodelerProperties Properties object contains device interface re-modeling information.
MIB II SNMP Collector	Input: N/A Output: mibiisnmpCollectorResponseDocument (implicit) For more information about 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.
Generic SNMP Logical Collector	Input: N/A Output: genericSNMPLogicalCollectorResponseDocument (implicit) For more information about polled SNMP data, see "About Poll Lists".
Generic SNMP Logical Modeler	Input: genericSNMPLogicalCollectorResponseDocument SNMP discovered data produced by the Generic SNMP Logical Collector. 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: genericLogicalDevice This is the logical device that was created in the Generic SNMP Logical Modeler.
DI Name Remodeler	Input: snmpIfTypeMap Property map containing a listing of ifTypes to string name. snmpVendorNameMap Property map containing listing of sysObjectId suffixes to vendorName. logicalDevice The logical device that was modified by Generic SNMP Logical Modeler. deviceInterfaceMap A map that contains interfaces with IfIndex as key. remodelerProperties Properties object contains device interface Re-Modeling information. Output: N/A
Generic SNMP Physical Collector	Input: N/A Output: genericSNMPPhysicalCollectorResponseDocument (implicit) For more information about polled SNMP data, see "About Poll Lists".
Generic SNMP Physical Modeler	Input: genericSNMPPhysicalCollectorResponseDocument SNMP discovered data produced by the Generic SNMP Physical Collector. 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: physicalDevice This is the physical device that is created in this Generic SNMP Physical Modeler.

Discrepancy Detection Action

The Detect Generic Device UIM Discrepancies action is used to perform discrepancy detection.

Table 7-5 Detect Generic Device UIM Discrepancies

Result Category	Results Source	Scan Parameters	Model	Processors
All	Discover Generic SNMP Device	N/A	Generic_SNMP_Cartridge	This action extends the Abstract Detect UIM Discrepancies action included in the UIM Integration cartridge. For more information, see Network Integrity UIM Integration Cartridge Guide.

Discrepancy Resolution Action

The Resolve Generic Device in UIM action is used to perform discrepancy resolution.

Table 7-6 Resolve Generic Devices in UIM

Result Category	Result Source	Processors
All	Discover Generic SNMP Device	This action extends the Abstract Resolve in UIM action included in the Network Integrity UIM Integration cartridge. For more information, see Network Integrity UIM Integration Cartridge Guide.