White Papers

ManualsBrandsDell ManualsConverged InfrastructureEnterprise Solution Resources

Dell® BIOS and Boot

Management Profile

Document Number: DCIM1040

Document Type: Specification

Document Status: Published

Document Language: E

Date: 2011-03-22

Version: 1.1.0

Summary of content (42 pages)

PAGE 1
Dell® BIOS and Boot Management Profile Document Number: DCIM1040 Document Type: Specification Document Status: Published Document Language: E Date: 2011-03-22 Version: 1.1.
PAGE 2
THIS PROFILE IS FOR INFORMATIONAL PURPOSES ONLY, AND MAY CONTAIN TYPOGRAPHICAL ERRORS AND TECHBIOSAL 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. © 2010 Dell Inc. All rights reserved.
PAGE 3
CONTENTS 1 2 Scope .................................................................................................................................................... 5 Normative References ........................................................................................................................... 5 2.1 Approved References ................................................................................................................. 5 2.2 Other References .................................
PAGE 4
Figures Figure 1 – BIOS and Boot Management Profile: Class Diagram – BIOS Management ............................... 9 Figure 2 – BIOS and Boot Management Profile: Boot Management .......................................................... 10 Tables Table 1 – Related Profiles ............................................................................................................................. 8 Table 2 – CIM Elements: BIOS and Boot Management Profile ..................................................
PAGE 5
BIOS and Boot Management Profile 1 2 1 Scope 3 4 5 6 The BIOS and Boot Management Profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration of the system BIOS setup and to manage the boot of the system. The system BIOS setup is modeled with multiple attributes that allow configuration of the BIOS. 7 2 Normative References 8 9 10 The following referenced documents are indispensable for the application of this document.
PAGE 6
29 30 31 3.1 32 33 34 3.2 35 36 37 38 3.3 39 40 41 42 3.4 43 44 45 3.5 46 47 48 3.6 49 50 51 3.7 52 53 54 55 3.8 56 57 58 59 3.9 60 61 62 63 3.10 64 65 66 67 3.11 68 69 70 3.
PAGE 7
1 72 73 74 3.13 ENUMERATE 75 76 77 78 3.14 GET Refers to WS-MAN ENUMERATE operation as described in Section 8.2 of DSP0226_V1.1 and Section 9.1 of DSP0227_V1.0 Refers to WS-MAN GET operation as defined in Section 7.3 of DSP00226_V1.1 and Section 7.1 of DSP0227_V1.0 79 80 4 81 82 83 4.1 84 85 86 4.2 87 88 89 4.3 90 91 92 93 4.4 94 95 96 4.
PAGE 8
110 111 112 CIM_ComputerSystem shall be the Scoping Class. The instance of DCIM_BIOSService shall be the Central Instance. The instance of CIM_ComputerSystem with which the Central Instance is associated through the CIM_HostedService association shall be the Scoping Instance. 113 Table 1 identifies profiles that are related to this profile. Table 1 – Related Profiles 114 Profile Name Organization Version Relationship Profile Registration Profile DMTF 1.
PAGE 9
RegisteredProfile RegisteredProfile ComputerSystem RegisteredProfile = “Base Server” OwningEntity = “DMTF” 1 RegisteredProfile = “BIOS Management” OwningEntity = “DCIM” 1 ElementConformsToProfile 1 1 HostedService ElementConformsToProfile 1 DCIM_BIOSService 1 CIM_BIOSAttribute CIM_BIOSEnumeration CIM_BIOSInteger CIM_BIOSString DCIM_BIOSEnumeration DCIM_BIOSInteger DCIM_BIOSString 130 131 Figure 1 – BIOS and Boot Management Profile: Class Diagram – BIOS Management Version 1.1.
PAGE 10
132 133 Figure 2 represents the class schema for the the boot management feature of the BIOS and Boot Management Profile. For simplicity, the prefix CIM_ has been removed from the names of the classes. 134 135 136 137 138 Each boot list is represented by a DCIM_BootConfigSetting instance. Each of the boot lists contains the boot devices/sources represented by DCIM_BootSourceSetting, shown underneath their corresponding boot lists in the figure below.
PAGE 11
142 7 Implementation Requirements 143 144 145 146 Requirements and guidelines for propagating and formulating certain properties of the classes are discussed in this section. Methods are listed in section 8. Table 2 shows the instances of CIM Elements for this profile. Instances of the CIM Elements shall be implemented as described in Table 2. Sections 7 (“Implementation Requirements” and “Methods”) may impose additional requirements on these elements.
PAGE 12
WBEM URIs for WinRM ® 154 7.1.1.1 155 156 The class WBEM URI shall be “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_BIOSEnumeration?__cimnamespace=” 157 The key property shall be the InstanceID. 158 159 160 161 The instance WBEM URI for DCIM_BIOSEnumeration instance shall be: “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_BIOSEnumeration?__cimnamespace=+InstanceID= BIOS.Setup.1-1:” 162 7.1.1.
PAGE 13
Table 4 – Class: DCIM_BIOSEnumeration 173 Properties Notes Additional Requirements InstanceID Mandatory The property value shall be formed as follows: “BIOS.Setup.1-1:”. AttributeName Mandatory The property value shall be from the “AttributeName” column in Table 5 CurrentValue Mandatory The property value shall be one of the values in the “PossibleValues” column at the corresponding row in Table 5.
PAGE 14
MemVolt MemLowPower System Memory Voltage FALSE AutoVolt, Volt15V, Volt13V Memory Low Power Mode FALSE Enabled, Disabled Each processor core supports up to two logical processors. When this field is set to Enabled (the default), the BIOS reports all logical processors. When set to Disabled, the BIOS only reports one logical processor per core. FALSE Enabled, Disabled LogicalProc NOTE: This attribute does not affect the DCIM_CPUView.
PAGE 15
Training on Software Prefetch FALSE Enabled, Disabled ProcTurboMode When set to Enabled, the processor can operate in Turbo Mode ProcC1E C1E FALSE Enabled, Disabled FALSE Enabled, Disabled ProcCStates When set to Enabled, the processor can operate in all available Power States FALSE AtaMode, Off EmbSata Allows the Embedded SATA to be set to Off or ATA Mode FALSE Off, Auto SataPortA Select Auto to enable BIOS support for the device FALSE Off, Auto SataPortB Select Auto to enable BIOS s
PAGE 16
User Accessible USB Ports FALSE AllOn, OnlyBackPortsOn, AllOff UsbPorts InternalUsb Internal USB Port FALSE On, Off InternalUsb1 Internal USB Port FALSE On, Off InternalUsb2 Internal USB Port FALSE On, Off InternalSdCard Internal SD Card Port Feature 1 Dependant On, Off InternalSdCardRedundancy Internal SD Card Redundancy Attribute Value 3 Dependant Mirror, Disabled EmbNic1Nic2 Embedded NIC1 and NIC2 FALSE Enabled, DisabledOs Embedded Gb NIC1 FALSE Enabled, EnabledPxe, EnablediS
PAGE 17
FailSafeBaud Failsafe Baud Rate FALSE 115200, 57600, 19200, 9600 ConTermType Remote Terminal Type FALSE Vt100Vt220, Ansi RedirAfterBoot Redirection After Boot FALSE Enabled, Disabled Front-Panel LCD Options FALSE None, UserDefined, ModelNum, Advanced Power Management FALSE OsCtrl, ActivePwrCtrl, Custom, MaxPerf ProcPwrPerf CPU Power and Performance Management Attribute Value 4,5 Dependant SysDbpm, MaxPerf, MinPwr, OsDbpm Fan Power and Performance Management Attribute Value 4,6 Dependa
PAGE 18
front panel. FALSE Enabled, Disabled NmiButton This field enables/disables the NMI button on the front panel. FALSE Last, On, Off AcPwrRcvry AC Power Recovery, this field specifies how the system will react after AC power has been restored to the system. It is especially useful for people who turn their systems off with a power strip. When set to Off, the system will stay off after AC is restored. When set to On, the system will turn on after AC is restored.
PAGE 19
 192 “MaxPerf” if PowerMgmt is set to “MaxPerf” 193 NOTE: 6 – The FanPwrPerf shall have value “MinPwr” if PowerMgmt is set to “OsCtrl” or “ActivePwrCtrl”. 194 NOTE: 7 – The MemPwrPerf shall have value “MinPwr” if PowerMgmt is not set to “Custom”. 195 196 NOTE: 8 – The TpmActivation, TpmClear attributes are settable (IsReadOnly=FALSE), if the TpmSecurity attribute is NOT set to “Off”; otherwise those attributes are read-only (IsReadOnly=TRUE).
PAGE 20
Table 7 – Class: DCIM_BIOSString 226 Properties Notes Additional Requirements InstanceID Mandatory The property value shall be formed as follows: BIOS.Setup.1-1:”. AttributeName Mandatory The property value shall be from the “AttributeName” column in Table 8. CurrentValue Mandatory The property value shall match the format described in “Value Expression” column at the corresponding row in Table 8.
PAGE 21
245 246 schema/2/DCIM_BIOSInteger?__cimnamespace=+InstanceID= BIOS.Setup.1-1:AttributeName (AttributeName comes from Table 5)” 247 7.1.3.2 248 The following table details the implemented operations on DCIM_BIOSInteger. Operations Table 9 – DCIM_BIOSInteger - Operations 249 Operation Name Get Enumerate DCIM_BIOSService.SetAttribute() DCIM_BIOSService.SetAttributes() Requirements Mandatory Mandatory Mandatory Mandatory Required Input Instance URI Class URI See section 8.
PAGE 22
Table 11 – DCIM_BIOSInteger Attributes 264 AttributeName AcPwrRcvryUserDelay Attribute Description AC Power Recovery User Defined Delay IsReadOnly LowerBound UpperBound TRUE 30 240 265 266 22 Version 1.1.
PAGE 23
267 7.2 Boot Management 268 269 270 Each of DCIM_BootConfigSetting instances shall represent a boot list, and each boot list can be enabled to be used in the next boot using the algorithm in “Boot State Enablement” column. The following boot lists shall be implemented: 271 Table 12 – Boot Lists Boot Lists IPL/BIOS DCIM_BootCon figSetting.
PAGE 24
284 285  The IsNext property set to 1(Is Next) shall represents that the boot list is configured to be used for the next boot. vFlash boot list shall not have this value. 286 287 288  The IsNext property set to 3(Is Next for Single Use) shall represent that the boot list is configured to be used ONLY for the next boot. Only the OneTime boot list may have this value for the IsNext property.
PAGE 25
316 Table 14 – Class: DCIM_BootConfigSetting 317 Properties and Methods Requirement Description InstanceID Mandatory The property value shall be from Table 12 ElementName Mandatory IsCurrent Mandatory “DCIM_BootConfigSetting.InstanceID” column.
PAGE 26
333 334 7.2.2.3 335 336 337 338 339 The following table details the implemented properties for DCIM_BootSourceSetting. The “Requirements” column shall denote the implementation requirement for the corresponding property. If the column “Property Name” matches the property name, the property either shall have the value denoted in the corresponding column “Additional Requirement”, or shall be implemented according to the requirements in the corresponding column “Additional Requirement”.
PAGE 27
Table 16 – Class: DCIM_BootSourceSetting 340 Properties and Methods Requirement Description InstanceID Mandatory The property value shall have prefix from Table 12 “DCIM_BootSourceSetting.InstanceID” column followed by a unique id representing the boot source. For example: UEFI:Disk.USBFront.21:3156051d1529b8f4f88c99f54b895350 (boot source belongs to UEFI bootlist) IPL:NIC.Slot.42:d0f2c6c736adb8c2238153293a0c026c (boot source belongs to IPL bootlist) BCV:RAID.Integrated.
PAGE 28
343 344 This section describes the implementation for the DCIM_BIOSService class that represents the BIOS and boot management service. 345 This class shall be instantiated in the Implementation Namespace. 346 347 The DCIM_LCElementConformsToProfile association(s) shall reference the DCIM_BIOSService instance(s). 348 7.3.1.1 349 350 The class WBEM URI shall be “http://schemas.dell.
PAGE 29
367 Table 18 – Class: DCIM_BIOSService 368 Properties and Methods Requirement Description SystemCreationClassName Mandatory The property value shall be “DCIM_ComputerSystem”. CreationClassName Mandatory The property value shall be “DCIM_BIOSService”. SystemName Mandatory The property value shall be “DCIM:ComputerSystem”. Name Mandatory The property value shall be “DCIM:BIOSService” ElementName Mandatory The property value shall be “BIOS Service” 369 7.4 Profile Registration 370 7.4.
PAGE 30
386 7.4.1.3 Properties 387 388 389 390 391 392 The following table details the implemented properties for DCIM_LCRegisteredProfile instance representing BIOS and Boot Management Profile implementation. The “Requirements” column shall denote the implementation requirement for the corresponding property.
PAGE 31
396 8 Methods 397 398 This section details the requirements for supporting intrinsic operations and extrinsic methods for the CIM elements defined by this profile. 399 8.1 400 The SetAttribute( ) method is used to set or change the value of a BIOS attribute.
PAGE 32
412 8.2 DCIM_BIOSService.SetAttributes( ) 413 The SetAttributes( ) method is used to set or change the values of a group of attributes. 414 415 416 417 418 Invocation of the SetAttributes( ) method shall change the values of the attribute’s CurrentValue or PendingValue properties that correspond to the names specified by the AttributeName parameter and the values specified by the AttributeValue parameter if the respective attribute’s IsReadOnly property is FALSE.
PAGE 33
430 431 432 1. RebootJobType: when provided in the input parameters, creates a specific reboot job to “PowerCycle” or “Graceful Reboot without forced shutdown” or “Graceful Reboot with forced shutdown”. This parameter only creates the RebootJob and does not schedule it. 433 434 435 2. ScheduledStartTime: When provided in the input parameters, schedules the “configuration job” and the 436 437 438 3.
PAGE 34
450 451 8.4 DCIM_BIOSService.DeletePendingConfiguration( ) 452 453 454 455 456 457 The DeletePendingConfiguration( ) method is used to cancel the pending values created by the SetAttribute and SetAttributes methods. The DeletePendingConfiguration( ) method cancels the pending configuration changes made before the configuration job is created with CreateTargetedConfigJob(). This method only operates on the pending changes prior to CreateTargetedConfigJob() being called.
PAGE 35
Qualifiers Name Type Description/Values IN, REQ PasswordType Uint16 Password Type. 1 – System Password 2Setup Password IN, REQ OldPassword string Old Password null or string IN, REQ NewPassword string New Password null or string OUT MessageID String Error MessageID OUT Message String Error Message OUT MessageArguments[] String Error MessageArguments 470 471 472 8.6 DCIM_BootConfigSetting.
PAGE 36
487 8.7 DCIM_BootConfigSetting.ChangeBootOrderByInstanceID( ) 488 489 The ChangeBootOrderByInstanceID( ) method is used to change the order of boot devices within the boot list. 490 491 492 The successful invocation of the ChangeBootOrderByInstanceID( ) method shall order the boot devices in the list in accordance to the corresponding array element in the “source” parameter array. The omitted boot devices in the “source” parameter array shall be omitted in the boot list ordering.
PAGE 37
® 513 Note that URIs in this section are in form of WBEM URIs for WinRM . 514 9.1 515 Use one of the two procedures below to confirm the existence of BIOS and Boot profile support Discovery of BIOS and Boot profile support A) 516 GET the DCIM_LCRegisteredProfile instance using an InstanceID of DCIM:BIOSandBootManagement:1.0.0. See section 3.14 for a definition of GET. 517 518 Instance URI: 519 520 521 522 http://schemas.dmtf.
PAGE 38
549 9.3 Get the first BIOS attribute’s information 550 551 The URI for getting particular instance information is deterministic (i.e the InstanceID will be unique for each instance) 552 For the first BIOS attribute in the system, the instance URI will be: 553 554 555 http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_BIOSEnumeration?__cimnamespace=root/dcim+InstanceID=BIOS.Setup.
PAGE 39
586 9.6 Delete pending values 587 588 A) 589 B) To invoke the DeletePendingConfiguration( ) method, construct input parameters per Table 28 and use the BIOS FQDD from section 9.2 INVOKE DeletePendingConfiguration( ) method 590 Class URI: 591 592 593 594 http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_BIOSService?SystemCreationClassName=DCIM_ComputerS ystem+CreationClassName=DCIM_BIOSService+SystemName=DCIM:ComputerSystem +Name=DCIM:BIOSService C) 595 596 9.
PAGE 40
621 622 623 B) ENUMERATE the DCIM_BootSourceSetting class as shown in 9.9 and identify the boot source InstanceID. The CurrentAssignedSequence attribute of each instance defines the instance’s place in the zero based indexed boot sequence 624 625 626 C) To invoke the ChangeBootOrderByInstanceID() method, extract the instance information from A) and B) and construct the input parameters per Table 32Error! Reference source not found.
PAGE 41
656 657 658 B) 659 C) To invoke the ChangeBootOrderByInstanceID() method, extract the instance information from A) and construct the input parameters per Table 32; providing an xml with one and only one DCIM_BootSourceSetting InstanceIDError! Reference source not found. INVOKE ChangeBootOrderByInstanceID() method 660 Class URI: 661 662 http://schemas.dmtf.
PAGE 42
ANNEX A (informative) 670 671 672 Related MOF Files 673 674 Dell Tech Center MOF Library: 675 http://www.delltechcenter.com/page/DCIM.Library.MOF 676 677 Related Managed Object Format (MOF) files: 678 DCIM_BootConfigSetting.mof 679 DCIM_BootSourceSetting.mof 680 DCIM_BIOSEnumeration.mof 681 DCIM_BIOSInteger.mof 682 DCIM_BIOSService.mof 683 DCIM_BIOSString.mof 684 DCIM_LCElementConformsToProfile 685 DCIM_LCRegisteredProfile 686 42 Version 1.1.