CIM Reference Guide

ManualsBrandsDell ManualsNAS & storage serversOpenManage Server Administrator Version 5.5

www.dell.com | support.dell.com

Dell™ OpenManage™

Server Administrator Version 5.4

CIM Reference Guide

book.book Page 1 Tuesday, February 26, 2008 9:21 AM

Summary of content (134 pages)

PAGE 1
book.book Page 1 Tuesday, February 26, 2008 9:21 AM Dell™ OpenManage™ Server Administrator Version 5.4 CIM Reference Guide w w w. d e l l . c o m | s u p p o r t . d e l l .
PAGE 2
book.book Page 2 Tuesday, February 26, 2008 9:21 AM Notes and Notices NOTE: A NOTE indicates important information that helps you make better use of your computer. NOTICE: A NOTICE indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. ____________________ Information in this document is subject to change without notice. © 2003–2008 Dell Inc. All rights reserved. Reproduction in any manner whatsoever without the written permission of Dell Inc.
PAGE 3
book.book Page 3 Tuesday, February 26, 2008 9:21 AM Contents 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . Server Administrator . . . . . . . . . . . . . . . . . . . Documenting CIM Classes and Their Properties Base Classes Parent Classes . . . . . . . . . . . . . . . . . . . Dell-Defined Classes 9 9 10 11 . . . . . . . 11 . . . . . . . . . . . . . . . . 11 Classes That Describe Relationships Typographical Conventions . . . . . . . . . . . . . . .
PAGE 4
book.book Page 4 Tuesday, February 26, 2008 9:21 AM CIM_PhysicalMemory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 . . . . . . . . . . . . . . . . . . . . . . . . . 30 CIM_PhysicalConnector . CIM_Slot 3 CIM_LogicalElement . . . . . . . . . . . . . . . . 33 . . . . . . . . . . . . . . . . . . 34 . . . . . . . . . . . . . . . . . . . . . . . 35 CIM_LogicalElement CIM_System . . . . . . . . . . . . . . . . . . 36 . . . . . . . . . . . . . . . . . . . . . .
PAGE 5
book.book Page 5 Tuesday, February 26, 2008 9:21 AM CIM_CoolingDevice CIM_Fan . . . . . . . . . . . . . . . . . . . 53 . . . . . . . . . . . . . . . . . . . . . . . . . 54 CIM_UserDevice . . . . . . . . . . . . . . . . . . . . CIM_PointingDevice CIM_Keyboard . . . . . . . . . . . . . . . . . . . 55 . . . . . . . . . . . . . . . . . . . . . 57 CIM_PowerSupply CIM_Controller 55 . . . . . . . . . . . . . . . . . . . 58 . . . . . . . . . . . . . . . . . . . . . 60 CIM_ParallelController . .
PAGE 6
book.book Page 6 Tuesday, February 26, 2008 9:21 AM CIM_IRQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 . . . . . . . . . . . . . . . . . . . . . . . . 86 CIM_MemoryMappedIO CIM_DMA CIM_RedundancyGroup . . . . . . . . . . . . . . . . . CIM_ExtraCapacityGroup . . . . . . . . . . . . . . . . DELL_PSRedundancyGroup DELL_FanRedundancyGroup CIM_ServiceAccessPoint . . . . . . . . . . . . . . 90 . . . . . . . . . . 90 . . . . . . . . . . . . . . . .
PAGE 7
book.book Page 7 Tuesday, February 26, 2008 9:21 AM Management Object File For Change Management Classes for Power Management 5 CIM_Dependency DELL_FanSensor . . . 101 . . . . . . . . . . . . 107 . . . . . . . . . . . . . . . . . 121 122 . . . . . . . . . . . . . . . . . . . . CIM_PackageTempSensor CIM_PackageVoltSensor . . . . . . . . . . . . . . . 122 . . . . . . . . . . . . . . . . 123 . . . . . . . . . . . . . . 124 . . . . . . . . . . . . . . . .
PAGE 8
book.
PAGE 9
book.book Page 9 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 10
book.book Page 10 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 11
book.book Page 11 Tuesday, February 26, 2008 9:21 AM Parent Classes Most classes in the dccim32 provider document both a Class Name and a Parent Class property. The parent class is the 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.
PAGE 12
book.book Page 12 Tuesday, February 26, 2008 9:21 AM Typographical Conventions The following example shows how most of the classes in the Dell CIM provider are documented. Table 1-1 shows a partial class description for the DELL_DMA class. (For a full class description, see Table 3-41) Class Name appears in Courier typeface and provides the string that names the class in the MOF. Parent Class appears in Courier typeface and provides the name of the class from which the present class is derived.
PAGE 13
book.book Page 13 Tuesday, February 26, 2008 9:21 AM Common Properties of Classes Many classes have properties such as Caption, Description, and CreationClassName. Table 1-2 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-2. Common Properties of Classes Property Description Data Type Caption Describes the object using a short textual description (one-line string).
PAGE 14
book.book Page 14 Tuesday, February 26, 2008 9:21 AM Table 1-2. Common Properties of Classes (continued) Property Description Data Type Manufacturer Provides 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. string Name Defines the label by which the object is known.
PAGE 15
book.book Page 15 Tuesday, February 26, 2008 9:21 AM Table 1-2. Common Properties of Classes (continued) Property Description Data Type 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.
PAGE 16
book.book Page 16 Tuesday, February 26, 2008 9:21 AM 16 • 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.
PAGE 17
book.book Page 17 Tuesday, February 26, 2008 9:21 AM CIM_PhysicalElement CIM_PhysicalElement is a CIM-defined class. The CIM_PhysicalElement class contains the subclasses shown in Figure 2-1. Figure 2-1.
PAGE 18
book.book Page 18 Tuesday, February 26, 2008 9:21 AM Table 2-1. CIM_PhysicalElement Properties Class Name: CIM_PhysicalElement Parent Class: CIM_ManagedSystemElement Property Description Data Type CreationClass See Table 1-2. Name Manufacturer See Table 1-2. Model The name by which the physical element is generally known. SerialNumber A manufacturer-allocated number used to identify the physical element.
PAGE 19
book.book Page 19 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 20
book.book Page 20 Tuesday, February 26, 2008 9:21 AM Table 2-3. CIM_Physical Frame Properties Class Name: CIM_PhysicalFrame Parent Class: CIM_PhysicalPackage Property Description Data Type LockPresent Indicates whether the frame is protected with a lock. Boolean AudibleAlarm Indicates whether the frame is equipped with an audible alarm. Boolean VisibleAlarm Indicates that the equipment includes a visible alarm.
PAGE 21
book.book Page 21 Tuesday, February 26, 2008 9:21 AM Table 2-4.
PAGE 22
book.book Page 22 Tuesday, February 26, 2008 9:21 AM 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. This asset tag string is writable by the system administrator.
PAGE 23
book.book Page 23 Tuesday, February 26, 2008 9:21 AM Table 2-5. DELL_Chassis Properties (continued) Class Name: DELL_Chassis Parent Class: CIM_Chassis Property Description Data Type AmpStatus Indicates the global status of current sensors. string PsStatus Indicates the global status of power supplies. string MemStatus Indicates the global status of memory devices. string ProcStatus Indicates the global status of processor devices.
PAGE 24
book.book Page 24 Tuesday, February 26, 2008 9:21 AM CIM_Chip CIM_ManagedSystemElement CIM_PhysicalElement CIM_PhysicalComponent CIM_Chip The CIM_Chip class listed in Table 2-7 represents any type of integrated circuit hardware, including ASICs, processors, memory chips, and so on.
PAGE 25
book.book Page 25 Tuesday, February 26, 2008 9:21 AM Table 2-7.
PAGE 26
book.book Page 26 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 27
book.book Page 27 Tuesday, February 26, 2008 9:21 AM 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 TotalWidth Indicates the total width, in bits, of the physical memory, including check or error correction bits.
PAGE 28
book.book Page 28 Tuesday, February 26, 2008 9:21 AM Table 2-8. CIM_PhysicalMemory Properties (continued) Class Name: CIM_PhysicalMemory Parent Class: CIM_Chip Property Description Data Type 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. 0 is an invalid value for this property.
PAGE 29
book.book Page 29 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 30
book.book Page 30 Tuesday, February 26, 2008 9:21 AM Table 2-10.
PAGE 31
book.book Page 31 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 32
book.
PAGE 33
book.book Page 33 Tuesday, February 26, 2008 9:21 AM CIM_LogicalElement CIM_LogicalElement is a CIM-defined class containing the subclasses shown in Figure 3-1. Figure 3-1.
PAGE 34
book.
PAGE 35
book.book Page 35 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 36
book.book Page 36 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 37
book.book Page 37 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 38
book.book Page 38 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 39
book.book Page 39 Tuesday, February 26, 2008 9:21 AM Table 3-7. CIM_LogicalPort Properties Class Name: CIM_LogicalPort Parent Class: CIM_LogicalDevice Property Description Data Type Speed Indicates the bandwidth of the port in bits per second. uint64 MaxSpeed Indicates the maximum bandwidth of the port in bits per second. uint64 RequestedSpeed Indicates the requested bandwidth of the port in bits uint64 per second. UsageRestriction Indicates usage parameters for the port.
PAGE 40
book.book Page 40 Tuesday, February 26, 2008 9:21 AM 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 uint16 reserved or vendor reserved. When this property is set to 1 (Other), the OtherPropertyType property contains a string description of the port type.
PAGE 41
book.book Page 41 Tuesday, February 26, 2008 9:21 AM DELL_NetworkPort CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_LogicalPort CIM_NetworkPort DELL_NetworkPort The DELL_NetworkPort class listed in Table 3-9 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-9.
PAGE 42
book.book Page 42 Tuesday, February 26, 2008 9:21 AM Table 3-9. DELL_NetworkPort Properties (continued) Class Name: Dell_NetworkPort Parent Class: CIM_NetworkPort Property Description NicRDMACapability Defines NIC Remote Direct Memory Access uint32 (RDMA) 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.
PAGE 43
book.book Page 43 Tuesday, February 26, 2008 9:21 AM Table 3-9. DELL_NetworkPort Properties (continued) Class Name: Dell_NetworkPort Parent Class: CIM_NetworkPort Property Description Data Type IsRDMAEnable Indicates whether RDMA is enabled. Boolean IsiSCSIEnable Indicates whether SCSI is enabled. Boolean NicStatus Indicates NIC /driver status.
PAGE 44
book.book Page 44 Tuesday, February 26, 2008 9:21 AM CIM_Sensor CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Sensor CIM_NumericSensor CIM_CurrentSensor The CIM_Sensor class explained in Table 3-10 contains hardware devices capable of measuring the characteristics of some physical property, for example, the temperature or voltage characteristics of a computer system. Table 3-10.
PAGE 45
book.book Page 45 Tuesday, February 26, 2008 9:21 AM Table 3-10. CIM_Sensor Properties (continued) Class Name: CIM_Sensor Parent Class: CIM_LogicalDevice Property Description Data Type PossibleStates Enumerates the string outputs of the sensor. For example, a NumericSensor can report states based on threshold readings. string CurrentState Indicates the current state of the sensor. This value string is always one of the Possible States.
PAGE 46
book.book Page 46 Tuesday, February 26, 2008 9:21 AM CIM_NumericSensor CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Sensor CIM_NumericSensor The CIM_NumericSensor class described in Table 3-12 returns numeric settings and may also support threshold settings. Figure 3-2 shows the relationship among upper and lower critical and upper and lower non-critical threshold values. The normal range falls between upper and lower non-critical thresholds. Figure 3-2.
PAGE 47
book.book Page 47 Tuesday, February 26, 2008 9:21 AM Table 3-12 provides definitions for NumericSensor properties. Table 3-12. CIM_NumericSensor Properties Class Name: CIM_NumericSensor Parent Class: CIM_Sensor Property Description Data Type UnitModifier See Table 1-2. sint32 CurrentReading See Table 1-2. sint32 IsLinear See Table 1-2. Boolean LowerThresholdNonCritical See Table 1-2. sint32 UpperThresholdNonCritical See Table 1-2. sint32 LowerThresholdCritical See Table 1-2.
PAGE 48
book.book Page 48 Tuesday, February 26, 2008 9:21 AM Table 3-12. CIM_NumericSensor Properties (continued) Class Name: CIM_NumericSensor Parent Class: CIM_Sensor Property Description Data Type SettableThresholds An array representing the writable thresholds supported by sensor.
PAGE 49
book.book Page 49 Tuesday, February 26, 2008 9:21 AM Table 3-13. CIM_TemperatureSensor Properties (continued) Class Name: CIM_TemperatureSensor Parent Class: CIM_NumericSensor Property Description Data Type UpperThresholdNonCritical See Table 1-2. sint32 LowerThresholdCritical See Table 1-2. sint32 UpperThresholdCritical See Table 1-2.
PAGE 50
book.book Page 50 Tuesday, February 26, 2008 9:21 AM Table 3-14. CIM_CurrentSensor Properties (continued) Class Name: CIM_CurrentSensor Parent Class: CIM_NumericSensor Property Description Data Type UpperThresholdNonCritical See Table 1-2. sint32 LowerThresholdCritical See Table 1-2. sint32 UpperThresholdCritical See Table 1-2.
PAGE 51
book.book Page 51 Tuesday, February 26, 2008 9:21 AM Table 3-15. CIM_VoltageSensor Properties (continued) Class Name: CIM_VoltageSensor Parent Class: CIM_NumericSensor Property Description Data Type UpperThresholdNonCritical See Table 1-2. sint32 LowerThresholdCritical See Table 1-2. sint32 UpperThresholdCritical See Table 1-2.
PAGE 52
book.book Page 52 Tuesday, February 26, 2008 9:21 AM Table 3-16. CIM_Tachometer Properties (continued) Class Name: CIM_Tachometer Parent Class: CIM_NumericSensor Property Description Data Type UpperThresholdNonCritical See Table 1-2. sint32 CIM_WatchDog CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Watchdog The CIM_WatchDog class described in Table 3-17 represents a timer that is implemented in system hardware.
PAGE 53
book.book Page 53 Tuesday, February 26, 2008 9:21 AM Table 3-17. CIM_WatchDog Properties Class Name: CIM_WatchDog Parent Class: CIM_LogicalDevice Property Description Data Type MonitoredEntity Indicates the entity that is currently being monitored by the watchdog feature. This property is used to identify the module that is responsible for rearming the watchdog at periodic intervals.
PAGE 54
book.book Page 54 Tuesday, February 26, 2008 9:21 AM Table 3-18. CIM_CoolingDevice Properties Class Name: CIM_CoolingDevice Parent Class: CIM_LogicalDevice Property Description Data Type ActiveCooling Specifies whether the device provides active (as opposed to passive) cooling.
PAGE 55
book.book Page 55 Tuesday, February 26, 2008 9:21 AM CIM_UserDevice CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_UserDevice The CIM_UserDevice class shown in Table 3-20 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-20.
PAGE 56
book.book Page 56 Tuesday, February 26, 2008 9:21 AM Table 3-21. 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.
PAGE 57
book.book Page 57 Tuesday, February 26, 2008 9:21 AM CIM_Keyboard CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_UserDevice CIM_Keyboard The CIM_Keyboard class explained in Table 3-22 includes devices that allow users to enter data. Table 3-22. 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.
PAGE 58
book.book Page 58 Tuesday, February 26, 2008 9:21 AM CIM_PowerSupply CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_PowerSupply The CIM_PowerSupply class described in Table 3-23 contains devices that provide current and voltage for the operation of the system and its components.
PAGE 59
book.book Page 59 Tuesday, February 26, 2008 9:21 AM Table 3-23. 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. Boolean Range1InputVoltageLow Indicates the low voltage in millivolts of input uint32 voltage range 1 for this power supply. A value of 0 denotes unknown.
PAGE 60
book.book Page 60 Tuesday, February 26, 2008 9:21 AM CIM_Controller CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Controller The CIM_Controller class shown in Table 3-24 groups miscellaneous controlrelated devices. Examples of controllers are small computer system interface (SCSI) controllers, Universal Serial Bus (USB) controllers, and serial controllers. Table 3-24.
PAGE 61
book.book Page 61 Tuesday, February 26, 2008 9:21 AM The CIM_ParallelController class identified in Table 3-25 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-25.
PAGE 62
book.book Page 62 Tuesday, February 26, 2008 9:21 AM Table 3-26. CIM_SerialController Properties Class Name: CIM_SerialController Parent Class: CIM_Controller Property Description MaxBaudRate Indicates the maximum baud rate in bits per second uint32 supported by the serial controller. Security An enumeration indicating the operational security for the controller.
PAGE 63
book.book Page 63 Tuesday, February 26, 2008 9:21 AM Table 3-27. CIM_PCIController Properties Class Name: CIM_PCIController Parent Class: CIM_Controller Property Description Data Type CommandRegister The current contents of the register that provides uint16 basic control over the device’s ability to respond to, and/or perform PCI accesses. The data in the capabilities array is gathered from the PCI status register and the PCI capabilities list as defined in the PCI specification.
PAGE 64
book.book Page 64 Tuesday, February 26, 2008 9:21 AM CIM_PCIDevice CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Controller CIM_PCIController CIM_PCIDevice The CIM_PCIDevice class shown in Table 3-28 describes the capabilities and management of a PCI device controller on an adapter card. Table 3-28.
PAGE 65
book.book Page 65 Tuesday, February 26, 2008 9:21 AM CIM_PCIBridge CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Controller CIM_PCIController CIM_PCIBridge The CIM_PCIBridge class shown in Table 3-29 describes the capabilities and management of a PCI controller providing bridge-to-bridge capability. An example is a PCI to Industry-Standard Architecture (ISA) bus bridge. Table 3-29.
PAGE 66
book.book Page 66 Tuesday, February 26, 2008 9:21 AM CIM_Processor CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_Processor The CIM_Processor class described in Table 3-30 contains devices that interpret and execute commands, for example, the Intel® Xeon® microprocessor.
PAGE 67
book.book Page 67 Tuesday, February 26, 2008 9:21 AM Table 3-30. 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.
PAGE 68
book.book Page 68 Tuesday, February 26, 2008 9:21 AM Table 3-30. CIM_Processor Properties (continued) Class Name: CIM_Processor Parent Class: CIM_LogicalDevice Property Description Data Type AddressWidth Indicates the processor address width in bits. uint16 Stepping Indicates the revision level of the processor within the microprocessor family. string UniqueID Identifies a globally unique identifier for the string microprocessor.
PAGE 69
book.book Page 69 Tuesday, February 26, 2008 9:21 AM Table 3-30. CIM_Processor Properties (continued) Class Name: CIM_Processor Parent Class: CIM_LogicalDevice Property Description Data Type CPUStatus Indicates the current status of the microprocessor. For example, it may be disabled by the user via the BIOS or disabled due to a POST error.
PAGE 70
book.book Page 70 Tuesday, February 26, 2008 9:21 AM Table 3-30. CIM_Processor Properties (continued) Class Name: CIM_Processor Parent Class: CIM_LogicalDevice Property Description Data Type Family Refers to the processor family type.
PAGE 71
book.book Page 71 Tuesday, February 26, 2008 9:21 AM Table 3-30.
PAGE 72
book.book Page 72 Tuesday, February 26, 2008 9:21 AM Table 3-30.
PAGE 73
book.book Page 73 Tuesday, February 26, 2008 9:21 AM Table 3-30.
PAGE 74
book.book Page 74 Tuesday, February 26, 2008 9:21 AM Table 3-30.
PAGE 75
book.book Page 75 Tuesday, February 26, 2008 9:21 AM Table 3-31. CIM_StorageExtent Properties Class Name: CIM_StorageExtent Parent Class: CIM_LogicalDevice CIM_Memory CIM_ManagedSystemElement CIM_LogicalElement CIM_LogicalDevice CIM_StorageExtent CIM_Memory The CIM_Memory class identified in Table 3-32 describes the capabilities and management of storage extent devices, for example, cache memory or system memory. Table 3-32.
PAGE 76
book.book Page 76 Tuesday, February 26, 2008 9:21 AM The CIM_CacheMemory class explained in Table 3-33 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-33. CIM_CacheMemory Properties Class Name: CIM_CacheMemory Parent Class: CIM_Memory Property Description Data Type Level Defines whether this is the primary, secondary, or tertiary cache.
PAGE 77
book.book Page 77 Tuesday, February 26, 2008 9:21 AM Table 3-33. Class Name: CIM_CacheMemory Properties (continued) CIM_CacheMemory Parent Class: CIM_Memory Property Description Data Type CacheType Defines whether this cache is for instruction caching, uint16 data caching, or both (unified). Values for the CacheType property are as follows: 1 - Other 2 - Unknown 3 - Instruction 4 - Data 5 - Unified LineSize Indicates the size, in bytes, of a single cache bucket or uint32 line.
PAGE 78
book.book Page 78 Tuesday, February 26, 2008 9:21 AM platform is uniquely identified by its underlying hardware architecture and operating system (for example, a system running Microsoft® Windows NT® on an Intel microprocessor). A software element’s implementation on a particular platform depends on the platform’s operating system. Table 3-34.
PAGE 79
book.book Page 79 Tuesday, February 26, 2008 9:21 AM Table 3-34. CIM_SoftwareElement Properties (continued) Class Name: CIM_SoftwareElement Parent Class: CIM_LogicalElement Property Description Data Type SoftwareElementTyp Indicates the type of software element.
PAGE 80
book.book Page 80 Tuesday, February 26, 2008 9:21 AM CIM_BIOSElement CIM_ManagedSystemElement CIM_LogicalElement CIM_SoftwareElement CIM_BIOSElement The CIM_BIOSElement class listed in Table 3-35 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-35.
PAGE 81
book.book Page 81 Tuesday, February 26, 2008 9:21 AM The CIM_SoftwareFeature class shown in Table 3-36 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.
PAGE 82
book.book Page 82 Tuesday, February 26, 2008 9:21 AM DELL_SoftwareFeature CIM_ManagedSystemElement CIM_LogicalElement CIM_SoftwareFeature DELL_SoftwareFeature DELL_SoftwareFeature described in Table 3-37 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.
PAGE 83
book.book Page 83 Tuesday, February 26, 2008 9:21 AM Table 3-38. 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-39 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.
PAGE 84
book.book Page 84 Tuesday, February 26, 2008 9:21 AM Table 3-39. 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 the hardware signal going high or low.
PAGE 85
book.book Page 85 Tuesday, February 26, 2008 9:21 AM Table 3-39. CIM_IRQ Properties (continued) Class Name: CIM_IRQ Parent Class: CIM_SystemResource Property Description Hardware Indicates whether the interrupt is hardware- or Boolean software-based. (A value of TRUE indicates that the interrupt is hardware based.) On a personal computer, a hardware IRQ is a physical wire to a programmable interrupt controller (PIC) chip set through which the microprocessor can be notified of time critical events.
PAGE 86
book.book Page 86 Tuesday, February 26, 2008 9:21 AM Table 3-40. CIM_MemoryMappedIO Properties Class Name: CIM_MemoryMappedIO Parent Class: CIM_SystemResource Property Description Data Type CSCreationClassName See Table 1-2. string CSName See Table 1-2. string CreationClassName See Table 1-2. string StartingAddress Identifies the starting address of memory mapped I/O. uint64 EndingAddress Identifies the ending address of memory mapped I/O.
PAGE 87
book.book Page 87 Tuesday, February 26, 2008 9:21 AM Table 3-41. CIM_DMA Properties Class Name: CIM_DMA Parent Class: CIM_SystemResource Property Description Data Type CSCreationClassName See Table 1-2. string CSName See Table 1-2. string CreationClassName See Table 1-2. string DMAChannel Identifies a part of the object’s key value, the DMA channel number. uint32 Availability Indicates the availability of the DMA.
PAGE 88
book.book Page 88 Tuesday, February 26, 2008 9:21 AM Table 3-42. CIM_RedundancyGroup Properties Class Name: CIM_RedundancyGroup Parent Class: CIM_LogicalElement Property Description Data Type CreationClassName See Table 1-2 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.
PAGE 89
book.book Page 89 Tuesday, February 26, 2008 9:21 AM Table 3-43. 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.
PAGE 90
book.book Page 90 Tuesday, February 26, 2008 9:21 AM DELL_FanRedundancyGroup CIM_ManagedSystemElement CIM_LogicalElement CIM_RedundancyGroup CIM_ExtraCapacityGroup DELL_FanRedundancyGroup The DELL_FanRedundancyGroup described in Table 3-45 defines what constitutes fan redundancy in a system. Table 3-45.
PAGE 91
book.book Page 91 Tuesday, February 26, 2008 9:21 AM CIM_ServiceAccessPoint CIM_ManagedSystemElement CIM_LogicalElement CIM_EnabledLogicalElement CIM_ServiceAccessPoint The CIM_ServiceAccessPointGroup class described in Table 3-47 represents the ability to utilize or invoke a service. Access points indicate that a service is available to other entities for use. Table 3-47.
PAGE 92
book.book Page 92 Tuesday, February 26, 2008 9:21 AM Table 3-48. 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 Indicates an enumerated integer describing the format and interpretation of the AccessInfo property.
PAGE 93
book.book Page 93 Tuesday, February 26, 2008 9:21 AM DELL_RemoteServiceAccessPort CIM_ManagedSystemElement CIM_LogicalElement CIM_EnabledLogicalElement CIM_ServiceAccessPoint CIM_RemoteServiceAccessPoint DELL_RemoteServiceAccessPort The DELL_RemoteServiceAccessPortGroup class described in Table 3-49 is an extended class of the CIM_RemoteServiceAccessPointGroup class. The DELL_RemoteServiceAccessPortGroup class provides information about Dell implementation-specific attributes. Table 3-49.
PAGE 94
book.
PAGE 95
book.book Page 95 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 96
book.book Page 96 Tuesday, February 26, 2008 9:21 AM DELL_PostLog CIM_ManagedSystemElement DELL_PostLog The DELL_PostLog identified in Table 4-2 is a record of the system’s poweron 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.
PAGE 97
book.book Page 97 Tuesday, February 26, 2008 9:21 AM Table 4-3.
PAGE 98
book.book Page 98 Tuesday, February 26, 2008 9:21 AM Table 4-4.
PAGE 99
book.book Page 99 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 100
book.book Page 100 Tuesday, February 26, 2008 9:21 AM Table 4-7.
PAGE 101
book.book Page 101 Tuesday, February 26, 2008 9:21 AM Table 4-8. DELL_CMProductInfo Properties (continued) Class Name: DELL_CMProductInfo Parent Class: None version Indicates the current version number of the product string DELL_BIOSExtensions The DELL_BIOSExtensions identified in Table 4-9 contain information related to the specific extension of the data attributes on your system. Table 4-9.
PAGE 102
book.book Page 102 Tuesday, February 26, 2008 9:21 AM }; #pragma namespace ("\\\\.
PAGE 103
book.book Page 103 Tuesday, February 26, 2008 9:21 AM // ===================================== [Dynamic, Provider ("omprov"), Description("The Dell_CMDevice class contains all the the information related to the Dell Change Management Device.
PAGE 104
book.book Page 104 Tuesday, February 26, 2008 9:21 AM [Dynamic, Provider ("omprov"), Description("The Dell_CMInventory class contains all the information related to the Dell Change Management Inventory.
PAGE 105
book.book Page 105 Tuesday, February 26, 2008 9:21 AM [Dynamic, Provider ("omprov"), Description("The Dell_CMOS class contains all the information related to the Dell Change Management operating system.
PAGE 106
book.book Page 106 Tuesday, February 26, 2008 9:21 AM string subComponentID; [write (true), key: ToSubClass] string version; [write (true), key: ToSubClass] string name; [write (true), key: ToSubClass] string deviceKey; }; [Association, Dynamic, Provider ("omprov"), Description("The Dell_CMDeviceApplication class contains all the information related to the Dell Change Management association between the device and the application (1:n).
PAGE 107
book.
PAGE 108
book.book Page 108 Tuesday, February 26, 2008 9:21 AM // 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.7"} ] sint32 NormalMax; [Override ("NormalMin"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.
PAGE 109
book.book Page 109 Tuesday, February 26, 2008 9:21 AM ] 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.DMTF|Electrical Current Probe|001.18"} ] sint32 Tolerance; [Override ("Accuracy"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.
PAGE 110
book.book Page 110 Tuesday, February 26, 2008 9:21 AM [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.DMTF|Electrical Current Probe|001.
PAGE 111
book.book Page 111 Tuesday, February 26, 2008 9:21 AM [Override ("UpperThresholdFatal"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.
PAGE 112
book.book Page 112 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 113
book.book Page 113 Tuesday, February 26, 2008 9:21 AM [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.DMTF|Electrical Current Probe|001.
PAGE 114
book.book Page 114 Tuesday, February 26, 2008 9:21 AM ] 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.DMTF|Electrical Current Probe|001.
PAGE 115
book.book Page 115 Tuesday, February 26, 2008 9:21 AM sint32 LowerThresholdFatal; [Override ("UpperThresholdFatal"), MappingStrings {"MIF.DMTF|Electrical Current Probe|001.
PAGE 116
book.
PAGE 117
book.
PAGE 118
book.book Page 118 Tuesday, February 26, 2008 9:21 AM ] CIM_PowerSupply REF Antecedent; [Override ("Dependent"), Description ( "The PowerConsumptionAmpsSensor associated with the CIM_PowerSupply.
PAGE 119
book.book Page 119 Tuesday, February 26, 2008 9:21 AM Description ( "The PowerConsumptionWattsSensor associated with the system.") ] DELL_PowerConsumptionWattsSensor REF Dependent; }; // ================================================== // AssociatedSystemPCData // ================================================== [Association, Description ( "A PowerConsumptionData associated with a DELL_System which is defined by this class.
PAGE 120
book.book Page 120 Tuesday, February 26, 2008 9:21 AM DELL_PowerConsumptionData REF Dependent; }; // ================================================== // DELL_BIOSSettings // ================================================== [Dynamic, Provider("dccim32"): ToInstance, Description ( "This class defines properties used for setting parameters in the DellSystem Management BIOS.
PAGE 121
book.book Page 121 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 122
book.book Page 122 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 123
book.book Page 123 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 124
book.book Page 124 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 125
book.book Page 125 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 126
book.book Page 126 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 127
book.book Page 127 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 128
book.
PAGE 129
book.book Page 129 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 130
book.book Page 130 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 131
book.book Page 131 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 132
book.book Page 132 Tuesday, February 26, 2008 9:21 AM 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.
PAGE 133
book.
PAGE 134
book.