Reproduction in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden.
Trademarks used in this text: Dell, the DELL logo, PowerEdge, PowerVault, and OpenManage are
trademarks of Dell Inc.; Microsoft, Windows, and WindowsNT are registered trademarks of
Microsoft Corporation; Intel,Itanium, Pentium, and Celeron are registered trademarks, and MMX, Xeon, Core and Intel386 are trademarks of Intel Corporation; UNIX is a registered trademark of
The Open Group in the United States and in other countries; VESA is a registered trademark of the
Video Electronics Standards Association; AMD, AMD Athlon, AMD Opteron, AMD Sempron, AMD Turion, and AMD Duron are trademarks of Advanced Micro Devices, Inc.
Other trademarks and trade names may be used in this document to refer to either the entities claiming
the marks and names or their products. Dell Inc. disclaims any proprietary interest in trademarks and
trade names other than its own.
This introduction is divided into two sections. The first section,
"Introduction to the SNMP Reference Guide," explains the SNMP Reference Guide design. All essential Simple Network Management Protocol (SNMP)
terms are defined in this section. Some of the vocabulary may seem complex
and unfamiliar to system administrators who are using SNMP for the first
time. SNMP experts can skim this section, and beginners can read the section
more carefully.
The second section, "Introduction to the Server Administrator SNMP
Subagent," is a more technical introduction to the management information
base (MIB) that underlies Server Administrator services.
Audience
This guide is intended for system administrators, network administrators, and
anyone who wants to write SNMP MIB applications to monitor systems.
What’s New in this Release
This section lists changes to the Server Administrator MIBs in this release of
Server Administrator.
What's New in the Instrumentation MIB
•Added the values to the
device family:
–deviceFamilyIsAMDTurion64X2Mobile(137)
–deviceFamilyIsQuadCoreAMDOpteron(138)
–deviceFamilyIsThirdGenerationAMDOpteron(139)
•Added the MIB object to the Power Supply table:
–powerSupplyPowerMonitorCapable
DellProcessorDeviceFamily
processor
Introduction15
•Added the values to the
–amperageProbeTypeIsPowerSupplyAmps(23)
–amperageProbeTypeIsPowerSupplyWatts(24)
–amperageProbeTypeIsSystemAmps(25)
–amperageProbeTypeIsSystemWatts(26)
•Added the Power Usage table to the Power Group
•Added the value to the
–iDRAC(17)
•Added the MIB objects to the
–bmcType
–bmcModuleName
•Added the MIB objects to the
–
bSUCtpmSecurityControlCapabilities
–
bSUCtpmSecurityControlSetting
–bSUCtpmSecurityControlStatus
–bSUCtpmSecurityControlName
DellAmperageProbeType
DellFirmwareType
Baseboard Management Controller (BMC) table:
BIOS Setup Control table:
What's New in the Remote Access MIB
No changes.
enumeration:
enumeration:
What's New in the Field Replaceable Unit MIB
No changes.
What's New in the Storage Management Group MIB
•Added the states under the virtual disk states:
–Degraded Redundancy
–Resynching Paused
•Added the values for the virtual disk’s RAID type:
–RAID-6 (8)
–RAID-60 (24)
16Introduction
What's New in the Change Management MIB
No changes.
Introduction to the SNMP Reference Guide
This reference guide provides a formatted version of the Server Administrator
Instrumentation MIB (filename 10892.mib), the Server Administrator
Remote Access MIB (filename dcs3rmt.mib), the Server Administrator Field
Replaceable Unit MIB (filename dcs3fru.mib), the Server Administrator
Storage Management MIB (filename dcstorag.mib), and the Server
Administrator Change Management MIB (filename dellcm.mib) that are
released with the current version of Dell™ OpenManage™ Server Administrator.
Sections in this guide follow MIB groups and provide explanations and
definitions for the terms used to define MIB objects. Content in this reference
guide is organized as documented in the following subsections.
General Content
Table 1-1 describes the sections that provide general information about the
MIBs documented in this guide.
Table 1-1. General Content Sections in This Guide
SectionTopicsMIB
Group
Number
1Introduction to SNMP basics and to the MIBs that support
Server Administrator services
25Traps — describes in-band traps defined in the Server
Administrator Instrumentation MIB and out-of-band traps
sent by the Remote Access Controller (RAC) and
Baseboard Management Controller (BMC).
Appendix AStandard Data Type Definitions — defines standard data
types used in this reference guide.
Appendix BSNMP Sample Output — provides a sample SNMP output. NA
GlossaryDefines acronyms, abbreviations, and technical terms used
in this reference guide.
NA
5000
NA
NA
Introduction17
Server Administrator Instrumentation MIB
The Server Administrator Instrumentation MIB (filename 10892.mib) provides
instrumentation data that allows you to monitor the health of a system with
SNMP management applications. It provides:
•Information about the status of temperatures, power supplies, voltages,
currents, fans, and memory at key points in the system
•Rapid access to detailed fault and performance information gathered by
industry standard systems management agents
•Version information for Basic Input/Output System (BIOS), firmware, and
operating system
•A detailed account of every cost of ownership (COO) detail about your system
In addition, traps are sent to report a change in status of the health of critical
components.
The Server Administrator Instrumentation MIB structures its MIB objects
into groups of scalar objects or MIB tables that provide related information.
Table 1-2 describes each Server Administrator Instrumentation MIB group
and lists the MIB group number assigned to the MIB group.
The Server Administrator Instrumentation MIB groups are identified by the
SNMP OID 1.3.6.1.4.1.674.10892.1.<MIB group number>, where <MIB group number> is the MIB group number assigned to the MIB group. See the
relevant section for more information about the MIB objects defined in a
MIB group.
Table 1-2. Server Administrator Instrumentation MIB Sections
in This Guide
SectionTopicsMIB Group
Numbers
2Instrumentation MIB Version Group — defines version
numbers of the Instrumentation MIB
3Systems Management Software Group — defines
information about the systems management software and
the supported systems management standards
4System State Group — defines status, state, and
redundancy for a system and its components
1
100
200
18Introduction
Table 1-2. Server Administrator Instrumentation MIB Sections
in This Guide (continued)
SectionTopicsMIB Group
Numbers
5Chassis Information Group — defines chassis types,
events, and indicators
6Operating System Group — defines variables for name,
version, service pack, and other information about a
system’s operating system
7System Resource Group — defines variables for
input/output ports, memory, interrupts, and direct
memory access
8Power Group — defines variables for power units, power
supplies, and their current and voltage probes
9Thermal Group — defines variables for temperature
probes and cooling devices
10User Security Group — defines variables for creating and
modifying user accounts
11Remote Flash BIOS Group — defines variables for
updating the system’s BIOS remotely
12Port Group — defines variables for major port types such as
keyboard, monitor, small computer system interface
(SCSI), Universal Serial Bus (USB), and parallel and
serial ports
13Device Group — defines variables for pointing,
keyboard,processor, cache, memory, and personal
computer interface devices
14Slot Group — defines variables for the system’s slots1200
15Memory Group — defines variables for the system’s
physical memory
16BIOS Setup Control Group — defines variables for BIOS
functions such as boot sequence, speakers, Wake on the
local area network (LAN), diskettes, ports, and
network interface controllers (NIC)
300
400
500
600
700
800
900
1000
1100
1300
1400
Introduction19
Table 1-2. Server Administrator Instrumentation MIB Sections
in This Guide (continued)
SectionTopicsMIB Group
Numbers
17Local Response Agent Group — defines variables for
global settings and actions. These variables allow users to
predetermine how the system responds to a particular
type of event
18Cost of Ownership Group — defines variables for tracking
data on the system’s service contract, lease, repair records,
trouble tickets, and so on
20Cluster Group — defines variables for systems that
operate as a cluster
21Baseboard Management Controller Group — provides
information about the Baseboard Management Controller
(BMC) that may be present in your system. In addition to
providing general information about the BMC, this group
provides information about the serial and local area
network (LAN) interfaces of the BMC
25Traps — defines the types of alerts that can be sent to
report the status of critical components
1500
1600
1800
1900
5000
Server Administrator Remote Access MIB
The Server Administrator Remote Access MIB (filename dcs3rmt.mib)
provides in-band information about remote access hardware that may be
present in your system.
The Server Administrator Remote Access MIB structures its MIB objects into
groups of scalar objects or MIB tables that provide related information.
Table 1-3 describes each Server Administrator Remote Access MIB group and
lists the MIB group number assigned to the MIB group. The Server
Administrator Remote Access MIB groups are identified by the SNMP OID
1.3.6.1.4.1.674.10892.1.<MIB group number> where <MIB group number> is
the MIB group number assigned to the MIB group. See the relevant section
for more information about the MIB objects defined in a MIB group.
20Introduction
Table 1-3. Server Administrator Remote Access MIB Sections in This Guide
Section TopicMIB
Group
Numbers
19Remote Access Group — provides information about remote
access hardware that may be present in your system and
defines variables for administrative users, SNMP trap
destinations, modem configuration for dial-up networking,
dial-in configuration, and dial-out destinations
1700
Server Administrator Baseboard Management Controller, ASF MIB
The Server Administrator BMC MIB (filename DcAsfSrv.mib) provides
information about the traps sent by BMC. The Server Administrator BMC
MIB structures its MIB objects that provide related information. The BMC
MIB groups are identified by the SNMP OID 1.3.6.1.4.1.3183.1.1.<MIB
group number> The BMC MIB is adheres to ASF 2.0 standard and hence the
enterprise ID is wired for management (3183).
Server Administrator Field Replaceable Unit MIB
The Server Administrator Field Replaceable Unit MIB (filename
dcs3fru.mib) provides information about field replaceable unit (FRU)
hardware that may be present in your system.
The Server Administrator Field Replaceable Unit MIB structures its MIB
objects into groups of scalar objects or MIB tables that provide related
information. Table 1-4 describes each Server Administrator Field Replaceable
Unit MIB group and lists the MIB group number assigned to the MIB group.
The Server Administrator Field Replaceable Unit MIB groups are identified
by the SNMP OID 1.3.6.1.4.1.674.10892.1.<MIB group number> where
<MIB group number> is the MIB group number assigned to the MIB group.
See the relevant section for more information about the MIB objects defined
in a MIB group.
Introduction21
Table 1-4. Server Administrator Field Replaceable Unit MIB Sections in This Guide
Section TopicMIB Group
Numbers
22Field Replaceable Unit Group — provides information
about field replaceable units that may be present in your
system
2000
Server Administrator Storage Management MIB
The Server Administrator Storage Management MIB (filename dcstorag.mib)
provides storage management data that allows you to monitor the health of
storage resources with SNMP management applications.
Table 1-5 describes each Server Administrator Storage Management MIB
group and lists the MIB group number assigned to the MIB group. The Server
Administrator Storage Management MIB groups are identified by the SNMP
OID 1.3.6.1.4.1.674.<MIB group number> where <MIB group number> is
the MIB group number assigned to the MIB group. See the relevant section
for more information about the MIB objects defined in a MIB group.
Table 1-5. Server Administrator Storage Management MIB Sections in This Guide
SectionTopicsMIB Group
Numbers
23Storage Management Group — consists of definitions for the
following MIB groups:
• Storage Management Group
• Storage Management Information Group
• Global Data Group
• Physical Devices Group
• Logical Devices Group
• Storage Management Event Group
26Storage Management Alert Reference — lets you monitor the
health of storage resources such as controllers, connectors,
array disks, and virtual disks
10893
NA
22Introduction
Server Administrator Change Management MIB
The Server Administrator Change Management MIB (filename dellcm.mib)
provides management data that allows you to monitor the inventory of devices
and applications with SNMP management applications.
Table 1-6 describes each Server Administrator Change Management MIB
group and lists the MIB group number assigned to the MIB group. The Server
Administrator Change Management MIB groups are identified by the SNMP
OID 1.3.6.1.4.1.674.<MIB group number> where <MIB group number> is
the MIB group number assigned to the MIB group. See the relevant section
for more information about the MIB objects defined in a MIB group.
Table 1-6. Server Administrator Change Management MIB Sections in This Guide
SectionTopicsMIB Group
Number
24Change Management Group - describes the inventory
data provided by the Change Management MIB that
allows users to monitor devices and software present on a
particular managed computer chassis
10899
How This Guide Defines Technical Terms
The following table provides information about where to find definitions for
technical terms in this reference guide.
Table 1-7. Where to Find Definitions for Technical Terms
Type of DefinitionSee
Basic SNMP vocabulary.Introduction
MIB-group-specific variable values. MIB-groupspecific MIB variables contain links to the tables
that define these values in the last section of the
section in which these variables are used.
Systems management terms, acronyms, and
commonly managed components referred to in
this reference guide.
Server Administrator-standard data types that
specify variable values in this reference guide.
Sections 3, 5, 7, 8, 9, and 11
through 18.
Glossary
Appendix A, "Standard Data
Type Definitions."
Introduction23
SNMP Basic Terminology
It is important to have a good understanding of the key technical terms used
in this guide. This guide provides definitions for all essential terms used in
describing the Server Administrator MIBs. The Glossary contains definitions
for all essential terms and acronyms.
SNMP Master Agent
Typically, the SNMP agent on a managed system consists of one SNMP master
agent and zero or more SNMP extension agents. This SNMP agent extendable
structure facilitates the addition of new MIB modules without having to rebuild
the entire SNMP agent and is invisible to SNMP management applications.
The SNMP master agent is responsible for receiving SNMP request protocol
messages from SNMP management applications and sending SNMP response
protocol messages. As part of processing SNMP request protocol messages,
the SNMP master agent typically communicates with one or more SNMP
extension agents. This communication does not involve standard SNMP
protocol messages. The SNMP master agent uses an extension protocol that
shields the SNMP extension agent from the standard SNMP protocol
messages. The extension protocol also provides a way for SNMP extension
agents to send SNMP event notifications (called traps in SNMPv1). The
SNMP master agent is also responsible for sending SNMP event notification
protocol messages to SNMP management applications.
On supported operating systems, the SNMP master agent is provided with
the operating system. For example, on supported Microsoft
operating systems, the Windows SNMP service is the SNMP master agent.
For information on the versions of the SNMP protocol supported by the
SNMP master agent, see the operating system documentation.
®
Windows®
SNMP Extension Agent
The SNMP extension agent is responsible for registering the MIB objects that
it supports with the SNMP master agent and then processing requests from
the SNMP master agent for those MIB objects. The SNMP extension agent
also initiates event notifications to the SNMP master agent. The SNMP
extension agent does not receive or send standard SNMP protocol messages.
The SNMP extension agent communicates with the SNMP master agent using
an extension protocol defined by the SNMP master agent.
The Server Administrator SNMP subagent is an SNMP extension agent.
24Introduction
Managed Object
A managed object is any item in a computer system that can be singled out
for discovery, monitoring, or user intervention and correction.
NOTE: Not all managed objects described in this guide are supported by all systems.
MIB
A MIB acts as a structured road map for managed objects. As an Application
Programming Interface (API), a MIB allows systems management tools to
retrieve data maintained by an agent. The server administrator MIB is divided
into several major groups of managed objects.
Variable
A variable is a component of a managed object. A temperature probe, for
example, has a variable to describe its capabilities, its health or status, and
certain indexes that you can use to locate specific temperature probes. One
index for the probe would be the probe’s chassis number. Some systems may
have multiple chassis—one chassis for the central processing unit and
another chassis for storage. A chassis within a system can also have more than
one temperature probe. Variables for a temperature probe include its
capabilities, status, chassis index, and index.
One-Based Index
When an index is one-based, counting starts at 1. One-based indexing counts
the first instance as 1, the second index as 2, and so on.
Zero-Based Index
When an index is zero-based, counting starts at 0. Zero-based indexing
counts the first instance as 0, the second index as 1, and so on.
Fields
Managed object variables contain fields. In this reference guide, managed
object variables have the following fields defined:
Introduction25
Name is the exact string by which the variable is known in the MIB. MIB
variables are named according to the following conventions:
•Variable names start with a lowercase letter.
•Spaces are not allowed between words in the variable name.
•Acronyms are in uppercase letters, except when an acronym is the first
word in the variable name.
•With the exception of the first letter of the variable name and acronyms,
all other words in the variable name start with capital letters.
The following variable names illustrate these conventions:
–temperatureProbeLowerCriticalThreshold
–coolingUnitIndex
–pCIDeviceSpeed
Object Identifier (OID) is the unique number assigned to an object defined
in a MIB. An OID is written as a sequence of subidentifiers in decimal
notation. Each OID in this reference guide has a prefix that identifies the
managed objects as belonging to Dell™: 1.3.6.1.4.1.674. The additional
numbers identify the MIB group and subgroup as well as the table entry
number of any variables.
For example, the OID for the temperature probe managed object table is
700.20 and the variable for the location of the temperature probe
(temperatureProbeLocationName) has an OID of 700.20.1.8. The full OIDs
for these items are 1.3.6.1.4.1.674.10892.1.700.20 for the
temperatureProbeTable and 1.3.6.1.4.1.674.10892.1.700.20.1.8 for the
temperatureProbeLocation. For more information about the structure of
OIDs, see "SNMP MIB OIDs."
Description is a brief explanation of what a particular managed object does.
Syntax defines the data type in which the values of the variable must be
expressed. Most variables in this reference guide use standard data types such
as string or boolean. All data types that are unique to server administrator
variables are defined at the end of the section in which they occur. Standard
data types are defined in "Standard Data Type Definitions."
Access specifies whether persons with administrative privileges can read but not
modify the value of a variable (read only) or can both read and modify the value
of a variable (read-write).
26Introduction
Frequently Used Terms in Variable Names
The following terms are frequently used in the name of a MIB variable:
Capability refers to the actions an object can perform, or to actions that can
be taken by the object. Hot-pluggable is an example of a capability. If a card is
hot-pluggable, it can be replaced while a system is running. Capability settings
refer to the capabilities of the object that the user can select from and activate
if desired. Capability settings allow users of the server administrator to
predetermine how an object will behave under specific conditions.
Settings are the conditions of a manageable object that determine what
happens when a certain value is detected in a component. For example, a user
can set the upper critical threshold of a temperature probe to 75 degrees
Celsius. If the probe reaches that temperature, the setting causes an alert to
be sent to the management console. Some settings, when reached, can trigger
a system shutdown or other response to prevent damage to the system.
State refers to the condition of an object that has more than one condition.
For example, an object may be in a "not ready" or in an "enabled" state.
Status refers to the health of an object or how the object is functioning. For
example, the status of a temperature probe that is measuring acceptable
temperatures would be reported as normal. When the probe begins reading
temperatures that exceed limits set by the user, it reports a critical status.
Tabl es
This reference guide contains two types of tables: tables that are used to
organize and define variable values and tables that define MIB objects.
Readers must understand the difference between these two types of tables.
SNMP Tables
Most of the MIB objects defined in this reference guide are organized into
SNMP tables. SNMP tables organize data into two-dimensional structural
arrays. In SNMP, objects that have a relationship to other objects are called
columnar objects. Columnar objects are objects used to form lists and tables.
When a MIB group is divided into one or more discrete tables, the word
"table" has a technical meaning. An example is the section of this reference
guide entitled Universal Unique Identifier (UUID). The UUID object has a
type and a value that uniquely identifies an object such as a chassis. The table
defines all of the variables that comprise the managed object UUID.
Introduction27
The following table is an example of an SNMP table. The table contains
variables that must occur in a definite sequence. In the example table the
defined variables are UUID Chassis Index, UUID Index, UUID Type, and
UUID Value.
Example SNMP Table
UUID Table
These objects comprise the Server Administrator definitions for the UUID.
NameuUIDTable
Object ID1.3.6.1.4.1.674.10892.1.300.20
DescriptionDefines the UUID table.
SyntaxSEQUENCE OF UUIDTableEntry
AccessNot accessible
UUID Table Entry
NameuUIDTableEntry
Object ID1.3.6.1.4.1.674.10892.1.300.20.1
DescriptionDefines the UUID table entry.
SyntaxUUIDTableEntry
AccessNot accessible
IndexuUIDIndex, uUIDchassisIndex
UUID Chassis Index
NameuUIDchassisIndex
Object ID1.3.6.1.4.1.674.10892.1.300.20.1.1
DescriptionDefines the index (one-based) of this chassis.
SyntaxDellObjectRange
AccessRead-only
28Introduction
UUID Index
NameuUIDIndex
Object ID1.3.6.1.4.1.674.10892.1.300.20.1.2
DescriptionDefines the index of the UUID in a specified chassis.
SyntaxDellObjectRange
AccessRead-only
UUID Type
NameuUIDType
Object ID1.3.6.1.4.1.674.10892.1.300.20.1.3
DescriptionDefines the type of the UUID for this chassis.
SyntaxDellUUIDType
AccessRead-only
UUID Value
NameuUIDValue
Object ID1.3.6.1.4.1.674.10892.1.300.20.1.4
DescriptionDefines the value of the UUID for this chassis.
SyntaxOCTET STRING (SIZE[16])
AccessRead-only
Reference Guide Content Tables
NOTE: Variable values are defined for any variable that is Server Administrator-
specific. Industry-standard variable definitions are documented in "Standard Data
Type Definitions."
Some of the tables in this guide have no technical significance in SNMP. These
tables are designed to show information in a readable form. The following table,
for example, defines the Server Administrator-specific variable,
DellFanControlCapabilities. The table provides the name of the variable, its data
type, the values that are valid for the variable, and the meaning of each value.
Introduction29
Table 1-8. Example Variable Type Definition Table
Variable Name:
Data Type: Integer
Possible Data ValuesMeaning of Data Value
unknown(1)
lowSpeedCapable(2)
highSpeedCapable(4)
lowOrHighSpeedCapable(6)
DellFanControlCapabilities
The fan’s capabilities are unknown.
The fan can be set to low speed.
The fan can be set to high speed.
The fan can be set to low or high speed.
This type of table is used throughout the reference guide to list and define
variable values. Tables that explain Server Administrator-specific variable
values are located in the final section of sections that define Server
Administrator-specific variables. In the preceding example, the variable name
is DellFanControlCapabilities. This variable must be expressed as an integer
and has four possible values: unknown, lowSpeedCapable,
highSpeedCapable, and lowOrHighSpeed Capable.
Section Organization
Sections in this reference guide are based on the Server Administrator MIBs, so
the complexity of each section depends on the complexity of each MIB group.
The first section provides a high-level introduction to the MIB group. If the
group is defined by one or more tables, the second section lists these tables. The
third section documents the variables that comprise the group, and if
applicable, the variables that comprise the tables. The fourth section contains
definitions for any Server Administrator-specific variables that are used in the
section. The following example shows the typical content of these four sections.
1
BIOS Setup Control Group
This section explains the purpose of the MIB group and summarizes the
major features of the component groups.
2
BIOS Group Tables
If there is more than one SNMP table for a group, this section lists all of
the tables. For this BIOS group example, there are eight tables listed. In
each section, double-clicking any table on the list takes you to that table.
30Introduction
Loading...
+ 702 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.