B UCS MIBRef
B UCS MIBRef
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://
www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
Preface Preface v
Conventions v
Related Cisco UCS Documentation vi
Documentation Feedback vii
Obtaining Documentation and Submitting a Service Request vii
• Conventions, page v
• Related Cisco UCS Documentation, page vi
• Documentation Feedback, page vii
• Obtaining Documentation and Submitting a Service Request, page vii
Conventions
Text Type Indication
GUI elements GUI elements such as tab titles, area names, and field labels appear in this font.
Main titles such as window, dialog box, and wizard titles appear in this font.
TUI elements In a Text-based User Interface, text the system displays appears in this font.
System output Terminal sessions and information that the system displays appear in this
font.
!, # An exclamation point (!) or a pound sign (#) at the beginning of a line of code
indicates a comment line.
Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the
document.
Tip Means the following information will help you solve a problem. The tips information might not be
troubleshooting or even an action, but could be useful information, similar to a Timesaver.
Caution Means reader be careful. In this situation, you might perform an action that could result in equipment
damage or loss of data.
Timesaver Means the described action saves time. You can save time by performing the action described in the
paragraph.
For a complete list of all C-Series documentation, see the Cisco UCS C-Series Servers Documentation Roadmap
available at the following URL: http://www.cisco.com/go/unifiedcomputing/c-series-doc.
Documentation Feedback
To provide technical feedback on this document, or to report an error or omission, please send your comments
to [email protected]. We appreciate your feedback.
Note Cisco and IETF MIBs are updated frequently. You should download the latest MIBs from Cisco.com
whenever you upgrade the Cisco UCS software versions.
Trap Description
cucsFaultActiveNotif This notification is generated by a Cisco UCS instance
whenever a fault is raised.
The OID for this SNMP trap is
.1.3.6.1.4.1.9.9.719.0.1.
All Cisco UCS Manager faults are available with SNMP using the cucsFaultTable table and the
CISCO-UNIFIED-COMUTING-FAULT-MIB. The table contains one entry for every fault instance. Each
entry has variables to indicate the nature of a problem, such as its severity and type. The same object is used
to model all Cisco UCS fault types, including equipment problems, FSM failures, configuration or
environmental issues, and connectivity issues. The cucsFaultTable table includes all active faults (those that
have been raised and need user attention), and all faults that have been cleared but not yet deleted because of
the retention interval.
The cucsFaultTable table has the same information as the <faultInst> objects that can be queried through
the XML API. In the Cisco UCS Manager GUI, faults are available in from the Admin tab under All > Faults,
Events and Audit Logs > Faults.
The following table describes the attributes exposed by the cucsFaultTable.
Attribute Description
Fault Instance ID (Table Index) A unique integer that identifies the fault.
Affected Object DN The distinguished name of the mutable object that has the
fault.
Affected Object OID The Object identifier (OID) of the mutable object that has
the fault.
Last Modification The time when any of the attributes were modified.
Occurrence The number of times that a fault has occurred since it was
created.
In Release 1.3 and later, Cisco UCS Manager sends a cucsFaultActiveNotif event notification whenever a
fault is raised. There is one exception to this rule: Cisco UCS Manager does not send event notifications for
FSM faults. The trap variables indicate the nature of the problem, including the fault type. Cisco UCS Manager
sends a cucsFaultClearNotif event notification whenever a fault has been cleared. A fault is cleared when the
underlying issue has been resolved.
In Release 1.4 and later, the cucsFaultActiveNotif and cucsFaultClearNotif traps are defined in the
CISCO-UNIFIED-COMPUTING-NOTIFS-MIB. All faults can be polled using SNMP GET operations on
the cucsFaultTable, which is defined in the CISO-UNIFIED-COMPUTING-FAULT-MIB.
For more details about Cisco UCS Manager faults, see Cisco UCS Faults and Error Messages Reference.
Important You should load the MIBs in the order listed to eliminate most of the load-order issues.
• CISCO-UNIFIED-COMPUTING-MIB.my
• CISCO-UNIFIED-COMPUTING-TC-MIB.my
• CISCO-UNIFIED-COMPUTING-FAULT-MIB.my
• CISCO-UNIFIED-COMPUTING-NOTIFS-MIB.my
Trap Description
cucsFaultActiveNotif This notification is generated by a Cisco UCS instance
whenever a fault is raised.
The OID that corresponds to this SNMP trap is
.1.3.6.1.4.1.9.9.719.0.1.
Gathering Statistics
If you want to use SNMP as a way to gather statistics, use the table below as a guide to what MIBs to load
and what tables in each MIB to query.
Note The table lists the statistics most commonly monitored in Cisco UCS Manager, but it does not contain an
exhaustive list of all statistics that can be monitored. To gather statistics beyond those listed below, refer
to Purpose of the Cisco UCS MIBs, on page 15, review the content of the various packages, and download
the additional MIB files necessary to meet your specific needs.
Statistics Type MIB that Gathers the Statistic Statistics Table Name in SNMP
Ethernet CISCO-UNIFIED-COMPUTING-ETHER-MIB etherPauseStats—Packet paused
.1.3.6.1.4.1.9.9.719.1.16 is the parent etherLossStats—Packet loss
OID where the key statistics reside.
etherErrStats—Packet errors
etherTxStats—Packets transmitted
etherRxStats—Packets received
Statistics Type MIB that Gathers the Statistic Statistics Table Name in SNMP
Equipment CISCO-UNIFIED-COMPUTING-EQUIPMENT-MIB equipmentFanStats—Provides all
.1.3.6.1.4.1.9.9.719.1.15 is the parent statistics for every physical fan in every
OID where the key statistics reside. chassis in a UCS domain.
equipmentFanModuleStats—Provides
all fan module temperature statistics for
every fan module in every chasis in a
UCS domain.
equipmentChassisStats—Provides all
chassis level temperature statistics for
every chassis in a UCS domain.
equipmentPsuStats—Provides all
chassis level power and temperature
statistics for every power supply in a UCS
domain.
equipmentIOCardStats—Provides all
chassis level power and temperature
statistics for every fabric extender in a
UCS domain.
Types of MIBs
The Cisco UCS Management is based on the XML over HTTP model, which provides a rich data model to
configure and monitor the system. This model includes polices, service profiles, configuration and monitoring
data, and statistics.
To simplify the integration of Cisco UCS with SNMP based NMS, Cisco UCS Manager exposes the model
through SNMP, based on the following Cisco UCS releases:
• In Release 1.0 and later, IETF networking MIBs, such as the IF-MIB and the ENTITY-MIB are
implemented.
Note The IETF network MIBs provide information specific only to fabric interconnects.
• In Release 1.4 and later, the entire Cisco UCS Manager data model is exposed through the read-only
Cisco UCS MIBs. All objects that can be retrieved through the Cisco UCS Manager XML API can also
be retrieved through Cisco UCS Manager MIBs.
Note Each release maintains complete coverage of the XML API model via private MIBs.
linkDown ifDescr
MIB Description
CISCO-ENTITY-EXT-MIB Extends the entity physical table for modules with processors. For
each of these modules, this MIB provides memory statistics and
LED information.
MIB Description
CISCO-ENTITY-FRU-CONTROL-MIB Manages field replaceable units, such as power supplies, fans, and
modules.
Step 2 From the Unified Computing drop-down list, choose UCS Manager.
This displays the UCS Networking (NX-OS) MIBs for Cisco UCS Manager for software Release 1.0 and
later, and the Cisco UCS Manager MIBs supported by software Release 1.4 and later.
Step 3 Select and save each MIB that you want to download from the list.
Procedure
Note This procedure assumes that your passive FTP utility has UNIX-like commands.
Procedure
Prerequisite MIBs
The MIBs in this section are required for all use cases and need to be loaded before other Cisco MIBs are
loaded.
Important You should load the MIBs in the order listed to eliminate most of the load-order issues.
The following is a list of MIBs from which many other MIBs import definitions:
• SNMPv2-SMI.my
• SNMPv2-TC.my
• SNMP-FRAMEWORK-MIB.my
• RFC1213-MIB.my
• IF-MIB.my
• CISCO-SMI.my
• CISCO-ST-TC.my
• ENTITY-MIB.my
• INET-ADDRESS-MIB
• CISCO.TC.my
Important You should load the MIBs in the order listed to eliminate most of the load-order issues.
If you want to receive Cisco UCS traps in your NMS, first load the prerequisite MIBs (see Prerequisite MIBs,
on page 11), then load the following Cisco MIBs:
• CISCO-UNIFIED-COMPUTING-MIB.my
• CISCO-UNIFIED-COMPUTING-TC-MIB.my
• CISCO-UNIFIED-COMPUTING-FAULT-MIB.my
• CISCO-UNIFIED-COMPUTING-NOTIFS-MIB.my
If you want to retrieve Cisco UCS Manager managed objects using read-only SNMP GET operations, you
need to load all additional Cisco UCS Manager MIBs. The additional Cisco UCS Manager MIBs are generally
used to retrieve inventory and configuration information using SNMP GET operations. To learn more about
all of the Cisco UCS Manager MIBs, see Purpose of the Cisco UCS MIBs, on page 15.
Note In environments running multiple versions of Cisco UCS Manager, load the latest Cisco UCS Manager
MIBs in the NMS, because all Cisco UCS Manager MIBs are developed to be backward-compatible with
previous versions of Cisco UCS Manager that support SNMP.
MIB Purpose
CISCO-UNIFIED-COMPUTING-AAA-MIB This package contains data about configuring and monitoring
the AAA operation within Cisco UCS.
It includes the following information:
• Identities of external AAA servers such as LDAP,
TACACS, and RADIUS. These servers are used as
authoritative repositories to authenticate UCS users.
• Local Cisco UCS users
• User Roles and locales
• Mappings between users, roles and locales
• Pre-login banner configuration
• Audit Logs
• AAA policies, such as password policies
MIB Purpose
CISCO-UNIFIED-COMPUTING-ADAPTOR-MIB This package contains configuration and statistics information
that reflect the state of physical network adapters within Cisco
UCS.
It includes the following information:
• Ethernet and Ethernet port channel Interfaces
• FC and FC port channel Interfaces
• Network statistics per adapter
CISCO-UNIFIED-COMPUTING-CALLHOME-MIB This package contains configuration objects for the Call Home
feature.
It includes the following information:
• Contact information
• Customer ID and contract ID
• E-mail address
• SMTP servers
• Call Home profiles and policies
• System Inventory
MIB Purpose
CISCO-UNIFIED-COMPUTING-CAPABILITY-MIB This package contains configuration objects for the capability
catalog. This catalog contains the characteristics of various
physical components in Cisco UCS, including fabric
interconnect, network adapters, blade servers, rack-mount
servers, chassis, IO Modules, CPUs, memory units, FAN
modules, local disks, power supply units, and storage
controllers.
Cisco UCS is designed to support new hardware by uploading
a new capability catalog that includes the following
information:
• Capability catalog objects
• Objects to manage the capability catalog, such as
uploading a new catalog to an existing system
MIB Purpose
CISCO-UNIFIED-COMPUTING-CONFORM-MIB This package contains SNMP MIB compliance groups. These
compliance statements provide a systematic method to
describe a group of managed objects that must be
implemented for conformance to a standard.
CISCO-UNIFIED-COMPUTING-DPSEC-MIB This package contains objects that specify the MAC security
policy.
It includes details about the MAC security policy, which is a
part of the network control policy. This policy specifies
whether to allow or deny packets with forged MAC addresses.
MIB Purpose
CISCO-UNIFIED-COMPUTING-EQUIPMENT-MIB This package contains details about the Cisco UCS inventory.
Objects in this package are defined to model the physical
components.
It includes the following information:
• Network adapters
• Beacon LEDs
• Board controllers
• Fabric Interconnect fixed and extension modules
• Cisco UCS chassis
• FAN
• FEX
• Hard drive
• IO card
• Memory unit
• Power supply unit
CISCO-UNIFIED-COMPUTING-EVENT-MIB This package contains details about the event log. An event
is any significant occurrence in the Cisco UCS that may
require users to be notified. Events can help users identify
and diagnose the source of problems.
It includes the following information:
• Object to model the event log
• Object to model an entry in the event log
• Event log policy, which specifies the number of events
that need to be maintained in the event log and the event
retention policy.
MIB Purpose
CISCO-UNIFIED-COMPUTING-EXTMGMT-MIB This package contains details about management interfaces.
It includes the following information:
• Management interfaces
• Gateway ping policy
• Interface monitoring policy
• ARP targets
CISCO-UNIFIED-COMPUTING-EXTPOL-MIB This package contains details about external clients that are
connected to Cisco UCS Manager
MIB Purpose
CISCO-UNIFIED-COMPUTING-FAULT-MIB This package provides information about Cisco UCS faults.
A fault is an abnormal condition or defect at the component,
equipment, or subsystem level, which may lead to a failure
as defined in ISO/CD 10303-226.
Each managed object in the management tree may have one
or more faults that indicate a particular problem with this
object.
It includes the following information:
• Fault objects
• Fault policy, including fault retention, flapping, and
clear action
CISCO-UNIFIED-COMPUTING-FC-MIB This package contains data about the Fibre Channel statistics
and FC interface configuration.
It includes the following information:
• Fibre Channel statistics
• Fibre Channel interface configuration
MIB Purpose
CISCO-UNIFIED-COMPUTING-FLOWCTRL-MIB This package contains the network flow control policy details.
CISCO-UNIFIED-COMPUTING-IMGSEC-MIB This package contains details about the image security keys.
MIB Purpose
CISCO-UNIFIED-COMPUTING-LLDP-MIB This package contains details about the Link Layer Discovery
Protocol object.
It includes information on the objects that provide inventory
information about peer links through LLDP.
CISCO-UNIFIED-COMPUTING-LS-MIB This package contains the top-level objects for Cisco UCS
service profiles.
It includes the following information:
• Cisco UCS service profile
• Binding between a service profile and a blade or rack
mount server
• Requirements that a physical server must satisfy in order
to be associated with a service profile
CISCO-UNIFIED-COMPUTING-LSBOOT-MIB This package contains information about the boot objects for
Cisco UCS service profiles.
It contains the following information:
• Service profile boot policy
• SAN and LAN boot images
• Virtual Media
• iSCSI boot policy
MIB Purpose
CISCO-UNIFIED-COMPUTING-MAPPINGS-MIB This package contains information about the relationships
between the Cisco UCS Manager Managed Objects.
It includes the following information:
• The cucsMappingsMoContainmentTable provides
containment information to navigate from a parent
managed object to the child managed objects.
• The cucsMappingsMoInverseContainmentTable
provides information to navigate from a child managed
object to the parent managed object.
• The cucsMappingsDnToOidTable provides a mapping
from the Managed Object Distinguised Name to the
SNMP OID.
CISCO-UNIFIED-COMPUTING-MEMORY-MIB This package contains details about memory units that are
installed in blade and rack-mount servers.
It includes the following information:
• Memory arrays
• Memory units
• Memory qualification
• Statistics
MIB Purpose
CISCO-UNIFIED-COMPUTING-NOTIFS-MIB This MIB contains the definitions of the SNMP notifications
that are supported byCisco UCS Manager.
The following notifications are defined:
• UCS Manager Fault raised
• UCS Manager Fault cleared
MIB Purpose
CISCO-UNIFIED-COMPUTING-POWER-MIB This package contains details about chassis power capping
policies and statistics.
It includes the following information:
• Chassis power capping
• Chassis power statistics
CISCO-UNIFIED-COMPUTING-SOL-MIB This package provides information about the Serial Over LAN
(SOL) policies.
CISCO-UNIFIED-COMPUTING-STORAGE-MIB This package contains details about storage elements that can
be installed or accessed from a Cisco UCS server.
It includes following information:
• Local disks
• Storage controllers
• Storage enclosures
• LUNs
• RAID batteries
MIB Purpose
CISCO-UNIFIED-COMPUTING-SW-MIB This package contains details about how the system should
be configured. Objects in this package are created implicitly
by the system based on user-specified data from the "fabric"
package. For example, the "fabric" package may specify
high-level fabric policies, and the "sw" package may specify
individual VLAN membership for each physical port.
It includes the following information:
• VLANs
• VSANs
• VLAN membership
• Ethernet and Fibre Channel ports
CISCO-UNIFIED-COMPUTING-TC-MIB This MIB contains all the SNMP textual conventions that are
used in other Cisco UCS Manager MIBs.
CISCO-UNIFIED-COMPUTING-TOP-MIB This package contains the definition of the root object in the
Cisco UCS management information tree.
It includes the definition of the Cisco UCS root objects in the
Manager Information Tree.
MIB Purpose
CISCO-UNIFIED-COMPUTING-UUIDPOOL-MIB This package contains details about the pools of UUID
identifiers. Pools of UUID identifiers are used to assign virtual
UUIDs to service profiles.
It includes the following information:
• Pools of UUID identifiers
• Block of UUID identifiers
• UUID identifiers, which can be assigned to service
profiles