Dell™ OpenManage™ Server Administrator CIM Reference Guide w w w. d e l l . c o m | s u p p o r t . d e l l .
Notes and Cautions NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates potential damage to hardware or loss of data if instructions are not followed. ____________________ Information in this document is subject to change without notice. © 2009 Dell Inc. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden.
Contents 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . 9 . . . . . . . . . . . . . . . . . . . 9 Server Administrator Documenting CIM Classes and Their Properties . . . . . . . . . . . . . . . . . . . . . 10 . . . . . . . . . . . . . . . . . . . . 10 . . . . . . . . . . . . . . . . . . . 11 . . . . . . . 11 . . . . . . . . . . . . . . . . 12 . . . . . . . . . . . . . 12 . . . . . . . . . . . . 14 Typographical Conventions . . . . . . . . . . . . . . .
CIM_PhysicalMemory . . . . . . . . . . . . . . . . . . CIM_PhysicalConnector . CIM_Slot 3 . . . . . . . . . . . . . . . . 28 . . . . . . . . . . . . . . . . . . . . . . . . . 31 CIM_LogicalElement . . . . . . . . . . . . . . . . 35 . . . . . . . . . . . . . . . . . . 36 . . . . . . . . . . . . . . . . . . . . . . . 37 . . . . . . . . . . . . . . . . . . 38 . . . . . . . . . . . . . . . . . . . . . . 38 . . . . . . . . . . . . . . . . . . . 39 . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . 56 . . . . . . . . . . . . . . . . . . . 57 . . . . . . . . . . . . . . . . . . . . . . . . . 58 . . . . . . . . . . . . . . . . . . . . 59 . . . . . . . . . . . . . . . . . . 59 . . . . . . . . . . . . . . . . . . . . . 61 . . . . . . . . . . . . . . . . . . . 62 . . . . . . . . . . . . . . . . . . . . . 64 . . . . . . . . . . . . . . . . . 65 . . . . . . . . . . . . . . . . . . 66 . . . . . . . . . . . . . . . . . . . 67 CIM_PCIDevice . . .
. . . . . . . . . . . . . . . . . . 86 . . . . . . . . . . . . . . . . . . . . . . . . . 87 . . . . . . . . . . . . . . . . . 89 . . . . . . . . . . . . . . . . . . . . . . . . 90 . . . . . . . . . . . . . . . . . 91 . . . . . . . . . . . . . . . . 92 . . . . . . . . . . . . . . . 93 . . . . . . . . . . . . . . 94 . . . . . . . . . . 94 . . . . . . . . . . . . . . . .
DELL_BIOSExtensions . . . . . . . . . . . . . . . . . Management Object File For Change Management . . . . . . . . . . . . . . . . . . 106 . . . . . . . . . . . . 111 Classes for Power Management 5 CIM_Dependency DELL_FanSensor . 105 . . . . . . . . . . . . . . . . . 127 . . . . . . . . . . . . . . . . . . . . 128 . . . . . . . . . . . . . . . 128 . . . . . . . . . . . . . . . . 129 . . . . . . . . . . . . . . 130 . . . . . . . . . . . . . . . . 130 . . . . . . . . . . . 131 . . . .
Contents
Introduction 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.
• Added a new property — SystemSlotType to the CIM_Slot class. • Added new values for the UpgradeMethod and Family properties of the CIM_Processor class. • Added a new property — RemoteAccessType to the DELL_RemoteServiceAccessPortGroup class. • Added the new class DELL_ManagedSystemServicesDevice to the base class CIM_LogicalDevice. Documenting CIM Classes and Their Properties The Dell CIM provider extends support to Dell-specific software and hardware components.
• 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.
Dell-Defined Classes Server Administrator has extended some CIM classes and has created new classes to assist in managing systems and their components. In the diagrams that appear in the documentation for each class, those classes created and populated by Dell are designated by the gold (lighter gray) triangle icon. Common Properties of Classes Many classes have properties such as Caption, Description, and CreationClassName.
Table 1-1. Common Properties of Classes (continued) Property Description Data Type IsLinear Indicates that the sensor is linear over its dynamic range. Boolean Manufacturer Provides the name of the organization string 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.
Table 1-1. Common Properties of Classes (continued) Property Description SystemCreationClassName Indicates the system’s creation class name. Data Type string UnitModifier Provides the unit multiplier for the values sint32 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.
• Dell OpenManage Installation and Security User’s Guide provides complete information on installation procedures and step-by-step instructions for installing, upgrading, and uninstalling Server Administrator for each operating system. • Dell OpenManage Server Administrator Command Line Interface User’s Guide explains how to perform tasks using the text-based command line interface.
Table 1-2. CIM_DMA Properties Class Name: CIM_DMA Parent Class: CIM_SystemResource Property Description Data Type DMAChannel A part of the object’s key value, the DMA channel number. uint32 Availability uint16 Availability of the DMA.
CIM_PhysicalElement CIM_PhysicalElement is a CIM-defined class. The CIM_PhysicalElement class contains the subclasses shown in Figure 2-1. Figure 2-1.
Table 2-1. CIM_PhysicalElement Properties Class Name: CIM_PhysicalElement Parent Class: CIM_ManagedSystemElement Property Description Data Type CreationClass See Table 1-1. Name Manufacturer See Table 1-1. Model The name by which the physical element is generally known. string SerialNumber A manufacturer-allocated number used to identify string the physical element. Tag 18 Uniquely identifies the physical element and serves string as the element’s key.
CIM_PhysicalPackage CIM_ManagedSystemElement CIM_PhysicalElement CIM_PhysicalPackage The CIM_PhysicalPackage class listed in Table 2-2 represents physical elements that contain or host other components. Examples are a rack enclosure or an adapter card with multiple functions. Table 2-2.
CIM_PhysicalFrame CIM_ManagedSystemElement CIM_PhysicalElement CIM_PhysicalPackage CIM_PhysicalFrame The CIM_PhysicalFrame class described in Table 2-3 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 2-3.
CIM_Chassis CIM_ManagedSystemElement CIM_PhysicalElement CIM_PhysicalPackage CIM_PhysicalFrame CIM_Chassis The CIM_Chassis class described in Table 2-4 represents the physical elements that enclose physical elements such as power supplies, fans, and processors. Table 2-4.
DELL_Chassis CIM_ManagedSystemElement CIM_PhysicalElement CIM_PhysicalPackage CIM_PhysicalFrame CIM_Chassis DELL_Chassis The DELL_Chassis class explained in Table 2-5 defines the identifying and status properties of the chassis. DELL_Chassis inherits from CIM-defined classes, but is populated by Dell™ properties. Table 2-5. DELL_Chassis Properties Class Name: DELL_Chassis Parent Class: CIM_Chassis Property Description Data Type AssetTag Indicates the container AssetTag string.
Table 2-5. DELL_Chassis Properties (continued) Class Name: DELL_Chassis Parent Class: CIM_Chassis Property Description LogFormat Defines whether the event log data is unicode uint16 formatted or binary (raw). Values for the event LogFormat property are: Data Type 1 - Formatted (event log only) 2 - Unformatted 3 - Events_and_POST_Formatted (both the event log and the power-on self-test (POST) log are unicode for matted) FanStatus Indicates the global status of fan sensors.
CIM_PhysicalComponent CIM_ManagedSystemElement CIM_PhysicalElement CIM_PhysicalComponent The CIM_PhysicalComponent class listed in Table 2-6 represents any lowlevel 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 2-6.
Table 2-7.
CIM_PhysicalMemory CIM_ManagedSystemElement CIM_PhysicalElement CIM_PhysicalComponent CIM_Chip CIM_PhysicalMemory The CIM_PhysicalMemory class described in Table 2-8 is a subclass of CIM_Chip, representing low-level memory devices, such as SIMMS, DIMMs, and so on. Table 2-8. CIM_PhysicalMemory Properties Class Name: CIM_PhysicalMemory Parent Class: CIM_Chip Property Description Data Type FormFactor See Table 2-7. uint16 MemoryType Indicates the type of physical memory.
Table 2-8. CIM_PhysicalMemory Properties (continued) Class Name: CIM_PhysicalMemory Parent Class: CIM_Chip Property Description MemoryType (continued) 11 - Flash Data Type 12 - EEPROM 13 - FEPROM 14 - EPROM 15 - CDRAM 16 - 3DRAM 17 - SDRAM 18 - SGRAM 19 - RDRAM 20 - DDR 21 - DDR2 22 - DDR2 FB-DIMM 24 - DDR3 TotalWidth Indicates the total width, in bits, of the physical memory, including check or error correction bits.
Table 2-8. CIM_PhysicalMemory Properties (continued) Class Name: CIM_PhysicalMemory Parent Class: CIM_Chip Property Description BankLabel A string identifying the physically labeled bank string where the memory is located, for example, "Bank 0" or "Bank A." PositionInRow Specifies 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.
Table 2-9. CIM_PhysicalConnector Properties Class Name: CIM_PhysicalConnector Parent Class: CIM_PhysicalElement Property Description Data Type ConnectorPinout A free-form string describing the pin configuration and signal usage of a physical connector. ConnectorType Table 2-10. string An array of integers defining the type of uint16 physical connector. An array is specified to allow the description of “combinations” of connector information.
Table 2-10.
CIM_Slot CIM_ManagedSystemElement CIM_PhysicalElement CIM_PhysicalConnector CIM_Slot The CIM_Slot class described in Table 2-11 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 2-11.
Table 2-11. CIM_Slot Properties (continued) SystemSlotType Indicates the type of system slot.
Table 2-11. Contd.
CIM_PhysicalElement
CIM_LogicalElement CIM_LogicalElement is a CIM-defined class containing the subclasses shown in Figure 3-1. Figure 3-1.
CIM_SoftwareFeature DELL_SoftwareFeature CIM_SystemResource CIM_IRQ CIM_MemoryMappedIO CIM_DMA CIM_RedundancyGroup CIM_ExtraCapacityGroup DELL_PSRedundancyGroup DELL_FanRedundancyGroup CIM_EnabledLogicalElement CIM_ServiceAccessPoint CIM_RemoteServiceAccessPoint DELL_RemoteServiceAccessPort CIM_LogicalElement CIM_ManagedSystemElement CIM_LogicalElement Table 3-1 lists the following characteristics for members of the CIM_LogicalElement class: • Represent abstractions used to manage and coordinate aspects
CIM_System CIM_ManagedSystemElement CIM_LogicalElement CIM_System The CIM_System class shown in Table 3-2 defines a collection of managed system elements that operates as a functional whole. An instance of the CIM_System class contains a well-defined list of components that work together to perform a specific function. Table 3-2. CIM_System Properties Class Name: CIM_System Parent Class: CIM_LogicalElement Property Description Data Type CreationClassName See Table 1-1.
CIM_ComputerSystem CIM_ManagedSystemElement CIM_LogicalElement CIM_System CIM_ComputerSystem The CIM_ComputerSystem class listed in Table 3-3 contains some or all of the following CIM_ManagedSystemElements: file system, operating system, processor, and memory (volatile and/or nonvolatile storage). For properties, see Table 3-2. Table 3-3.
CIM_LogicalDevice CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice The CIM_LogicalDevice class described in Table 3-5 models a hardware entity that may be realized in physical hardware. CIM_LogicalDevice includes any characteristics of a logical device that manages its operation or configuration. An example of a logical device is a temperature sensor’s reading of actual temperature. Table 3-5.
CIM_FRU CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_FRU The CIM_FRU class described in Table 3-6 contains manufacturing information related to the Field Replaceable Units (FRU) of a system such as a system planar or I/O riser card. Table 3-6. CIM_FRU Properties Class Name: CIM_FRU Parent Class: CIM_LogicalDevice Property Description Data Type FRUInformationState Indicates the state and availability of FRU information.
CIM_LogicalPort CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_LogicalPort The CIM_LogicalPort class listed in Table 3-7 represents the abstraction of a port or connection point of a device. For example, a USB port can be abstracted to represent a port. This feature is used when the abstracted port has independent management characteristics from the device that includes it. Table 3-7.
CIM_NetworkPort CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_LogicalPort CIM_NetworkPort The CIM_NetworkPort class listed in Table 3-8 describes the logical representation of a network. Table 3-8. CIM_NetworkPort Properties Class Name: CIM_NetworkPort Parent Class: CIM_LogicalPort Property Description Data Type Speed Indicates the bandwidth of the port in bits per second. uint64 PortType Identifies port type and whether it is DMTF reserved or vendor reserved.
Table 3-8. CIM_NetworkPort Properties (continued) Class Name: CIM_NetworkPort Parent Class: CIM_LogicalPort Property Description Data Type OtherLinkTechnology When used in conjunction with Link Technology, this property displays relevant links to the device. string PermanentAddress Defines the network address hardcoded into a port. string NetworkAddresses Indicates the network addresses for a port. string FullDuplex Indicates whether the port is operating in a full duplex mode.
Table 3-9. DELL_ManagedSystemServicesDevice properties Class Name: DELL_ManagedSystemServicesDevice Parent Class: CIM_LogicalDevice Property Description Data Type deviceType Defines the type of storage device. The values for this property can be: uint8 0 - Base managed device 1 - Optional managed device storagePresent Defines the storage device present on the card. boolean deviceSize Indicates the size of storage uint32 device in MB.
Table 3-10. DELL_NetworkPort Properties Class Name: Dell_NetworkPort Parent Class: CIM_NetworkPort Property Description Data Type NicTOECapability Defines NIC TCP Offload Engine (TOE) capability. The following values, with explanations, are possible for this property: uint32 0 - NIC/driver does not support querying for capability. 1 - NIC/driver supports querying for capability but query returned an error. 2 - NIC/driver supports querying for capability and query says it is capable.
Table 3-10. DELL_NetworkPort Properties (continued) Class Name: Dell_NetworkPort Parent Class: CIM_NetworkPort Property Description NiciSCSICapability Defines NIC Internet Small Computer System uint32 Interface (iSCSI) Capability. The following values, with explanations, are possible for this property: Data Type 0 - NIC/driver does not support querying for capability. 1 - NIC/driver supports querying for capability but query returned an error.
Table 3-10. DELL_NetworkPort Properties (continued) Class Name: Dell_NetworkPort Parent Class: CIM_NetworkPort Property Description Data Type BusNumber Indicates the PCI bus number. uint8 FunctionNumber Indicates the PCI Function number. uint8 Driver version Indicates the NIC driver version. string IPAddress Indicates the NIC IP Address. string SubnetMask Indicates the NIC subnet mask. string DHCPServer Indicates the NIC DHCP Server.
Table 3-11. CIM_Sensor Properties Class Name: CIM_Sensor Parent Class: CIM_LogicalDevice Property Description Data Type SensorType The type of the sensor, for example, voltage or temperature sensor. uint16 Values for the SensorType property are: 0 - Unknown 1 - Other 2 - Temperature sensors measure the environmental temperature. 3 - Voltage sensors measure electrical voltage. 4 - Current sensors measure current readings. 5 - Tachometers measure speed/revolutions of a device.
CIM_DiscreteSensor CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Sensor CIM_DiscreteSensor The CIM_DiscreteSensor class described in Table 3-12 has a set of legal string values that it can report. The CIM_DiscreteSensor will always have a "current reading" that corresponds to one of the enumerated values. Table 3-12. CIM_DiscreteSensor Properties Class Name: CIM_DiscreteSensor Parent Class: CIM_Sensor Property Description Data Type CurrentReading See Table 1-1.
Figure 3-2. Ranges for Threshold Values FATAL CRITICAL UPPER WARNING UPPER User Definable NONCRITICAL NORMAL LOWER User Definable NONCRITICAL WARNING LOWER CRITICAL FATAL Table 3-13 provides definitions for NumericSensor properties. Table 3-13. CIM_NumericSensor Properties Class Name: CIM_NumericSensor Parent Class: CIM_Sensor Property Description Data Type UnitModifier See Table 1-1. sint32 CurrentReading See Table 1-1. sint32 IsLinear See Table 1-1.
Table 3-13. CIM_NumericSensor Properties (continued) Class Name: CIM_NumericSensor Parent Class: CIM_Sensor Property Description Data Type UpperThresholdNonCritical See Table 1-1. sint32 LowerThresholdCritical See Table 1-1. sint32 UpperThresholdCritical See Table 1-1. sint32 SupportedThresholds An array representing the thresholds supported by this sensor.
CIM_TemperatureSensor CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Sensor CIM_NumericSensor CIM_TemperatureSensor The CIM_TemperatureSensor class listed in Table 3-14 contains sensors that sample ambient temperature and return a value in degrees Celsius. Table 3-14. CIM_TemperatureSensor Properties Class Name: CIM_TemperatureSensor Parent Class: CIM_NumericSensor Property Description Data Type UnitModifier See Table 1-1. sint32 CurrentReading See Table 1-1.
CIM_CurrentSensor CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Sensor CIM_NumericSensor CIM_CurrentSensor The CIM_CurrentSensor class listed in Table 3-15 contains sensors that measure amperage and returns a value in amperes and watts. Table 3-15. CIM_CurrentSensor Properties Class Name: CIM_CurrentSensor Parent Class: CIM_NumericSensor Property Description Data Type UnitModifier See Table 1-1. sint32 CurrentReading See Table 1-1. sint32 IsLinear See Table 1-1.
CIM_VoltageSensor CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Sensor CIM_NumericSensor CIM_VoltageSensor The CIM_VoltageSensor class shown in Table 3-16 contains sensors that measure voltage and return a value in volts. Table 3-16. CIM_VoltageSensor Properties Class Name: CIM_VoltageSensor Parent Class: CIM_NumericSensor Property Description Data Type UnitModifier See Table 1-1. sint32 CurrentReading See Table 1-1. sint32 IsLinear See Table 1-1.
CIM_Tachometer CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Sensor CIM_NumericSensor CIM_Tachometer The CIM_Tachometer class listed in Table 3-17 contains devices that measure revolutions per minute (RPM) of a fan and return the value in RPMs. Table 3-17. CIM_Tachometer Properties Class Name: CIM_Tachometer Parent Class: CIM_NumericSensor Property Description Data Type SensorType See Table 1-1. uint16 UnitModifier See Table 1-1. sint32 CurrentReading See Table 1-1.
CIM_WatchDog CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Watchdog The CIM_WatchDog class described in Table 3-18 represents a timer that is implemented in system hardware. The watchdog feature allows the hardware to monitor the state of the operating system, BIOS, or a software component installed on the system. If the monitored component fails to rearm the timer before its expiration, the hardware assumes that the system is in a critical state and could reset the system.
Table 3-18. CIM_WatchDog Properties (continued) Class Name: CIM_WatchDog Parent Class: CIM_LogicalDevice Property Description Data Type TimeoutInterval Indicates the time-out interval used by the watchdog, in microseconds. uint32 TimerResolution Indicates the resolution of the watchdog timer. For example, if this value is 100, then the timer can expire anytime between –100 microseconds and +100 microseconds.
CIM_Fan CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_CoolingDevice CIM_Fan The CIM_Fan class explained in Table 3-20 contains a set of devices that work to keep the ambient internal temperature of the system at a safe value by circulating air. Table 3-20. CIM_Fan Properties Class Name: CIM_Fan Parent Class: CIM_CoolingDevice Property Description Data Type VariableSpeed Specifies whether the fan supports variable speeds.
CIM_UserDevice CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_UserDevice The CIM_UserDevice class shown in Table 3-21 contains logical devices that allow a computer system’s users to input, view, or hear data. Classes derived from CIM_UserDevice include CIM_Keyboard and CIM_PointingDevice. Table 3-21.
Table 3-22. CIM_PointingDevice Properties Class Name: CIM_PointingDevice Parent Class: CIM_UserDevice Property Description PointingType Indicates the type of pointing device. Values for the uint16 PointingType property are: Data Type 1 - Other 2 - Unknown 3 - Mouse 4 - Trackball 5 - Trackpoint 6 - Glidepoint 7 - Touch pad 8 - Touch screen 9 - Mouse—optical sensor NumberOfButtons Indicates the number of buttons. If the CIM_PointingDevice has no buttons, a value of 0 is returned.
CIM_Keyboard CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_UserDevice CIM_Keyboard The CIM_Keyboard class explained in Table 3-23 includes devices that allow users to enter data. Table 3-23. CIM_Keyboard Properties Class Name: CIM_Keyboard Parent Class: CIM_UserDevice Property Description Data Type NumberOfFunctionKeys Indicates the number of function keys on the keyboard. uint16 Layout A free-form string indicating the format and layout of the keyboard.
CIM_PowerSupply CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_PowerSupply The CIM_PowerSupply class described in Table 3-24 contains devices that provide current and voltage for the operation of the system and its components. Table 3-24. CIM_PowerSupply Properties Class Name: CIM_PowerSupply Parent Class: CIM_LogicalDevice Property Description Data Type IsSwitchingSupply Indicates that the power supply is a switching power supply and not a linear power supply.
Table 3-24. CIM_PowerSupply Properties (continued) Class Name: CIM_PowerSupply Parent Class: CIM_LogicalDevice Property Description ActiveInputVoltage Indicates which input voltage range is currently uint16 in use. Range 1, 2, or both can be specified using the values 3, 4, or 5, respectively. If the supply is not drawing power, a value of 6 (neither) can be specified. This information is necessary in the case of an uninterruptible power supply (UPS), a subclass of power supply.
CIM_Controller CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Controller The CIM_Controller class shown in Table 3-25 groups miscellaneous controlrelated devices. Examples of controllers are small computer system interface (SCSI) controllers, Universal Serial Bus (USB) controllers, and serial controllers. Table 3-25.
CIM_ParallelController CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Controller CIM_ParallelController The CIM_ParallelController class identified in Table 3-26 contains a set of objects that control parallel devices. Parallel controllers transfer 8 or 16 bits of data at a time to the devices they control, for example, a parallel port controlling a printer. Table 3-26.
CIM_SerialController CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Controller CIM_SerialController The CIM_SerialController class explained in Table 3-27 contains controllers that transfer data one bit at a time to the devices they control, for example, a serial port controlling a modem. Table 3-27.
CIM_PCIController CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Controller CIM_PCIController The CIM_PCIController class listed in Table 3-28 contains a set of devices that follow the Peripheral Component Interconnect (PCI) protocol defined by the Personal Computer Memory Card International Association (PCMCIA). The PCI protocol defines how data is transferred between devices. The CIM_PCIController class contains PCI adapters and bridges. Table 3-28.
Table 3-28.
Table 3-29. CIM_PCIDevice Properties Class Name: CIM_PCIDevice Parent Class: CIM_PCIController Property Description Data Type BaseAddress Identifies an array of up to six doubleword base memory addresses. uint32 SubsystemID Identifies a subsystem identifier code. uint16 SubsystemVendorID Identifies a subsystem vendor ID. ID uint16 information is reported from a PCI device via protocol-specific requests.
Table 3-30. CIM_PCIBridge Properties Class Name: CIM_PCIBridge Parent Class: CIM_PCIController Property Description Data Type BaseAddress Identifies an array of double-word base memory addresses. uint32 BridgeType Indicates the type of bridge. A bridge is PCI to , except for the Host, which is a host-to-PCI bridge. Values for the BridgeType property are as follows: uint16 0 - Host 1 - ISA 128 - Other BaseAddress Identifies an array of double-word base memory addresses.
Table 3-31. CIM_Processor Properties Class Name: CIM_Processor Parent Class: CIM_LogicalDevice Property Description Data Type Role A string describing the role of the microprocessor, for example, central microprocessor or math processor. string UpgradeMethod uint16 Provides microprocessor socket information including data on how this microprocessor can be upgraded (if upgrades are supported). This property is an integer enumeration.
Table 3-31. CIM_Processor Properties (continued) Class Name: CIM_Processor Parent Class: CIM_LogicalDevice Property Description Data Type CoreEnabledCount Indicates the number of core processors enabled. uint16 CurrentClockSpeed Indicates the current speed (in MHz) of this microprocessor. uint32 DataWidth Indicates the processor data width in bits. uint16 AddressWidth Indicates the processor address width in bits.
Table 3-31. CIM_Processor Properties (continued) Class Name: CIM_Processor Parent Class: CIM_LogicalDevice Property Description ExtendedStates Indicates the setting of the extended capabilities of uint16 the processor. This attribute is a bit field.
Table 3-31. CIM_Processor Properties (continued) Class Name: CIM_Processor Parent Class: CIM_LogicalDevice Property Description Data Type Family Refers to the processor family type.
Table 3-31.
Table 3-31.
Table 3-31.
Table 3-31.
CIM_StorageExtent CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_StorageExtent CIM_StorageExtent identified in Table 3-32 contains devices that manage data storage, for example, hard drives or microprocessor memory. Table 3-32.
CIM_CacheMemory CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_StorageExtent CIM_Memory CIM_CacheMemory The CIM_CacheMemory class explained in Table 3-34 describes the capabilities and management of cache memory. Cache memory allows a microprocessor to access data and instructions faster than normal system memory. Table 3-34.
Table 3-34. Class Name: CIM_CacheMemory Properties (continued) CIM_CacheMemory Parent Class: CIM_Memory Property Description Data Type WritePolicy Either defines whether this cache is a write-back or uint16 write-through cache or whether this information varies with address or is defined individually for each input/output (I/O).
CIM_SoftwareElement CIM_ManagedSystemElement CIM_LogicalElement CIM_SoftwareElement The CIM_SoftwareElement class described in Table 3-35 is used to define a CIM_SoftwareFeature. The CIM_SoftwareElement class consists of individually manageable or deployable parts for a particular platform. A software element’s platform is uniquely identified by its underlying hardware architecture and operating system (for example, a system running Microsoft® Windows NT® on an Intel microprocessor).
Table 3-35. CIM_SoftwareElement Properties (continued) Class Name: CIM_SoftwareElement Parent Class: CIM_LogicalElement Property Description Data Type SoftwareElementType Indicates the type of software element.
CIM_BIOSElement CIM_ManagedSystemElement CIM_LogicalElement CIM_SoftwareElement CIM_BIOSElement The CIM_BIOSElement class listed in Table 3-36 describes the BIOS for the system. The BIOS controls the following: • Communications between the microprocessor and peripheral devices, such as the keyboard and the video adapter • Miscellaneous functions, such as system messages Table 3-36.
CIM_SoftwareFeature CIM_ManagedSystemElement CIM_LogicalElement CIM_SoftwareFeature The CIM_SoftwareFeature class shown in Table 3-37 defines a particular function or capability of a product or application system. This class is intended to be meaningful to a consumer, or user of a product, rather than to explain how the product is built or packaged.
DELL_SoftwareFeature CIM_ManagedSystemElement CIM_LogicalElement CIM_SoftwareFeature DELL_SoftwareFeature DELL_SoftwareFeature described in Table 3-38 defines the universal resource locator (URL) of the systems management software and the language in which systems management information displays. Defining these properties enables users to manage a system using an Internet browser.
Table 3-39. CIM_SystemResource Properties Class Name: CIM_SystemResource Parent Class: CIM_LogicalElement CIM_IRQ CIM_ManagedSystemElement CIM_LogicalElement CIM_SystemResource CIM_IRQ The CIM_IRQ class described in Table 3-40 contains IRQ information. An IRQ is a signal that data is about to be sent to or received by a peripheral device. The signal travels by an IRQ line to the microprocessor. Each peripheral connection must be assigned an IRQ number.
Table 3-40. CIM_IRQ Properties (continued) Class Name: CIM_IRQ Parent Class: CIM_SystemResource Property Description Availability Indicates the availability of the IRQ. Values for uint16 the Availability property are as follows: Data Type 1 - Other 2 - Unknown 3 - Available 4 - In use/not available 5 - In use and available TriggerLevel Indicates whether the interrupt is triggered by uint16 the hardware signal going high or low.
Table 3-40. CIM_IRQ Properties (continued) Class Name: CIM_IRQ Parent Class: CIM_SystemResource Property Description Shareable Indicates whether the IRQ can be shared. Boolean A value of TRUE indicates that the IRQ can be shared. Hardware Indicates whether the interrupt is hardware- or Boolean software-based. (A value of TRUE indicates that the interrupt is hardware based.
Table 3-41. CIM_MemoryMappedIO Properties Class Name: CIM_MemoryMappedIO Parent Class: CIM_SystemResource Property Description Data Type CSCreationClassName See Table 1-1. string CSName See Table 1-1. string CreationClassName See Table 1-1. string StartingAddress Identifies the starting address of memory mapped I/O. uint64 EndingAddress Identifies the ending address of memory mapped I/O. uint64 MappedResource Indicates the type of memory mapped I/O.
Table 3-42. CIM_DMA Properties Class Name: CIM_DMA Parent Class: CIM_SystemResource Property Description Data Type CSCreationClassName See Table 1-1. string CSName See Table 1-1. string CreationClassName See Table 1-1. string DMAChannel Identifies a part of the object’s key value, the DMA channel number. uint32 Availability Indicates the availability of the DMA.
Table 3-43. CIM_RedundancyGroup Properties Class Name: CIM_RedundancyGroup Parent Class: CIM_LogicalElement Property Description Data Type CreationClassName See Table 1-1 string Name Serves as the key for the redundancy group’s instance in an enterprise environment. string RedundancyStatus Provides information on the state of the redundancy uint16 group. Values for the RedundancyStatus property are as follows: 0 - Unknown 1 - Other 2 - Fully redundant.
Table 3-44. CIM_ExtraCapacityGroup Properties Class Name: CIM_ExtraCapacityGroup Parent Class: CIM_RedundancyGroup Property Description Data Type MinNumberNeeded Specifies the smallest number of elements that must uint32 be operational in order to have redundancy. For example, in an N+1 redundancy relationship, the MinNumberNeeded property should be set to N.
DELL_FanRedundancyGroup CIM_ManagedSystemElement CIM_LogicalElement CIM_RedundancyGroup CIM_ExtraCapacityGroup DELL_FanRedundancyGroup The DELL_FanRedundancyGroup described in Table 3-46 defines what constitutes fan redundancy in a system. Table 3-46.
CIM_ServiceAccessPoint CIM_ManagedSystemElement CIM_LogicalElement CIM_EnabledLogicalElement CIM_ServiceAccessPoint The CIM_ServiceAccessPointGroup class described in Table 3-48 represents the ability to utilize or invoke a service. Access points indicate that a service is available to other entities for use. Table 3-48.
Table 3-49. CIM_RemoteServiceAccessPointGroup Properties Class Name: CIM_RemoteServiceAccessPointGroup Parent Class: CIM_ServiceAccessPointGroup Property Description AccessInfo Describes accessing or addressing of information for string a remote connection. This can be a host name, network address, and other similar information. InfoFormat uint16 Indicates an enumerated integer describing the format and interpretation of the AccessInfo property.
DELL_RemoteServiceAccessPort CIM_ManagedSystemElement CIM_LogicalElement CIM_EnabledLogicalElement CIM_ServiceAccessPoint CIM_RemoteServiceAccessPoint DELL_RemoteServiceAccessPort The DELL_RemoteServiceAccessPortGroup class described in Table 3-50 is an extended class of the CIM_RemoteServiceAccessPointGroup class. The DELL_RemoteServiceAccessPortGroup class provides information about Dell implementation-specific attributes. Table 3-50.
CIM_LogicalElement
Dell-Defined Classes The Dell-defined classes are defined and populated by Dell™ rather than by CIM. None of these classes have a parent class and are on the same level as CIM_ManagedSystemElement. For information on how the logs are formatted, see Table 2-5. DELL_EsmLog CIM_ManagedSystemElement DELL_EsmLog The DELL_EsmLog class described in Table 4-1 records failure threshold violations collected by Server Administrator’s embedded server management (ESM) capabilities. Table 4-1.
DELL_PostLog CIM_ManagedSystemElement DELL_PostLog The DELL_PostLog identified in Table 4-2 is a record of the system’s power-on self-test (POST). When you turn on a system, the POST tests various system components, such as random-access memory (RAM), the hard drives, and the keyboard. Table 4-2. DELL_PostLog Properties Class Name: DELL_PostLog Parent Class: None DELL_CMApplication NOTE: Dell-updateable components, such as BIOS and FW, are considered applications.
Table 4-3.
Table 4-4.
DELL_CMInventory CIM_ManagedSystemElement DELL_CMInventory The DELL_CMInventory identified in Table 4-6 contains information related to the Dell Change Management inventory. .. Table 4-6.
Table 4-7.
Table 4-8.
Management Object File For Change Management This section shows the Management Object File (MOF) invcim.mof. #pragma classflags("forceupdate") #pragma namespace("\\\\.\\Root\\CIMV2") [Locale(1033) : ToInstance] Instance of __Namespace { Name = "Dell"; }; #pragma namespace ("\\\\.
SupportsEnumeration = "TRUE"; }; instance of __MethodProviderRegistration { Provider = $P; }; //core.mof //===================================== // Using my own MOF instead of inheriting from existing MOFs, for rapid prototyping. // ===================================== [Dynamic, Provider ("omprov"), Description("The Dell_CMDevice class contains all the information related to the Dell Change Management Device.
[write (true), key: ToSubClass] string subVendorID; [write (true), key: ToSubClass] string bus; [write (true), key: ToSubClass] string device; [write (true), key: ToSubClass] string function; }; [Dynamic, Provider ("omprov"), Description("The Dell_CMInventory class contains all the information related to the Dell Change Management Inventory.
{ [write (true), key: ToSubClass] string name; [write (true), key: ToSubClass] string description; [write (true), key: ToSubClass] string vendor; [write (true), key: ToSubClass] string version; }; [Dynamic, Provider ("omprov"), Description("The Dell_CMOS class contains all the information related to the Dell Change Management operating system.
}; [Dynamic, Provider ("omprov"), Description("The Dell_CMApplication class contains all the information related to the Dell Change Management Application.
Dell_CMDevice REF Antecedent; [key, Override ("Dependent"), Description ("The Application") ] Dell_CMApplication REF Dependent; }; // ===== // end of file // ===== Classes for Power Management The new classes introduced for power management are: // ================================================== // DELL_PowerConsumptionAmpsSensor // ================================================== [Dynamic, Provider ("dccim32"), Description ( "Monitors the power consumption") ] class DELL_PowerConsumptionAmpsSensor :
[Override("UnitModifier") ] sint32 UnitModifier = -1; [Override("RateUnits") ] uint16 RateUnits = 0; [Override ("CurrentReading"), // Override is used to define the MappingString qualifier MappingStrings {"MIF.DMTF|Electrical Current Probe|001.5"} ] sint32 CurrentReading; [Override ("NominalReading"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.6"} ] sint32 NominalReading; [Override ("NormalMax"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.
[Override ("NormalMin"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.8"} ] sint32 NormalMin; [Override ("MaxReadable"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.9"} ] sint32 MaxReadable; [Override ("MinReadable"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.10"} ] sint32 MinReadable; [Override ("Resolution"), Units ("Tenths of MilliAmps"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.17"} ] uint32 Resolution; [Override ("Tolerance"), MappingStrings {"MIF.
] sint32 Tolerance; [Override ("Accuracy"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.19"} ] sint32 Accuracy; [read, write,MappingStrings {"MIF.DMTF|Electrical Current Probe|001.11"} ] sint32 LowerThresholdNonCritical; [read, write,MappingStrings {"MIF.DMTF|Electrical Current Probe|001.12"} ] sint32 UpperThresholdNonCritical; [read,MappingStrings {"MIF.DMTF|Electrical Current Probe|001.13"} ] sint32 LowerThresholdCritical; [Override ("UpperThresholdCritical"), MappingStrings {"MIF.
sint32 UpperThresholdCritical; [Override ("LowerThresholdFatal"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.15"} ] sint32 LowerThresholdFatal; [Override ("UpperThresholdFatal"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.
[Override("BaseUnits") ] uint16 BaseUnits = 7; [Override("UnitModifier") ] sint32 UnitModifier = 0; [Override("RateUnits") ] uint16 RateUnits = 0; [Override ("CurrentReading"), // Override is used to define the MappingString qualifier MappingStrings {"MIF.DMTF|Electrical Current Probe|001.5"} ] sint32 CurrentReading; [Override ("NominalReading"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.6"} ] sint32 NominalReading; [Override ("NormalMax"), MappingStrings {"MIF.
] sint32 NormalMax; [Override ("NormalMin"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.8"} ] sint32 NormalMin; [Override ("MaxReadable"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.9"} ] sint32 MaxReadable; [Override ("MinReadable"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.10"} ] sint32 MinReadable; [Override ("Resolution"), Units ("Tenths of MilliAmps"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.
[Override ("Tolerance"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.18"} ] sint32 Tolerance; [Override ("Accuracy"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.19"} ] sint32 Accuracy; [read, write,MappingStrings {"MIF.DMTF|Electrical Current Probe|001.11"} ] sint32 LowerThresholdNonCritical; [read, write,MappingStrings {"MIF.DMTF|Electrical Current Probe|001.12"} ] sint32 UpperThresholdNonCritical; [read,MappingStrings {"MIF.DMTF|Electrical Current Probe|001.
[Override ("UpperThresholdCritical"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.14"} ] sint32 UpperThresholdCritical; [Override ("LowerThresholdFatal"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.15"} ] sint32 LowerThresholdFatal; [Override ("UpperThresholdFatal"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.
class DELL_PowerConsumptionData : CIM_LogicalDevice { [Description ( "total power consumed from a start time") ] uint32 cumulativePowerReading; [Description ( "The time from which the power reading is accumulated") ] datetime cprStartTime; [Description ( "Peak amperage reading") ] unint16 peakAmpReading; [Description ( "The time from which the peak amp reading is being monitored") ] datetime parStartTime; [Description ( "The time of the peak amp reading") ] 120 Dell-Defined Classes
datetime parTime; [Description ( "Peak wattage reading") ] unint16 peakWattReading; [Description ( "The time from which the peak watt reading is being monitored") ] datetime pwrStartTime; [Description ( "The time of the peak watt reading") ] datetime pwrTime; [Description ( "function to be used to reset the peak readings") ] uint32 ResetCounters([IN]sint32 counter); }; // ================================================== // DELL_AssociatedSupplyPCAmps Dell-Defined Classes 121
// ================================================== [Association, Description ( "A PowerConsumptionAmpsSensor associated with a CIM_PowerSupply which is defined by this class.") ] class DELL_AssociatedSupplyPCAmps : CIM_Dependency { [Override ("Antecedent"), Description ("The PowerSupply instance.") ] CIM_PowerSupply REF Antecedent; [Override ("Dependent"), Description ( "The PowerConsumptionAmpsSensor associated with the CIM_PowerSupply.
"A PowerConsumptionWattsSensor associated with a DELL_System which is defined by this class.") ] class DELL_AssociatedSystemPCWatts: CIM_Dependency { [Override ("Antecedent"), Description ("The DELL_System instance.") ] DELL_System REF Antecedent; [Override ("Dependent"), Description ( "The PowerConsumptionWattsSensor associated with the system.
{ [Override ("Antecedent"), Description ("The DELL_System instance.") ] DELL_System REF Antecedent; [Override ("Dependent"), Description ( "The PowerConsumptionData associated with the PowerSupply.
uint32 DellInstanceID; [read, Description ( "Enables or Disables the Trusted Platform Module (TPM).
Dell-Defined Classes
CIM_Dependency The CIM_Dependency class is an association used to establish dependency relationships between two managed system elements. CIM_Dependency shown in Figure 5-1 does not have a parent class because it is a relationship or association between two elements. Figure 5-1.
DELL_FanSensor CIM_ManagedSystemElement CIM_Dependency DELL_FanSensor The DELL_FanSensor class described in Table 5-1 defines a Dell-specific association between a fan and a sensor. The CIM_PackageFanSensor class contains fans that assist in cooling the entire package as opposed to a fan that is dedicated to cooling only some of the components in the package. Table 5-1.
Table 5-2. CIM_PackageTempSensor Properties Class Name: CIM_PackageTempSensor Parent Class: CIM_Dependency Element Description Antecedent CIM_TempSensor refers to the temperature sensor for the package. Dependent CIM_PhysicalPackage refers to the physical package whose environment is being monitored.
CIM_PackageCurrentSensor CIM_ManagedSystemElement CIM_Dependency CIM_PackageCurrentSensor The CIM_PackageCurrentSensor shown in Table 5-4 contains amperage sensors that are often installed in a package such as a chassis or a rack to assist in the monitoring of the package in general. This relationship is described by the CIM_PackageCurrentSensor association. Table 5-4.
Table 5-5. CIM_PackageFanSensor Properties Class Name: CIM_PackageFanSensor Parent Class: CIM_Dependency Element Description Antecedent CIM_Fan refers to the cooling device for the package. Dependent CIM_PhysicalPackage refers to the physical package whose environment is being monitored.
DELL_PackagePSRedundancy CIM_ManagedSystemElement CIM_Dependency DELL_PackagePSRedundancy The DELL_PackagePSRedundancy class listed in Table 5-7 defines what constitutes power supply redundancy for an entire package. Table 5-7. DELL_PackagePSRedundancy Properties Class Name: DELL_PackagePSRedundancy Parent Class: CIM_Dependency Element Description Antecedent DELL_PSRedundancyGroup refers to power supplies that deliver wattage for the entire package.
Table 5-8. DELL_PSRedundancy Properties Class Name: DELL_PSRedundancy Parent Class: CIM_Dependency Element Description Antecedent CIM_PowerSupplySensor refers to the power supply sensor that monitors wattage for the entire package. Dependent CIM_PhysicalPackage refers to the package whose wattage is being monitored.
CIM_Dependency
Glossary The following list defines or identifies technical terms, abbreviations, and acronyms used in user documents. asset tag code An individual code assigned to a computer, usually by a system administrator, for security or tracking purposes. attribute An attribute, or property, contains a specific piece of information about a manageable component. For example, a component can have attributes for settings, capabilities, and status.
component Manageable components are operating systems, computer systems, expansion cards, or peripherals that are compatible with a systems management standard such as CIM and SNMP. Each component is made up of groups and attributes that are defined as relevant to that component. controller A chip that controls the transfer of data between the microprocessor and memory or between the microprocessor and a peripheral device such as a disk drive or the keyboard.
property A property is a capability or characteristic of a CIM class. The temperature probe class, for example, has a property that describes its thresholds for normal, lower critical, and upper critical ranges of operation. Defining where normal operation ends and where critical temperatures begin determines when warnings should be sent to the systems manager for corrective action. Every property has a Description and a Data Type.
SNMP Abbreviation for Simple Network Management Protocol. SNMP is an industrystandard interface that allows a network manager to remotely monitor and manage workstations. unattended installation An unattended installation requires far less operator involvement than an interactive installation. Also called a “silent installation,” unattended installation programs record the administrator’s preferences about which features of an application program to install.
Index C CIM classes and properties, 10 base classes, 10 classes that describe relationships, 11 common properties of classes, 12 conventions, 12 parent classes, 11 CIM_Chip, 24 CIM_Dependency CIM_PackageCurrentSensor, 130 CIM_PackageFanSensor, 130 CIM_PackagePowerSupplySensor, 131 CIM_PackageTempSensor, 128 CIM_PackageVoltSensor, 129 DELL_FanSensor, 128 DELL_PackagePSRedundancy, 1 32 DELL_PSRedundancy, 132 CIM_LogicalElement CIM_BIOSElement, 82 CIM_CacheMemory, 80 CIM_ComputerSystem, 38 CIM_Controller, 64 C
CIM_PhysicalComponent, 24 DELL_CMProductInfo, 104 CIM_PhysicalElememt CIM_PhysicalConnector, 28 CIM_PhysicalMemory, 26 DELL_EsmLog, 99 CIM_PhysicalElement, 17 CIM_Chassis, 21 CIM_Chip, 24 CIM_PhysicalComponent, 24 CIM_PhysicalFrame, 20 CIM_PhysicalPackage, 19 CIM_Slot, 31 DELL_Chassis, 22 structure of, 17 DELL_PostLog, 100 CIM_PhysicalElementClass structure of, 17 DELL_ManagedSystemServices Device, 43 DELL_PSRedundancy, 132 description, 15 P parent class, 15 property, 15 CIM_SoftwareElement, 82 S
