System Info Profile 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 Document Number: DCIM1048 Document Type: Specification Document Status: Published Document Language: E Date: 2012-12-30 Version: 1.4.
32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 THIS PROFILE IS FOR INFORMATIONAL PURPOSES ONLY, AND MAY CONTAIN TYPOGRAPHICAL ERRORS AND TECHNICAL INACCURACIES. THE CONTENT IS PROVIDED AS IS, WITHOUT EXPRESS OR IMPLIED WARRANTIES OF ANY KIND. ABSENT A SEPARATE AGREEMENT BETWEEN YOU AND DELL™ WITH REGARD TO FEEDBACK TO DELL ON THIS PROFILE SPECIFICATION, YOU AGREE ANY FEEDBACK YOU PROVIDE TO DELL REGARDING THIS PROFILE SPECIFICATION WILL BE OWNED AND CAN BE FREELY USED BY DELL.
67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 CONTENTS 1 2 3 4 5 6 7 Scope .................................................................................................................................................... 7 Normative References ........................................................................................................................... 7 Terms and Definitions ................................................................................
94 Figures 95 96 97 Figure 1 – Class Diagram ........................................................................................................................... 10 Figure 2 – System Info Profile Implementation ...........................................................................................
140 141 Table 42 – IdentifyChassis( ) Method: Standard Messages ....................................................................... 39 Table 34 – Privilege and License Requirements ........................................................................................ 39 142 Version 1.4.
System Info Profile 143 144 1 145 146 147 148 The DCIM System Info Profile describes the properties and interfaces for executing system management tasks related to the management of the host system. The profile standardizes and aggregates the description for the platform’s basic properties into a system view representation and provides static methodology for the clients to query the system views without substantial traversal of the model.
172 3 173 For the purposes of this document, the following terms and definitions apply. 174 175 176 3.1 177 178 179 3.2 180 181 3.3 182 183 3.4 184 185 186 3.5 187 188 189 3.6 190 191 3.7 192 193 194 195 3.8 196 197 198 199 3.9 200 201 202 3.10 203 204 205 3.11 Terms and Definitions conditional – Indicates requirements to be followed strictly in order to conform to the document when the specified conditions are met.
207 4 Symbols and Abbreviated Terms 208 209 4.1 210 211 212 4.2 213 214 4.3 215 216 4.4 217 218 219 4.5 CIM - Common Information Model iDRAC - Integrated Dell Remote Access Controller – management controller for blades and monolithic servers CMC - Chassis Manager Controller – management controller for the modular chassis WBEM - Web-Based Enterprise Management PFC - Power Factor Corrector – controls the power drawn from the power supply.
235 6 236 237 The Dell System Info Profile describes platform’s basic properties. The host system’s information is represented by an instance of DCIM_SystemView class. 238 Figure 1 details the class diagram of the Dell System Info Profile.
243 244 245 246 247 Figure 2 details typical Dell System Info Profile implementation for a platform. In order for client to discover the instrumentation’s support of this profile, SystemInfoProfile is instantiated in the Interop Namespace: root/interop. SystemInfoProfile instance describes the information about the implemented profile: most importantly, the name and version of the profile and the organization name that produced the profile.
252 7 253 This section describes the requirements and guidelines for implementing Dell System Info Profile. Implementation Description Table 2 – Class Requirements: System Info Profile 254 Element Name Requirement Description DCIM_SystemView Mandatory The class shall be implemented in the Implementation Namespace: root/dcim. See section 7.1. DCIM_SystemEnumeration Mandatory The class shall be implemented in the Implementation Namespace: root/dcim. See section 7.2.
268 7.1.2 Operations 269 The following table lists the operations implemented on DCIM_SystemView. 270 Table 3 – DCIM_SystemView – Operations Operation Name Get Enumerate Requirements Mandatory Mandatory Required Input Instance URI Class URI 271 272 7.1.3 Properties 273 274 275 276 The following table details the implemented properties for DCIM_SystemView instance that represents the host system.
Property Name Requirements Type ChassisName Mandatory string ChassisServiceTag Optional string ChassisSystemHeight Mandatory uint16 CMCIP Optional string CPLDVersion Mandatory string CPURollupStatus ExpressServiceCode Mandatory Mandatory uint32 String FanRollupStatus HostName Mandatory Mandatory uint32 string LicensingRollupStatus Mandatory uint32 14 Requirement and Description The property shall be “Main System Chassis” for monolithic and “Server Blade” for modular’s server blad
Property Name Requirements Type LifecycleControllerVersion Mandatory string Manufacturer MaxCPUSockets Mandatory Mandatory string uint32 MaxDIMMSlots MaxPCIeSlots Mandatory Mandatory uint32 uint32 MemoryOperationMode Mandatory string Model Mandatory string PlatformGUID PopulatedCPUSockets PopulatedDIMMSlots PopulatedPCIeSlots Mandatory Mandatory Mandatory Mandatory string uint32 uint32 uint32 PowerCap Mandatory Uint32 PowerCapEnabledState PowerState Mandatory Mandatory uint16 uint1
Property Name Requirements Type RollupStatus Mandatory uint32 ServerAllocation ServiceTag Optional Mandatory uint32 string smbiosGUID Mandatory string StorageRollupStatus Mandatory uint32 SysMemErrorMethodology SysMemFailOverState Mandatory Mandatory uint16 string SysMemLocation Mandatory uint16 SysMemPrimaryStatus Mandatory uint32 SysMemTotalSize Mandatory uint32 SysMemMaxCapacitySize 16 Mandatory uint32 Requirement and Description The property shall contain the rollup status
Property Name Requirements Type SystemID Mandatory uint32 SystemRevision Mandatory uint16 TempRollupStatus Mandatory uint32 UUID Mandatory string VoltRollupStatus Mandatory uint32 LastSystemInventoryTime Mandatory string LastUpdateTime Mandatory string Requirement and Description System ID describes the model of the system in integer value. The SystemID property is usually used to identify the compatibility of the updateable software/firmware.
DCIM_SystemEnumeration – System Enumeration Attributes 280 7.2 281 This section describes the implementation for the DCIM_SystemEnumeration class. 282 283 284 Each DCIM_SystemEnumeration instance is logically associated to a DCIM_SystemView instance, where the DCIM_SystemEnumeration.FQDD property is equal to the FQDD property on the DCIM_SystemView instance. 285 This class shall be instantiated in the Implementation Namespace: root/dcim. 286 7.2.
Table 6 – Class: DCIM_SystemEnumeration 303 Properties Requirements Type Additional Requirements InstanceID Mandatory String The property value shall be formed as follows: “System.Embedded.1:”. AttributeName Mandatory String The property value shall be from the “AttributeName” column in Table 11 and Table 16. AttributeDisplayName Mandatory String The property value shall be from the “AttributeDisplayName” column in Table 11 and Table 16.
316 7.3.2 Operations 317 The following table lists the operations implemented on DCIM_SystemString. Table 7 – DCIM_SystemString - Operations 318 Operation Name Get Enumerate DCIM_SystemManagementService.SetAttributte() DCIM_SystemManagementService.SetAttributes() Requirements Mandatory Mandatory Mandatory Mandatory Required Input Instance URI Class URI See section 8.1 See section 8.2 319 320 7.3.
Table 8 – Class: DCIM_SystemString 325 Properties Requirements Type Additional Requirements InstanceID Mandatory String The property value shall be formed as follows: System.Embedded.1:”. AttributeName Mandatory String The property value shall be from the “AttributeName” column in Table 12, and Table 14. AttributeDisplayName Mandatory String The property value shall be from the “AttributeDisplayName” column in Table 12, and Table 14.
335 336 337 The instance Resource URI for DCIM_SystemInteger instance shall be: “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_SystemInteger?__cimnamespace=root/dcim+InstanceID= :” 338 7.4.2 Operations 339 The following table lists the operations implemented on DCIM_SystemInteger. Table 9 – DCIM_SystemInteger - Operations 340 Operation Name Get Enumerate DCIM_SystemManagementService.SetAttributte() DCIM_SystemManagementService.
Table 10 – Class: DCIM_SystemInteger 347 Properties Requirement Type Additional Requirements InstanceID Mandatory String The property value shall be formed as follows: “System.Embedded.1:”. AttributeName Mandatory String The property value shall be from the “AttributeName” column in Table 13, Table 15, and Table 19. AttributeDisplayName Mandatory String The property value shall be from the “AttributeDisplayName” column in Table 13, Table 15, and Table 19.
Table 11 – DCIM_SystemEnumeration Server Power Attributes 362 AttributeName AttributeDisplayName PowerCapSetting Power Cap Setting IsReadOnly FALSE PossibleValues “Disabled”, “Enabled” Description Enable or disable the cap on the system power consumption. Enables monitoring of the power supply redundancy.
372 Table 13 – DCIM_SystemInteger Server Power Attributes 373 AttributeName PowerCapValue AttributeDisplayName 1 IsReadOnly LowerBound UpperBound Power Cap Value FALSE Power Cap Max Threshold TRUE 1 Power Cap Min Threshold TRUE 1 PCIe Power Power Allocation FALSE Active Power Cap Value TRUE 0 65535 ActivePowerCapValBTUHr Active Power Cap Value in BTU/hr TRUE 0 65535 RapidOnPrimSecPSUMask Rapid on Primary Sec PSU Mask TRUE RapidOnPrimaryPSU Rapid on Primary PSU FALSE PowerCapM
AttributeName Attribute Description IsReadOnly MinLength MaxLength DataCenterName Data Center Name FALSE 0 128 AisleName Aisle Name FALSE 0 128 RackName Rack Name FALSE 0 128 ChassisName Chassis Name(Modular Only) TRUE 0 64 BladeSlotNumInChassis Blade Slot Num In Chassis(Modular Only) TRUE 0 64 Value Expression 387 388 389 The following table lists the values for the DCIM_SystemInteger of this group.
AttributeName Configuration 403 404 405 406 AttributeDisplayName LCD Configuration IsReadOnly PossibleValues ““User Defined”, “Model Name”, “None”, “iDRAC IPv4 Address”, “iDRAC MAC Address”, “OS System Name”, “Service Tag”, “IPv6 Address”, “Ambient Temperature”, “System Watts”, “Asset Tag”, “OEM PM LCD Override” FALSE The following table lists the values for the DCIM_SystemString of this group. Each column heading corresponds to a property name on the DCIM_SystemString class.
Table 19 – DCIM_SystemInteger Thermal Configuration Attributes 425 AttributeName AttributeDisplayName EventGenerationInterval Event Generation Interval CriticalEventGenerationInterval Critical Event Generation Interval IsReadOnly LowerBound UpperBound FALSE 0 (disables event generation) 365 FALSE 0 365 426 7.5.5 Server OS Attributes 427 428 This section describes the attributes for managing system’s operating system.
Table 21 – DCIM_SystemManagementService - Operations 452 Operation Name Get Enumerate Invoke DCIM_SystemManagementService.SetAttributte() DCIM_SystemManagementService.SetAttributes() DCIM_SystemManagementService.CreateTargetedConfigJob() DCIM_SystemManagementService.DeletePendingConfiguration( ) DCIM_SystemManagementService.ShowErrorsOnLCD() DCIM_SystemManagementService.
471 7.7.2 Operations 472 The following table lists the operations implemented on for DCIM_LCRegisteredProfile. Table 23 – DCIM_LCRegisteredProfile - Operations 473 Operation Name Get Enumerate Requirements Mandatory Mandatory Required Input Instance URI Class URI 474 475 7.7.3 Properties 476 477 478 479 The following table lists the implemented properties for DCIM_LCRegisteredProfile instance representing System Info Profile implementation.
Table 25 – SetAttribute( ) Method: Return Code Values 495 Value Description 0 Completed with no error 2 Failed Table 26 – SetAttribute( ) Method: Parameters 496 Qualifiers Name Type Description/Values IN, REQ Target String Shall be set to “System.Embedded.1” IN, REQ AttributeName String Shall be the GroupID property value followed by “#” character and then followed by the AttributeName property value for the attribute to be modified. Example: “ServerPwr.
MessageID (OUT parameter) Message MessageArguments[] cannot set the configuration SYS012 User is not authorized to perform this operation SYS013 Invalid AttributeName %s AttributeName SYS014 Invalid AttributeValue for AttributeName %s AttributeName SYS015 Job created SYS016 Job completed with errors SYS017 Job failed SYS018 Job completed SYS019 Required dependancy input not found SYS020 Invalid Required Attribute value SYS023 No pending configurations SYS024 Attribute dependency fa
Qualifiers Name Type Description/Values IN, REQ AttributeName[] String Shall contain array of attributes where each element shall be the GroupID property value followed by “#” character and then followed by the AttributeName property value for the attribute to be modified. Example: “ServerPwr.1#PowerCapSetting” IN, REQ AttributeValue[] String Shall contain the desired attribute values. If the value is valid, the CurrentValue or PendingValue property of the specified attribute will be modified.
MessageID (OUT parameter) Message MessageArguments[] SYS014 Invalid AttributeValue for AttributeName %s AttributeName SYS015 Job created SYS016 Job completed with errors SYS017 Job failed SYS018 Job completed SYS019 Required Dependancy input not found SYS020 Invalid Required Attribute value SYS023 No pending configurations SYS024 Attribute dependency failed JCP017 Maximum job limit reached, cannot create new jobs LC062 An instance of Export or Import System Configuration is already
Table 31 – CreateTargetedConfigJob( ) Method: Return Code Values 538 Value Description 2 Failed 4096 Job Created Table 32 – CreateTargetedConfigJob( ) Method: Parameters 539 Qualifiers Name Type Description/Values IN, REQ Target String Shall be set to “System.Embedded.1” IN ScheduledStartTime String Start time for the job execution in format: yyyymmddhhmmss. The string "TIME_NOW" means immediate. IN UntilTime String End time for the job execution in format: yyyymmddhhmmss.
MessageID (OUT parameter) Message MessageArguments[] SYS014 Invalid AttributeValue for AttributeName %s AttributeName SYS015 Job created SYS016 Job completed with errors SYS017 Job failed SYS018 Job completed SYS019 Required dependancy input not found SYS020 Invalid Required Attribute value SYS023 No pending configurations SYS024 Attribute dependency failed SYS029 Unsupported parameter name JCP017 Maximum job limit reached, cannot create new jobs LC062 An instance
554 Table 36 – DeletePendingConfiguration( ) Method: Standard Messages 555 MessageID (OUT parameter) Message MessageArguments[] SYS001 The command was succesful SYS002 The command failed SYS003 Missing parameter(s) %s AttributeName/AttributeValue SYS004 Invalid parameter value for %s AttributeName/AttributeValue SYS005 AttributeName and AttributeValue count mismatch SYS006 Cannot set ReadOnly AttributeName %s AttributeName SYS007 Input out of range for %s AttributeName SYS008 Invalid
Table 37 – ShowErrorsOnLCD( ) Method: Return Code Values 560 Value Description 0 Completed with no error 2 Failed Table 38 – ShowErrorsOnLCD( ) Method: Parameters 561 Qualifiers Name Type Description/Values IN, REQ Show Boolean Whether to show or hide LCD errors OUT MessageID String Error Message ID may be used to look-up in the Dell Message registry files. For more information, see Error Message Registry.
Qualifiers Name Type Description/Values IN DurationLimit Uint8 This parameter represents the requested time limit in seconds for identifying chassis before the identifying LED turns back off. The parameter shall be specified and non-NULL, if the IdentifyState parameter has value of 2 – “Time Limited Enabled”. OUT MessageID String Error Message ID may be used to look-up in the Dell Message registry files. For more information, see Error Message Registry.
DCIM_System Management Service DCIM_SystemManagementService. SetAttribute() ENUMERATE, GET INVOKE Login None. Login, Configure LM_POWER_BUDGETING & LM_REMOTE_CONFIGURAT ION DCIM_SystemManagementService. SetAttributes() INVOKE Login, Configure LM_POWER_BUDGETING & LM_REMOTE_CONFIGURAT ION DCIM_SystemManagementService. CreateTargetedConfigJob() INVOKE Login, Configure LM_REMOTE_CONFIGURAT ION DCIM_SystemManagementService.
ANNEX A (informative) 580 581 582 583 Change Log 584 Version Date 1.4.0 1.4.0 Description Added the Thermal Configuration attribute. Added LC062 error message to the SetAttribute(), SetAttributes(), CreateTargetedConfigJob(), and DeletePendingConfiguration() methods.