7 About Cartridge Modeling

This chapter provides information on modeling the Network Integrity MIB-II Unified Inventory Management (UIM) Integration cartridge.

Displaying the MIB-II UIM Integration Cartridge UML Representation

Figure 7-1 displays a Unified Modeling Language (UML) diagram depicting the object relationship being rendered.

Figure 7-1 MIB-II UIM Integration Cartridge UML Representation

Displays a UML representation of MIB-II UIM integration

Hierarchy Mapping

The logical device object is established and seeded with data sourced by RFC1213-MIB.mgmt.mib-2.system tables.

As a device is discovered, the media interface encapsulates common information about that interface. The device interface configuration captures the media type information that decorates the interface with media-specific parameters that define its behavior (that is; Generic, ATM, Frame Relay or VLAN). This cartridge supports only Generic.

Interfaces are established and seeded with data sourced by:

RFC1213-MIB.mgmt.mib-2.system
RFC1213-MIB.mgmt.mib-2.interfaces.ifTable
IF-MIB.mgmt.mib-2.ifMIB.ifMIBObjects.ifXTable.ifXEntry
IP-MIB.mgmt.mib-2.ip.ipAddressTable.ipAddressEntry

The interface hierarchy is established by:

F-MIB.mgmt.mib-2.ifMIB.ifMIBObjects.ifStackTable.ifStackEntry.ifStackStatus

Device interface configuration is established and seeded with data sourced by:

RFC1213-MIB.mgmt.mib-2.ip.ipAddrTable.ipAddrEntry
IP-MIB.mgmt.mib-2.ip.ipAddressTable.ipAddressEntry

Oracle Communications Information Model Information

The logical device and media interface objects are Oracle Communications Information Model 1.0 compliant for static fields. The dynamic fields (sometimes referred to as characteristics) are considered application-specific.

The device interface configuration is considered a mechanism to customize the media interface to show application specific data (see Figure 7-1).

This cartridge supports only generic media. Other cartridges support other configurations:

AtmMedia
FrameRelayMedia
VLAN Membership

For a listing of the Information Model fields, see Field Mappings.

Field Mappings

This section provides information about field mappings used in the cartridge.

Text: implies Text [255].

static: the Information Model 1.0 defines this field to be static on the entity specification. The specification provides getters/setters for this field.

dynamic: This is a dynamic field where the entity specification treats the field as a name value pair. The specification does not provide getter/setters but generically has a get/setCharacteristics method holding a HashSet of entries.

Logical Device Mapping

Table 7-1 shows the logical device mapping for the MIB-II UIM Integration cartridge.

Table 7-1 Logical Device Mapping

Logical Device	Information Model Support	MIB Object	Field Type	Notes
Id	static	N/A	Text	Programmatically generated as MgmtIPAddress::sysName::"LogicalDevice"
Name	static	sysName	Text	N/A
Description	static	sysDescr	Text	N/A
Specification	static	N/A	N/A	Programmatically applies specification “deviceGeneric”
nativeEmsAdminServiceState	static	N/A	Enum: UNKNOWN OUT_OF_SERVICE TESTING IN_SERVICE IN_MAINTENANCE	No source
nativeEmsServiceState	static	N/A	Enum: UNKNOWN OUT_OF_SERVICE TESTING IN_SERVICE IN_MAINTENANCE	No source
nativeEmsName	static	sysName	Text	N/A
mgmtIpAddress	dynamic	N/A	Text	discoveryAddress
sysObjectId	dynamic	sysObjectId	Text	Support legacy systems

Media Interface Mapping

Table 7-2 shows the media interface mapping for the MIB-II UIM Integration cartridge.

Table 7-2 Media Interface Mapping

Media Interface	Information Model Support	MIB Object	Field Type	Notes
Id	static	N/A	Text	Programmatically generated asMgmtIPAddress:: sysName::ifDesc::"MediaInterface"
Name	static	ifDescr	Text	N/A
Description	static	ifDescr	Text	N/A
Specification	static	N/A	N/A	Programmatically applies specification "interfaceGeneric"
interfaceNumber	static	N/A	Text	No source
customerInterfaceNumber	static		Text	No source
vendorInterfaceNumber	static	ifName	Text	N/A
nativeEmsName	static	ifDesc	Text	Field must be unique, ifDescr guarantees uniqueness in device.
nativeEmsAdminServiceState	static	ifAdminStatus	Enum: UNKNOWN OUT_OF_SERVICE TESTING IN_SERVICE IN_MAINTENANCE	Mapped See Mapping Table
nativeEmsServiceState	static	ifOperStatus	Enum: UNKNOWN OUT_OF_SERVICE TESTING IN_SERVICE IN_MAINTENANCE	Mapped See Mapping Table
ifType	dynamic	ifType	Text	Mapped from IANA MIB using properties file "snmpIfTypeMap". Look up returning null results in value of "n"
mtuSupported	static	N/A	Float	No source. Defaults to 0.0
mtuCurrent	static	ifMtu	Float	N/A
physicalAddress	static	ifPhysAddress	Text	N/A
physicalLocation	static	sysLocation	Text	N/A
minSpeed	static	N/A	Float	No source. Defaults to 0.0
maxSpeed	static	N/A	Float	No source. Defaults to 0.0
nominalSpeed	static	ifSpeed \| ifHighSpeed	Float	ifHighSpeed overrides ifSpeed when ifHighSpeed is available
ifAlias	dynamic	ifAlias	Text	N/A
ifName	dynamic	ifName	Text	Support legacy systems

Device Interface Configuration Mapping (IPv4)

Table 7-3 shows the device interface configuration mapping for Internet Protocol, Version 4, for the MIB-II UIM Integration cartridge.

Table 7-3 Device Interface Configuration Mapping (IPv4)

Generic Media	Information Model Support	MIB Object	Field Type	Notes
ipaddress	dynamic	ipAdEntAddr	Text	N/A
prefix	dynamic	ipAdEntNetMask	Text	N/A
ipVersion	dynamic	ipAddressType	Enum {IPV4 \| IPV6}	Programmatically set to IPV4
Specification	static	N/A	N/A	Programmatically applies specification "GenericMedia"

Device Interface Configuration (IPv6)

Table 7-4 shows the device interface configuration for the Internet Protocol, Version 6 for the MIB-II UIM Integration cartridge.

Table 7-4 Device Interface Configuration Mapping (IPv6)

Generic Media	Information Model Support	MIB Object	Field Type	Notes
ipAddress	dynamic	ipAddressIfIndex	Text	For IP v6 addresses, the actual IP is derived from the index since ipAddressAddr is not accessible
prefix	dynamic	ipAddressPrefix	Text	N/A
ipVersion	dynamic	ipAddressType	Enum {IPV4 \| IPV6}	Programmatically set to IPV6
Specification	static	N/A	N/A	Programmatically applies specification "GenericMedia"

Mapping Table

Table 7-5 shows the mapping of ifOperStatus/ifAdminStatus to nativeEms(Admin)ServiceState.

Table 7-5 Mapping Table

ifOperStatus	ifAdminStatus	nativeEmsServiceStatenativeEmsAdminState
4: unknown, 6: notPresent	N/A	UNKNOWN
1: up	1: up	IN_SERVICE
2: down 5: dormant 7: lowerLayerDown	2: down	OUT_OF_SERVICE
3: testing	3: testing	TESTING
N/A	N/A	IN_MAINTENANCE