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