Oracle® Communications Network Integrity Release 7.1

Oracle® Communications Network Integrity
UIM MIB-II Logical Device Sample Technology Pack Guide
Release 7.1
E23709-01
January 2012
This guide describes the functionality and design of the Oracle Communications
Network Integrity Unified Inventory Management (UIM) MIB-II Logical Device
Sample Technology Pack, an additional component of the Network Integrity MIB-II
UIM Integration Cartridge.
This guide assumes that the reader has a conceptual understanding of UIM, and
Network Integrity. In addition, you should read the Developer's Guides for UIM and
Network Integrity to gain an overview of development practices. To better understand
the Oracle Common Information Model, see Network Integrity Developer’s Guide.
This guide should be read from start to finish because the information presented in a
section often builds upon information presented in a preceding section.
Audience
This guide is intended for Network Integrity and UIM administrators who want to
understand the design and evaluate the functionality of this technology pack and for
Network Integrity and UIM developers who want either to build or to extend similar
cartridges that integrate with UIM.
The developers and administrators should have a good working knowledge of UIM
and Design Studio for UIM. Design Studio is an Eclipse-based integrated development
environment used to extend Network Integrity through standard Java practices.
Modeling a Logical Device Hierarchy
This technology pack is an integration component to Network Integrity. It allows UIM
to generically represent discovered devices.
The technology pack enables you to model logical device hierarchies composed of
logical device and child interfaces.
Reviewing and Extending Technology Packs in Design Studio
You can download a ZIP file that contains the individual Design Studio files, and you
can open these file in Design Studio to review and extend the technology pack.
See Design Studio online Help and Network Integrity Developer’s Guide for information
about opening files in Design Studio. See Network Integrity Concepts for information
about extending technology packs.
1
Opening the Cartridge Files in Design Studio
To review and extend the MIB-II UIM Integration cartridge, you must first download
the Oracle Communications Network Integrity MIB-II UIM Integration Cartridge
media pack from the Oracle software delivery Web site:
https://edelivery.oracle.com
The media pack contains the MIB-II UIM Integration cartridge ZIP file, which has the
following structure:
■
\UIM_Cartridge_Projects\
■
\Network_Integrity_Cartridge_Projects\
The project \UIM_Cartridge_Projects\ora_ni_uim_device_sample contains the
technology pack.
See the Design Studio online Help and UIM Developer’s Guide for information about
opening files in Design Studio.
Installing in UIM
To install in UIM, you clean and build the technology pack in Design Studio for UIM.
You then install the generated JAR file into UIM.
Before installing the ora_ni_uim_device_sample technology pack, you must install the
following base cartridges if they are not previously installed:
■
Base measurements cartridge: ora_uim_basemeasurements.jar
■
Base rule sets cartridge: ora_uim_baserulesets.jar
■
Base extension points cartridge: ora_uim_baseextpts.jar
The base cartridges are located in the UIM_HOME/metasolv/technology-packs/base
directory. See UIM Base Cartridges Guide for information about how to install these base
cartridges.
After installing the base cartridges, install the ora_ni_uim_device_sample.jar. See the
UIM online Help and UIM Installation and System Administration Guide for detailed
instructions about installing technology packs.
Specifications
This section lists the specifications included in the UIM MIB-II Logical Device Sample
Technology Pack.
Logical Device: deviceGeneric
This specification models a generic logical device entity.
This specification is used to model a logical device discovered by Network Integrity.
Table 1 shows the characteristics applied to the generic device specification.
2
Table 1
Characteristics Applied to the deviceGeneric Specification
Characteristics
Field
Type
Field Content
mgmtIpAddress
String
Text
Mgmt Address of
discovered device
Enum with the following values:
Device
administered
state
nativeEmsAdminServiceState Drop
Down
box
nativeEmsServiceState
Drop
Down
box
■
UNKNOWN
■
IN_SERVICE
■
OUT_OF_SERVICE
■
TESTING
■
IN_MAINTENANCE
Enum with the following values:
■
UNKNOWN
■
IN_SERVICE
■
OUT_OF_SERVICE
■
TESTING
■
IN_MAINTENANCE
nativeEmsName
String
Text
sysObjectId
String
Text
Intended Usage/
Notes
Device actual
state
The vendor's
authoritative
identification of
the network
management
subsystem
contained in the
entity.
DeviceInterface: interfaceGeneric
This specification models a generic interface entity.
This specification is used to model an interface discovered by Network Integrity.
Table 2 shows the characteristics applied to the interfaceGeneric specification.
Table 2
Characteristics Applied to the interfaceGeneric Specification
Characteristics
Field
Type
Field Content
nativeEmsName
String
Text
nativeEmsAdminServiceState
String
3
Intended Usage/
Notes
Alternate name
this interface
could be known
by.
Enum with the following values:
■
UNKNOWN
■
IN_SERVICE
■
OUT_OF_SERVICE
■
TESTING
■
IN_MAINTENANCE
Interface
administered
state.
Table 2 (Cont.) Characteristics Applied to the interfaceGeneric Specification
Characteristics
nativeEmsServiceState
Field
Type
Drop
Down
box
Intended Usage/
Notes
Field Content
Enum with the following values:
■
UNKNOWN
■
IN_SERVICE
■
OUT_OF_SERVICE
■
TESTING
■
IN_MAINTENANCE
Interface actual
state
ifType
Drop
Down
box
Text
IANA iftype
mtuSupported
String
Text (numeric)
Max allowed
MTU
mtuCurrent
String
Text (numeric)
Current Value of
MTU
physicalAddress
String
Text
Interface's
address at its
protocol
sub-layer.
physicalLocation
String
Text
Location of
interface
minSpeed
String
Text (numeric)
Minimum speed
of interface
maxSpeed
String
Text (numeric)
Max speed of
interface
nominalSpeed
String
Text (numeric)
Nominal speed of
interface
ifAlias
String
Text
Alternate name
this interface
could be known
by
ifName
String
Text
Alternate name
this interface
could be known
by
Other Characteristics
This technology pack additionally models the following characteristics. These
characteristics are not used by this technology pack, but they are used by ora_ni_uim_
cisco_device_sample which extends this technology pack.
Table 3 shows the characteristics used by ora_ni_uim_cisco_device_sample.
Table 3
Characteristics used by ora_ni_uim_cisco_device_sample
Field
Content
Intended Usage/
Notes
discoveredModelNumber String
Text
All Physical Equipment
discoveredPartNumber
Text
All Physical Equipment
Characteristics
Field
Type
String
4
Table 3 (Cont.) Characteristics used by ora_ni_uim_cisco_device_sample
Characteristics
Field
Type
Field
Content
Intended Usage/
Notes
discoveredVendorName
String
Text
All Physical Equipment
hardwareRev
String
Text
All Physical Equipment
softwareRev
String
Text
All Physical Equipment
modelName
String
Text
All Physical Equipment
serialNumber
String
Text
All Physical Equipment
Specification Lineage
deviceGeneric
[0.100000] interfaceGeneric
[0.100000] interfaceGeneric
Examples
Figure 1 shows a logical device hierarchy.
Figure 1 Sample Logical Device Hierarchy
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
5
Access to Oracle Support
Oracle customers have access to electronic support through My Oracle Support. For
information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or
visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing
impaired.
Oracle Communications Network Integrity UIM MIB-II Logical Device Sample Technology Pack Guide, Release 7.1
E23709-01
Copyright © 2010, 2012, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected
by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate,
broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering,
disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them
to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the
following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government
customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and
agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions
and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the
additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway,
Redwood City, CA 94065.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use
in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in
dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe
use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks
or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered
trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle
Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products,
and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of
third-party content, products, or services.
6