Trademarks used in this text: Dell™, the Dell logo, Dell Boomi™, Dell Precision™ , OptiPlex™, Latitude™, PowerEdge™, PowerVault™,
PowerConnect™, OpenManage™, EqualLogic™, Compellent™, KACE™, FlexAddress™, Force10™ and Vostro™ are trademarks of Dell
Inc. Intel®, Pentium®, Xeon®, Core® and Celeron® are registered trademarks of Intel Corporation in the U.S. and other countries. AMD
is a registered trademark and AMD Opteron™, AMD Phenom™ and AMD Sempron™ are trademarks of Advanced Micro Devices, Inc.
Microsoft®, Windows®, Windows Server®, Internet Explorer®, MS-DOS®, Windows Vista® and Active Directory® are either trademarks
or registered trademarks of Microsoft Corporation in the United States and/or other countries. Red Hat® and Red Hat
Enterprise Linux® are registered trademarks of Red Hat, Inc. in the United States and/or other countries. Novell® and SUSE® are
registered trademarks of Novell Inc. in the United States and other countries. Oracle® is a registered trademark of Oracle Corporation
and/or its affiliates. Citrix®, Xen®, XenServer® and XenMotion® are either registered trademarks or trademarks of Citrix Systems, Inc. in
the United States and/or other countries. VMware
trademarks of VMware, Inc. in the United States or other countries.
Corporation.
2012 - 12
®
,
Virtual SMP
®
®
,
vMotion
®
is a registered trademark of International Business Machines
IBM
,
vCenter
®
and
vSphere
®
are registered trademarks or
®
®
Rev. A00
Contents
Notes, Cautions, and Warnings...................................................................................................2
Server Administrator................................................................................................................................................7
Whats New in This Release......................................................................................................................................7
Documenting CIM Classes and Their Properties.....................................................................................................7
Base Classes......................................................................................................................................................8
Common Properties of Classes.................................................................................................................................9
Other Documents You May Need...........................................................................................................................11
This reference guide documents the Dell OpenManage Server Administrator Common Information Model (CIM) provider
contained in the Management Object File (MOF) dccim32.mof.
CIM provides a conceptual model for describing manageable objects in a systems management environment. CIM is a
modeling tool rather than a programming language. CIM provides the structure for organizing objects into a model of a
managed environment. For modeling a managed environment, CIM makes available a set of abstract and concrete
classes of objects. These classes model the basic characteristics of systems, networks, and applications, as well as
groupings of management-related data.
For more information about CIM, see the Distributed Management Task Force (DMTF) website at dmtf.org and the
Microsoft website at microsoft.com.
Server Administrator
Server Administrator provides a suite of systems management information for keeping track of your networked systems.
In addition to providing systems management agents that are independent of the management console, Server
Administrator supports these systems management standards: CIM and Simple Network Management Protocol (SNMP).
In addition to supporting systems management industry standards, Server Administrator provides additional systems
management information about the specific components of your Dell system.
Whats New in This Release
New enumeration value (NIC Capabilities) to the Dell_NetworkPort class is introduced in this 7.0 release.
For a list of platforms, Operating Systems, and Browsers support added and deprecated, refer to the
Server Administrator Version 7.2 User's Guide and Dell Systems Software Support Matrix Version 7.2
support/manuals.
Dell OpenManage
at dell.com/
Documenting CIM Classes and Their Properties
The Dell CIM provider extends support to Dell-specific software and hardware components. The Dell MOF defines the
classes for the Dell CIM provider. All of the supported classes and properties in the MOF are documented in this guide.
The following subsections define some of the basic building blocks of CIM classes that are used in describing the
dccim32 provider name. These subsections also explain how the elements used in describing these classes are
organized. This section does not document the entire CIM schema, but only those classes and properties supported by
the dccim32 provider. The list of properties for each supported class varies greatly.
The property values being presented could be NULL or empty string on some systems, although in general, some nonempty values can be expected. Key properties (listed below) always carry non-empty values. It is recommended that you
use only the following properties as key attributes:
•CIM_ServiceAccessPoint: SystemCreationClassName, SystemName, CreationClassName, Name
Base Classes
The classes listed in the Server Administrator CIM provider class hierarchy do not have a parent property. These base
classes do not derive from another class. The base classes are:
•CIM_ManagedSystemElement
•CIM_Dependency
•DELL_EsmLog
•DELL_PostLog
•DELL_CMApplication
•DELL_CMDevice
•DELL_CMDeviceApplications
•DELL_CMInventory
•DELL_CMOS
•DELL_CMProductInfo
The CIM_ManagedSystemElement class is the base class for the system element hierarchy from which all other CIM
classes are derived. As a result, CIM_ManagedSystemElement has no parent. Examples of managed system elements
include software components such as files, devices such as hard drives and controllers, and physical subcomponents of
devices such as chip sets and cards. For the CIM_ManagedSystemElement properties, see Caption,
CreationClassName, Description, Name, and Status in Common Properties of Classes
The Dell-defined classes are not defined in the official schema by the DMTF, the industry group that defines the
standards for CIM, and hence do not have parent classes. CIM_Dependency does not have a parent class because it is
a relationship or association between two managed system elements.
Parent Classes
Most classes in the dccim32 provider document both a
class from which any given class inherits its core properties. For example, the CIM_Controller class has the
CIM_LogicalDevice class as its parent, and has various types of controllers (CIM_ParallelController,
CIM_SerialController) as its children.
8
Class Name
and a
Parent Class
property. The parent class is the
Classes That Describe Relationships
Classes that derive from CIM_Dependency have CIM_Dependency as their parent class, but they are documented in
terms of
following relationship between two CIM_ManagedSystemElements:
The CIM_PackageCurrentSensor class monitors an entire physical package, such as all the components contained in a
given system chassis. The CIM_PhysicalPackage class is dependent on the CIM_PackageCurrentSensor class for this
monitoring function.
antecedent
AntecedentCIM_PackageCurrentSensor
DependentCIM_PhysicalPackage
and
dependent
elements in a relationship rather than in terms of common properties. Consider the
Dell-Defined Classes
Server Administrator has extended some CIM classes and has created new classes to assist in managing systems and
their components. In this document, the illustrations of the classes created and populated by Dell are represented by an
orange circle icon.
Common Properties of Classes
Many classes have properties such as
defines properties that have the same meaning in every class that has this property and are defined more than once in
this guide.
Table 1. Common Properties of Classes
PropertyDescriptionData Type
CaptionDescribes the object using a short
CreationClassNameIndicates the name of the class or the
CSCreationClassNameIndicates the computer system’s
CSNameIndicates the computer system’s
CurrentReadingIndicates the actual current value
DescriptionProvides a textual description of the
LowerThresholdNonCriticalIf current reading is between lower
Caption, Description
textual description (one‑line string).
subclass used in the creation of an
instance. When used with the other
key properties of this class, this
property allows all instances of this
class and its subclasses to be
uniquely identified.
creation class name.
name.
indicated by the sensor in amperes.
object.
threshold noncritical and upper
threshold noncritical, the current
state is normal. See Figure 3‑2.
, and
CreationClassName
. Common Properties of Classes
string
string
string
string
sint32
string
sint32
9
PropertyDescriptionData Type
LowerThresholdCriticalIf the current reading is between
upper threshold critical and upper
threshold fatal, the current state is
critical. See Figure 3‑2.
IsLinearIndicates that the sensor is linear over
its dynamic range.
ManufacturerProvides the name of the organization
responsible for producing the
CIM_PhysicalElement or
CIM_SoftwareElement. This may be
the entity from whom the element is
purchased, but not necessarily.
Purchase information is contained in
the vendor property of CIM_Product.
NameDefines the label by which the object
is known. When subclassed, the
Name
property can be overridden to
be a
Key
property.
StatusProvides a string indicating the status
of the component. Status values
include:
Operational Status Values:
•
OK
indicates that the object is
functioning normally.
•
Degraded
is functioning, but not
optimally.
•
Stressed
element is functioning, but
needs attention. Examples of
Stressed
overloaded, overheated, and
so on.
means that the item
indicates that the
states are
sint32
Boolean
string
string
string
Nonoperational Status Values:
•
Non-recover
nonrecoverable error has
occurred.
•
Error
has encountered an
operational condition that is
severe as compared to its
normal mode of operation.
SystemCreationClassNameIndicates the system’s creation class
name.
UnitModifierProvides the unit multiplier for the
values returned by this sensor. All the
values returned by this sensor are
represented in units of 10 raised to the
power of the unit modifier. If the unit
modifier is –6, then the units of the
values returned are microvolts. The
units apply to all numeric properties of
10
means that a
means that an element
string
sint32
PropertyDescriptionData Type
the sensor, unless explicitly
overridden by the units’ qualifier.
UpperThresholdCriticalIf the current reading is between
upper threshold critical and upper
threshold fatal, the current status is
critical. See Figure 3‑2.
UpperThresholdNonCriticalIf the current reading is between
lower threshold noncritical and lower
threshold critical, the current status is
noncritical. See Figure 3‑2.
VersionVersion should be in the form
<major>.<minor>.<revision>
or
<major>.<minor><letter><revision>
for example, 1.2.3 or 1.2a3.
sint32
sint32
string
;
Other Documents You May Need
Besides this
Dell Support website at dell.com/support/manuals:
•
•
•
•
•
•
•The
Dell OpenManage Server Administrator CIM Reference Guide
Dell OpenManage Server Administrator User’s Guide
Server Administrator.
Dell OpenManage Server Administrator Installation Guide
OpenManage Server Administrator.
documents the features, installation, and uninstallation of
contains instructions to help you install Dell
Dell OpenManage Management Station Software Installation Guide
OpenManage management station software that includes Baseboard Management Utility, DRAC Tools, and
Active Directory Snap-In.
Dell OpenManage Server Administrator Command Line Interface User’s Guide
using the text-based command line interface.
Dell OpenManage Server Administrator Messages Reference Guide
your systems management console or on your operating system’s event viewer. This guide explains the text,
severity, and cause of each message that the Server Administrator issues.
Dell OpenManage Server Administrator SNMP Reference Guide
base (MIB). The SNMP MIB defines variables that cover the capabilities of Server Administrator systems
management agents.
Glossary
for information on terms used in this document.
, you can find the following documents on the
contains instructions to help you install Dell
explains how to perform tasks
lists the messages that you can receive on
documents the SNMP management information
Typographical Conventions
The following example shows how most of the classes in the Dell CIM provider are documented. CIM_DMA Properties
shows a partial class description for the DELL_DMA class.
NOTE: For a full class description, see CIM_DMA Properties.
Class Name
Parent Class
Property
denotes the name of the attribute that is being defined for this class.
Description
appears in Courier typeface and provides the string that names the class in the MOF.
appears in Courier typeface and provides the name of the class from which the present class is derived.
includes text that defines the property.
11
Data Type
and various types of integer. Boolean indicates that the property must be expressed as one of two alternatives.
stipulates the format that the values of this property must take. Common data types include Boolean, string,
12
2
CIM_Physical Element
CIM_PhysicalElement is a CIM-defined class. The CIM_PhysicalElement class contains the subclasses shown in Figure
CIM_PhysicalElement Class Structure
CIM_PhysicalElement
Subclasses of the CIM_PhysicalElement class listed in Table below define any component of a system that has a distinct
physical identity. Physical elements are tangible managed system elements (usually actual hardware items) that have a
physical manifestation of some sort. By contrast, processes, files, and logical devices are not classified as physical
elements. A managed system element is not necessarily a discrete component. A single card (which is a type of physical
element) can host more than one logical device.
One card, for example, could implement both a modem and a local area network (LAN) adapter. In this case, the card
would be represented by a single physical element associated with multiple logical devices.
Table 2. CIM_PhysicalElement Properties
Class Name: CIM_PhysicalElement
Parent Class: CIM_ManagedSystemElement
PropertyDescription Data Type
CreationClassNameSee Common Properties of
Classes
ManufacturerSee Common Properties of
Classes
ModelThe name by which the
physical element is
generally known.
string
13
SerialNumberA manufacturer-allocated
number used to identify the
physical element.
TagUniquely identifies the
physical element and
serves as the element’s key.
The Tag property can
contain information such as
asset tag or serial number
data. The key for a physical
element is placed very high
in the object hierarchy in
order to identify the
hardware/entity
independently, regardless
of the physical placement in
or on cabinets, adapters,
and so on. For example, a
hotswappable or removable
component can be taken
from its containing
(scoping) package and be
temporarily unused. The
object still continues to
exist and may even be
inserted into a different
scoping container.
Therefore, the key for the
physical element is an
arbitrary string that is
defined independently of
any placement or locationoriented hierarchy.
string
string
CIM_PhysicalPackage
The CIM_PhysicalPackage class listed in Table below represents physical elements that contain or host other
components. Examples are a rack enclosure or an adapter card with multiple functions.
Table 3. CIM_PhysicalPackage Properties
Class Name:
Parent Class:
PropertyDescriptionData Type
RemovableA CIM_PhysicalPackage is removable
14
CIM_PhysicalPackage
CIM_PhysicalElement
Boolean
if it is designed to be taken in and out of
the physical container in which it is
normally found without impairing the
function of the overall package.
ReplaceableA CIM_PhysicalPackage is replaceable
if it is possible to substitute a physically
different element for the original
element, as in a field replaceable unit
(FRU). For example, some computer
systems allow the microprocessor to
be upgraded to one of a higher clock
rating. In this case, the microprocessor
is said to be replaceable.
Boolean
CIM_PhysicalFrame
The CIM_PhysicalFrame class described in Table properties contains other frame enclosures such as racks and
chassis. Properties like VisibleAlarm or AudibleAlarm, and data related to security breaches are also members of this
class.
Table 4. CIM_Physical Frame Properties
Class Name:
Parent Class:
PropertyDescriptionData Type
LockPresentIndicates whether the frame is
AudibleAlarmIndicates whether the frame is
VisibleAlarmIndicates that the equipment includes a
SecurityBreachAn enumerated, integer-valued
IsLockedIndicates that the frame is currently
CIM_PhysicalFrame
CIM_PhysicalPackage
Boolean
protected with a lock.
Boolean
equipped with an audible alarm.
Boolean
visible alarm.
uint16
property indicating that a physical
breach of the frame is in progress.
Values for the SecurityBreach property
are:
1 - Other 2 - Unknown 3 - No breach 4 Breach attempted 5 - Breach
successful
Boolean
locked.
15
CIM_Chassis
The CIM_Chassis class described in Table below represents the physical elements that enclose physical elements such
as power supplies, fans, and processors.
Table 5. CIM_Chassis Parent Properties
Class Name: CIM_Chassis
Parent Class:CIM_PhysicalFrame
PropertyDescription Data Type
ChassisTypesValues for the ChassisTypes
property are:
1. Other
2. Unknown
3. Mini-tower
4. Tower
5. Space-saving
6. Main system chassis
7. Expansion chassis
8. Subchassis
9. Space-saving
10. Main system chassis
11. Expansion chassis
12. Subchassis
13. Bus expansion chassis
14. Peripheral chassis
15. Storage chassis
16. Rack-mount chassis
uint16
DELL_Chassis
16
The DELL_Chassis class explained in Table below defines the identifying and status properties of the chassis.
DELL_Chassis inherits from CIM-defined classes, but is populated by Dell properties.
Table 6. DELL_Chassis Properties
Class Name:
Parent Class:
DELL_Chassis
CIM_Chassis
PropertyDescriptionData Type
AssetTagIndicates the container AssetTag
string
string. This asset tag string is assigned
by the system administrator.
SystemClassRefers to the system type that is
uint16
installed and running the
instrumentation. Values for the
SystemClass property are:
1 - Other 2 - Unknown 3 - Workstation 4
- Server 5 - Desktop 6 - Portable
7 - Net PC
SystemIDIndicates the system identifier code.uint16
LogFormatDefines whether the event log data is
uint16
unicode formatted or binary (raw).
Values for the event LogFormat
property are:
1 - Formatted (event log only) 2 Unformatted
3 - Events_and_POST_Formatted (both
the event log and the power‑on selftest (POST) log are unicode formatted)
FanStatusIndicates the global status of fan
string
sensors.
TempStatusIndicates the global status of
string
temperature sensors.
VoltStatusIndicates the global status of voltage
string
sensors.
AmpStatusIndicates the global status of current
string
sensors.
PsStatusIndicates the global status of power
string
supplies.
MemStatusIndicates the global status of memory
string
devices.
ProcStatusIndicates the global status of processor
string
devices.
FanRedStatusIndicates the global status of the
string
cooling unit.
PsRedStatusIndicates the global status of the power
ChassisSystemPropertiesIndicates chassis characteristics, such
ChassisSystemRevisionIndicates the chassis revision.uint16
EsmLogStatusIndicates the global status of ESM log.string
MemoryRedStatusIndicates the global status of memory
ChassisExpressServiceCodeIndicates the chassis express service
CIM_Chassis
uint16
as energy smart and so on.
string
redundancy.
string
code.
CIM_PhysicalComponent
The CIM_PhysicalComponent class listed in Table below represents any low-level or basic component within a
package. A component object either cannot or does not need to be broken down into its constituent parts. For example,
an application specific integrated circuit (ASIC) cannot be broken down into smaller discrete parts.
Table 7. CIM_PhysicalComponent Properties
Class Name:
Parent Class:
CIM_PhysicalComponent
CIM_PhysicalElement
CIM_Chip
The CIM_Chip class listed in Chip Properties represents any type of integrated circuit hardware, including ASICs,
processors, memory chips, and so on.
Table 8. CIM_Chip Properties
Class Name: CIM_Chip
Parent Class: CIM_PhysicalComponent
The CIM_PhysicalMemory class listed in PhysicalMemoryProperties is a subclass of CIM_Chip, representing low-level
memory devices, such as SIMMs, DIMMs, and so on.
Table 9. CIM_PhysicalMemory Properties
Class Name: CIM_PhysicalMemory
Parent Class: CIM_Chip
Property DescriptionData Type
FormFactorSee Chip Propertiesuint16
MemoryTypeIndicates the type of
physical memory. Values for
the MemoryType property
are:
Indicates the total width, in
bits, of the physical
memory, including check or
error correction bits. If
there are no error
correction bits, the value in
this property should match
that specified for the
DataWidth property.
bits, of the physical
memory. A data width of 0
and a total width of 8 would
indicate that the memory is
solely used to provide error
correction bits.
speed of the physical
memory, in string format
(with units).
CapacityIndicates the total capacity
of this physical memory, in
bytes.
BankLabelA string identifying the
physically labeled bank
where the memory is
located, for example, "Bank
0" or "Bank A."
PositionInRowSpecifies the position of the
physical memory in a “row.”
For example, if it takes two
8-bit memory devices to
form a 16-bit row, then a
value of 2 means that this
memory is the second
device. 0 is an invalid value
for this property.
InterleavePositionIndicates the position of this
physical memory in an
interleave. 0 indicates
noninterleaved. 1 indicates
the first position, 2 the
second position, and so on.
For example, in a 2:1
interleave, a value of 1
indicates that the memory is
in the “even” position.
string
uint64
string
uint32
uint32
CIM_PhysicalConnector
The CIM_PhysicalConnector class listed in Physical Connector Properties includes physical elements such as plugs,
jacks, or buses that connect physical elements. Any object that can be used to connect and transmit signals or power
between two or more physical elements is a member of this class. For example, slots and D-shell connectors are types
of physical connectors. See Connector Type Values for a list of valid connector type values.
Table 10. CIM_PhysicalConnector Properties
Class Name: CIM_PhysicalConnector
Parent Class: CIM_PhysicalElement
Property DescriptionData Type
21
ConnectorPinoutA free-form string
string
describing the pin
configuration and signal
usage of a physical
connector.
ConnectorTypeAn array of integers
uint16
defining the type of physical
connector. An array is
specified to allow the
description of
“combinations” of
connector information. For
example, one array entry
could specify RS-232,
another DB-25, and a third
entry could define the
connector as male. See
Connector Type Values for
the values of the
ConnectorType property.
Table 11. Connector Type Values
0 - Unknown30 - unused60 - Micro-DIN90 - On board IDE Connector
The CIM_Slot class listed in Table below represents connectors into which packages are inserted. For example, a
physical package that is a hard drive can be inserted into a small computer system interface-single connector
attachment (SCSI-SCA) slot. As another example, a card can be inserted into a 16-, 32-, or 64-bit expansion slot on a host
board
.
Table 12. CIM_Slot Properties
Class Name:class CIM_Slot
Parent Class: CIM_PhysicalConnector
PropertyDescription Data Type
ConnectorTypeSee Connector Type Values uint16
SupportsHotPlugIndicates whether the slot
supports hot-plug adapter
cards.
MaxDataWidthIndicates the maximum bus
width in bits of adapter
cards that can be inserted
Boolean
uint16
23
SystemSlotType
into this slot. Values for the
MaxDataWidth property are
as follows: