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-03-08 Version: 1.2.
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 CONTENTS 1 2 3 4 5 6 7 8 9 10 11 Scope .................................................................................................................................................... 5 Normative References........................................................................................................................... 5 Terms and Definitions ........................................................................
93 Figures 94 95 96 Figure 1 – Class Diagram ............................................................................................................................. 8 Figure 2 – System Info Profile Implementation .............................................................................................
System Info Profile 138 139 1 140 141 142 143 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.
167 3 168 For the purposes of this document, the following terms and definitions apply. 169 170 171 conditional – Indicates requirements to be followed strictly in order to conform to the document when the specified conditions are met. Terms and Definitions 3.1 3.2 172 173 174 mandatory - Indicates requirements to be followed strictly in order to conform to the document and from which no deviation is permitted.
202 4 203 204 CIM - Common Information Model Symbols and Abbreviated Terms 4.1 4.2 205 206 207 iDRAC - Integrated Dell Remote Access Controller – management controller for blades and monolithic servers 208 209 CMC - Chassis Manager Controller – management controller for the modular chassis 210 211 4.3 4.4 WBEM - Web-Based Enterprise Management 4.5 212 213 214 PFC - Power Factor Corrector – controls the power drawn from the power supply. 215 5 216 Profile Name: System Info 217 Version: 1.
230 6 231 232 The Dell System Info Profile describes platform’s basic properties. The host system’s information is represented by an instance of DCIM_SystemView class. 233 Figure 1 details the class diagram of the Dell System Info Profile.
238 239 240 241 242 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.
247 7 248 This section describes the requirements and guidelines for implementing Dell System Info Profile. Implementation Description 249 Table 2 – Class Requirements: System Info Profile 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 0.
263 7.1.2 Operations 264 The following table lists the operations implemented on DCIM_SystemView. 265 Table 3 – DCIM_SystemView – Operations Operation Name Get Enumerate Requirements Mandatory Mandatory Required Input Instance URI Class URI 266 267 7.1.3 Properties 268 269 270 271 The following table details the implemented properties for DCIM_SystemView instance that represents the host system.
Property Name Requirements Type Requirement and Description The property shall represent the geometric dimension of the server blade enclosure in modular enclosure described.
Property Name Requirements Type FanRollupStatus HostName Mandatory Mandatory uint32 string LicensingRollupStatus Mandatory uint32 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
Property Name Requirements Type PowerCap Mandatory Uint32 PowerCapEnabledState PowerState Mandatory Mandatory uint16 uint16 PrimaryStatus Mandatory uint32 PSRollupStatus Mandatory uint32 RollupStatus Mandatory uint32 ServerAllocation ServiceTag Optional Mandatory uint32 string smbiosGUID Mandatory string StorageRollupStatus Mandatory uint32 14 Requirement and Description The current power cap (in Watts) of the associated managed system element.
Property Name Requirements Type SysMemErrorMethodology SysMemFailOverState Mandatory Mandatory uint16 string SysMemLocation Mandatory uint16 SysMemPrimaryStatus Mandatory uint32 SysMemTotalSize Mandatory uint32 SystemID Mandatory uint32 SystemRevision Mandatory uint16 SystemGeneration Mandatory string TempRollupStatus Mandatory uint32 UUID Mandatory string VoltRollupStatus Mandatory uint32 LastSystemInventoryTime Mandatory string Version 1.2.
Property Name Requirements Type LastUpdateTime Mandatory string Requirement and Description This property provides the last time the data was updated. The value is represented as yyyymmddHHMMSS 273 274 16 Version 1.2.
275 7.2 276 This section describes the implementation for the DCIM_SystemEnumeration class. 277 278 279 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. 280 This class shall be instantiated in the Implementation Namespace: root/dcim. 281 7.2.1 Resource URIs for WinRM® 282 283 The class Resource URI shall be “http://schemas.dell.
297 Table 6 – Class: DCIM_SystemEnumeration 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 Error! Reference source not found., and Table 11.
311 Table 7 – DCIM_SystemString - Operations 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 312 313 7.3.3 Class Properties 314 315 316 317 The following table lists the implemented properties for DCIM_SystemString instance representing a system string attribute.
318 Table 8 – Class: DCIM_SystemString 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 Error! Reference source not found., Table 12, and Table 14.
331 7.4.2 Operations 332 The following table lists the operations implemented on DCIM_SystemInteger. 333 Table 9 – DCIM_SystemInteger - Operations 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 334 335 7.4.
340 Table 10 – Class: DCIM_SystemInteger 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 Error! Reference source not found., Table 13, and Table 15.
353 354 listed in the column headings. The PossibleValues property is an array property represented in the table as comma delimited list. 355 Table 11 – DCIM_SystemEnumeration Server Power Attributes 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.
365 366 Table 13 – DCIM_SystemInteger Server Power Attributes AttributeName AttributeDisplayName IsReadOnly LowerBound UpperBound PowerCapValue1 Power Cap Value FALSE PowerCapMaxThres1 Power Cap Max Threshold TRUE PowerCapMinThres1 Power Cap Min Threshold TRUE pciePowerAllocation1 PCIe Power Power Allocation TRUE 0 500 Active Power Cap Value TRUE 0 65535 1 ActivePowerCapVal 367 NOTE: 1 – The attributes PendingValue, CurrentValue and DefaultValue are in Watt units. 368 7.5.
AttributeName AttributeDisplayName IsReadOnly RackSlot Rack Slot FALSE SizeOfManagedSystemInU Size of Managed System in U TRUE LowerBound 1 UpperBound 255 384 7.5.3 LCD Attributes 385 386 This section describes the attributes for managing system’s power. The attributes are used to set the system LCD settings. 387 The GroupID property for the DCIM_SystemEnumeration and DCIM_SystemString shall be “LCD.1”.
408 409 410 411 412 The instance Resource URI for DCIM_ SystemManagementService instance shall be: “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_SystemManagementService?__cimnamespace=root/dcim+ SystemCreationClassName=DCIM_ComputerSystem+SystemName=srv:system+CreationClassName=D CIM_SystemManagementService+Name=DCIM:SystemManagementService” 413 7.6.2 Operations 414 The following table lists the operations implemented on DCIM_SystemManagementService.
430 The key property shall be the InstanceID property. 431 432 433 The instance Resource URI shall be: “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LCRegisteredProfile?__cimnamespace=root/interop+InstanceID=DCIM: SystemInfo:1.0.0” 434 7.7.2 Operations 435 The following table lists the operations implemented on for DCIM_LCRegisteredProfile.
444 445 8 446 447 This section details the requirements for supporting extrinsic methods for the CIM elements defined by this profile. 448 8.1 DCIM_SystemManagementService.SetAttribute( ) 449 The SetAttribute( ) method is used to set or change the value of a system attribute.
460 Table 23 – SetAttribute( ) Method: Standard Messages MessageID (OUT parameter) Message MessageArguments[] SYS001 The command was succesful SYS002 The command failed SYS003 Missing parameter(s) AttributeName/AttributeValue SYS004 Invalid parameter value for AttributeName/AttributeValue SYS005 AttributeName and AttributeValue count mismatch SYS006 Cannot set ReadOnly AttributeName AttributeName SYS007 Input out of range for AttributeName
471 472 Invoking the SetAttributes( ) method multiple times can result in the earlier requests being overwritten or lost. 473 Table 24 – SetAttributes( ) Method: Return Code Values Value Description 0 Completed with no error 2 Failed 474 Table 25 – SetAttributes( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ Target String Shall be set to “System.Embedded.
MessageID (OUT parameter) Message MessageArguments[] SYS007 Input out of range for AttributeName SYS008 Invalid boolean in AttributeValue for AttributeName AttributeName SYS009 String exceeds maximum length for AttributeName AttributeName SYS010 Invalid character in AttributeValue for AttributeName AttributeName SYS011 Configuration already committed, cannot set configuration SYS012 User is not Authorized to perform this operation SYS013 In
497 498 Return code values for the CreateTargetedConfigJob( ) method are specified in Table 24, and parameters are specified in Table 25. 499 500 Subsequent calls to CreateTargetedConfigJob after the first CreateTargetedConfigJob will result in error until the first job is completed.
MessageID (OUT parameter) Message MessageArguments[] SYS007 Input out of range for AttributeName SYS008 Invalid boolean in AttributeValue for AttributeName AttributeName SYS009 String exceeds maximum length for AttributeName AttributeName SYS010 Invalid character in AttributeValue for AttributeName AttributeName SYS011 Configuration already committed, cannot set configuration SYS012 User is not Authorized to perform this operation SYS013 In
Qualifiers Name Type Description/Values 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.
521 522 Return code values for the DeletePendingConfiguration( ) method are specified in Table 33, and parameters are specified in Table 34. 523 Table 33 – ShowErrorsOnLCD( ) Method: Return Code Values Value Description 0 Completed with no error 2 Failed 524 Table 34 – ShowErrorsOnLCD( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ Show Boolean The parameter shall have TRUE value to show the errors on the platform LCD, or FALSE to hide errors on the platform LCD.
534 Table 36 – IdentifyChassis( ) Method: Return Code Values Value Description 0 Completed with no error 2 Failed 535 Table 37 – IdentifyChassis( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ IdentifyState Uint8 The parameter shall represent the desired state of the LED on the platform to identify it: • • • IN DurationLimit Uint8 0 - "Disabled" (LED is off) 1 - "Enabled" (LED is on) 2 - "Time Limited Enabled" (LED is on for a limited time) The parameter shall be sp
541 10 542 No additional details specified. 543 11 544 545 546 The following table describes the privilege and license requirements for the listed operations. . For the detailed explanation of the privileges and licenses, refer to the Dell WSMAN Licenses and Privileges specification. CIM Elements Privilege and License Requirement 547 Table 39 – Privilege and License Requirements Class and Method Instance (GroupID.
Class and Method DCIM_SystemManagement Service. SetAttribute() DCIM_SystemManagement Service. SetAttributes() DCIM_SystemManagement Service. SetAttribute() DCIM_SystemManagement Service. SetAttributes() DCIM_SystemManagement Service. SetAttribute() DCIM_SystemManagement Service. SetAttributes() DCIM_SystemManagement Service. SetAttribute() DCIM_SystemManagement Service. SetAttributes() DCIM_SystemManagement Service. CreateTargetedConfigJob() DCIM_SystemManagement Service.
