Dell Enterprise Solution Resources Owner's manual

Brand: Dell

Model: Enterprise Solution Resources

Type: Owner's manual

This manual is also suitable for

Systems Management 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

2 Version 1.1.0

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.

permission of Dell, Inc. is strictly forbidden. For more information, contact Dell.

Dell and the DELL logo are trademarks of Dell Inc. Microsoft and WinRM are either trademarks or

registered trademarks of Microsoft Corporation in the United States and/or other countries. Other

trademarks and trade names may be used in this document to refer to either the entities claiming the

marks and names or their products. Dell disclaims proprietary interest in the marks and names of others.

Version 1.1.0 3

CONTENTS

1 Scope .................................................................................................................................................... 5

2 Normative References ........................................................................................................................... 5

2.1 Approved References ................................................................................................................. 5

2.2 Other References ........................................................................................................................ 5

3 Terms and Definitions ........................................................................................................................... 5

4 Symbols and Abbreviated Terms .......................................................................................................... 7

5 Synopsis ................................................................................................................................................ 7

6 Description ............................................................................................................................................ 8

7 Implementation Requirements ............................................................................................................ 11

7.1 BIOS Management ................................................................................................................... 11

7.2 Boot Management ..................................................................................................................... 23

7.3 Service for Method Invocations ................................................................................................ 27

7.4 Profile Registration .................................................................................................................... 29

8 Methods ............................................................................................................................................... 31

8.1 CIM_BIOSService.SetAttribute() .............................................................................................. 31

8.2 DCIM_BIOSService.SetAttributes() ......................................................................................... 32

8.3 DCIM_BIOSService.CreateTargetedConfigJob() .................................................................... 32

8.4 DCIM_BIOSService.DeletePendingConfiguration() ................................................................. 34

8.5 DCIM_BIOSService.ChangePassword() .................................................................................. 34

8.6 DCIM_BootConfigSetting.ChangeBootSourceState() .............................................................. 35

8.7 DCIM_BootConfigSetting.ChangeBootOrderByInstanceID() ................................................... 36

9 Use Cases ........................................................................................................................................... 36

9.1 Discovery of BIOS and Boot profile support ............................................................................. 37

9.2 Inventory of BIOS attributes in system ..................................................................................... 37

9.3 Get the first BIOS attribute’s information .................................................................................. 38

9.4 Setting BIOS attributes ............................................................................................................. 38

9.5 Apply pending values ................................................................................................................ 38

9.6 Delete pending values .............................................................................................................. 39

9.7 Inventory of boot configurations in system ............................................................................... 39

9.8 Get the first boot configuration’s information ............................................................................ 39

9.9 Inventory of boot sources in system ......................................................................................... 39

9.10 Changing boot order by instance .............................................................................................. 39

9.11 Enable or disable boot source .................................................................................................. 40

9.12 One time boot ........................................................................................................................... 40

ANNEX A (informative) Related MOF Files ............................................................................................... 42

4 Version 1.1.0

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 .................................................................. 11

Table 3 – DCIM_BIOSEnumeration - Operations ....................................................................................... 12

Table 4 – Class: DCIM_BIOSEnumeration ................................................................................................. 13

Table 5 – DCIM_BIOSEnumeration Attributes ............................................................................................ 13

Table 6 – DCIM_BIOSString - Operations .................................................................................................. 19

Table 7 – Class: DCIM_BIOSString ............................................................................................................ 20

Table 8 – DCIM_BIOSString Attributes ....................................................................................................... 20

Table 9 – DCIM_BIOSInteger - Operations ................................................................................................ 21

Table 10 – Class: DCIM_BIOSInteger ........................................................................................................ 21

Table 11 – DCIM_BIOSInteger Attributes ................................................................................................... 22

Table 12 – Boot Lists .................................................................................................................................. 23

Table 13 – DCIM_BootConfigSetting – Operations .................................................................................... 24

Table 14 – Class: DCIM_BootConfigSetting ............................................................................................... 25

Table 15 – DCIM_BootSourceSetting – Operations ................................................................................... 25

Table 16 – Class: DCIM_BootSourceSetting .............................................................................................. 27

Table 17 – DCIM_BIOSService – Operations............................................................................................. 28

Table 18 – Class: DCIM_BIOSService ....................................................................................................... 29

Table 19 – DCIM_LCRegisteredProfile - Operations .................................................................................. 29

Table 20 – Class: CIM_RegisteredProfile ................................................................................................... 30

Table 21 – SetAttribute() Method: Return Code Values ............................................................................. 31

Table 22 – SetAttribute() Method: Parameters ........................................................................................... 31

Table 23 – SetAttributes() Method: Return Code Values ........................................................................... 32

Table 24 – SetAttributes() Method: Parameters ......................................................................................... 32

Table 25 – CreateTargetedConfigJob() Method: Return Code Values ...................................................... 33

Table 26 – CreateTargetedConfigJob() Method: Parameters .................................................................... 33

Table 27 – DeletePendingConfiguration() Method: Return Code Values .................................................. 34

Table 28 – DeletePendingConfiguration() Method: Parameters ................................................................ 34

Table 33 – ChangePassword() Method: Return Code Values ................................................................... 34

Table 34 – ChangePassword() Method: Parameters ................................................................................. 34

Table 29 – ChangeBootSourceState() Method: Return Code Values ........................................................ 35

Table 30 – ChangeBootSourceState() Method: Parameters ..................................................................... 35

Table 31 – ChangeBootOrderByInstanceID() Method: Return Code Values ............................................. 36

Table 32 – ChangeBootOrderByInstanceID() Method: Parameters ........................................................... 36

Version 1.1.0 5

BIOS and Boot Management Profile 1

1 Scope 2

The BIOS and Boot Management Profile extends the management capabilities of referencing profiles by 3

adding the capability to represent the configuration of the system BIOS setup and to manage the boot of 4

the system. The system BIOS setup is modeled with multiple attributes that allow configuration of the 5

BIOS. 6

2 Normative References 7

The following referenced documents are indispensable for the application of this document. For dated 8

references, only the edition cited applies. For undated references, the latest edition of the referenced 9

document (including any amendments) applies. 10

2.1 Approved References 11

DMTF DSP1033, Profile Registration Profile 1.0.0 12

DMTF DSP1061, Management Profile 1.0.0 13

DMTF DSP0200, CIM Operations over HTTP 1.2.0 14

DMTF DSP0004, CIM Infrastructure Specification 2.3.0 15

DMTF DSP1000, Management Profile Specification Template 16

DMTF DSP1001, Management Profile Specification Usage Guide 17

DMTF DSP0226, Web Services for Management (WS-Management) Specification 1.1.0 18

DMTF DSP0227, WS-Management CIM Binding Specification 1.0.0 19

2.2 Other References 20

ISO/IEC Directives, Part 2, Rules for the structure and drafting of International Standards, 21

http://isotc.iso.org/livelink/livelink.exe?func=ll&objId=4230456&objAction=browse&sort=subtype 22

Unified Modeling Language (UML) from the Open Management Group (OMG), http://www.uml.org 23

BIOS Boot Specification v1.01 (January 11, 1996), http://www.phoenix.com/NR/rdonlyres/56E38DE2-24

3E6F-4743-835F-B4A53726ABED/0/specsbbs101.pdf 25

3 Terms and Definitions 27

For the purposes of this document, the following terms and definitions apply. 28

6 Version 1.1.0

3.1 29

can 30

used for statements of possibility and capability, whether material, physical, or causal 31

3.2 32

cannot 33

used for statements of possibility and capability, whether material, physical, or causal 34

3.3 35

conditional 36

indicates requirements to be followed strictly in order to conform to the document when the specified 37

conditions are met 38

3.4 39

mandatory 40

indicates requirements to be followed strictly in order to conform to the document and from which no 41

deviation is permitted 42

3.5 43

may 44

indicates a course of action permissible within the limits of the document 45

3.6 46

need not 47

indicates a course of action permissible within the limits of the document 48

3.7 49

optional 50

indicates a course of action permissible within the limits of the document 51

3.8 52

referencing profile 53

indicates a profile that owns the definition of this class and can include a reference to this profile in its 54

“Related Profiles” table 55

3.9 56

shall 57

indicates requirements to be followed strictly in order to conform to the document and from which no 58

deviation is permitted 59

3.10 60

shall not 61

indicates requirements to be followed strictly in order to conform to the document and from which no 62

deviation is permitted 63

3.11 64

should 65

indicates that among several possibilities, one is recommended as particularly suitable, without 66

mentioning or excluding others, or that a certain course of action is preferred but not necessarily required 67

3.12 68

should not 69

indicates that a certain possibility or course of action is deprecated but not prohibited 70

Version 1.1.0 7

3.13 71

ENUMERATE 72

Refers to WS-MAN ENUMERATE operation as described in Section 8.2 of DSP0226_V1.1 and Section 73

9.1 of DSP0227_V1.0 74

3.14 75

GET 76

Refers to WS-MAN GET operation as defined in Section 7.3 of DSP00226_V1.1 and Section 7.1 of 77

DSP0227_V1.0 78

4 Symbols and Abbreviated Terms 80

4.1 81

CIM 82

Common Information Model 83

4.2 84

iDRAC 85

integrated Dell Remote Access Controller – management controller for blades and monolithic servers 86

4.3 87

CMC 88

Chassis Manager Controller – management controller for the modular chassis 89

4.4 90

iSCSI 91

Internet Small Computer System Interface, an Internet Protocol (IP)-based storage networking standard 92

for linking data storage facilities. 93

4.5 94

WBEM 95

Web-Based Enterprise Management 96

5 Synopsis 98

Profile Name: BIOS and Boot Management 99

Version: 1.0.0 100

Organization: Dell Inc. 101

CIM Schema Version: 2.19.1 102

Central Class: DCIM_BIOSService 103

Scoping Class: CIM_ComputerSystem 104

The BIOS and Boot Management Profile extends the management capability of the referencing profiles 105

by adding the capability to describe BIOS attributes, each BIOS configuration item is represented by an 106

instance one of these classes DCIM_BIOSEnumeration, DCIMBIOSString, DCIM_BIOSInteger and boot 107

management where each boot list is represented by DCIM_BootConfigSetting and each boot source 108

device by DCIM_BootSourceSetting. DCIM_BIOSService shall be the Central Class. 109

8 Version 1.1.0

CIM_ComputerSystem shall be the Scoping Class. The instance of DCIM_BIOSService shall be the 110

Central Instance. The instance of CIM_ComputerSystem with which the Central Instance is associated 111

through the CIM_HostedService association shall be the Scoping Instance. 112

Table 1 identifies profiles that are related to this profile. 113

Table 1 – Related Profiles 114

Profile Name

Organization

Version

Relationship

Profile Registration Profile

DMTF

1.0

Mandatory

6 Description 115

The BIOS and Boot Management Profile describes BIOS setup configuration including boot management. 116

The profile also describes the relationship of the BIOS classes to the DMTF/Dell profile version 117

information. 118

Figure 1 represents the class schema for the BIOS attribute management feature of BIOS and Boot 119

Management Profile. For simplicity, the prefix CIM_ has been removed from the names of the classes. 120

Each BIOS’s configurable attribute is represented by one of the classes (DCIM_BIOSEnumeration, 121

DCIM_BIOSString, DCIM_BIOSInteger)CIM_BIOSAttribute. Depending on the dataype of the attribute the 122

BIOS configuration attribute is either instantiaed as DCIM_BIOSEnumeration, DCIM_BIOSString, or 123

DCIM_BIOSInteger instance. 124

The DCIM_BIOSService class is used to configure the BIOS attributes. The SetAttribute() and 125

SetAttributes() methods on the DCIM_BIOSService class configure BIOS attributes, DCIM_BIOSAttribute 126

subclass instances. 127

The BIOS and Boot Management Profile information is represented with the instance of 128

CIM_RegisteredProfile. 129

Version 1.1.0 9

130

Figure 1 – BIOS and Boot Management Profile: Class Diagram – BIOS Management 131

ComputerSystem

RegisteredProfile

RegisteredProfile = “BIOS Management”

OwningEntity = “DCIM”

ElementConformsToProfile

DCIM_BIOSService

HostedService

CIM_BIOSAttribute

RegisteredProfile

RegisteredProfile = “Base Server”

OwningEntity = “DMTF”

ElementConformsToProfile

CIM_BIOSEnumeration CIM_BIOSStringCIM_BIOSInteger

1 1

DCIM_BIOSEnumeration

DCIM_BIOSStringDCIM_BIOSInteger

10 Version 1.1.0

Figure 2 represents the class schema for the the boot management feature of the BIOS and Boot 132

Management Profile. For simplicity, the prefix CIM_ has been removed from the names of the classes. 133

Each boot list is represented by a DCIM_BootConfigSetting instance. Each of the boot lists contains the 134

boot devices/sources represented by DCIM_BootSourceSetting, shown underneath their corresponding 135

boot lists in the figure below. Note that the InstanceID property value prefix of the 136

DCIM_BootSourceSetting instance matches the InstanceID of the DCIM_BootConfigSetting. Also note 137

that IPL boot list contains a BCV boot list. 138

139

Figure 2 – BIOS and Boot Management Profile: Boot Management 140

141

ComputerSystem

RegisteredProfile

RegisteredProfile = “BIOS Management”

OwningEntity = “DCIM”

ElementConformsToProfile

DCIM_BIOSService

HostedService

RegisteredProfile

RegisteredProfile = “Base Server”

OwningEntity = “DMTF”

ElementConformsToProfile

1 1

DCIM_BootConfigSetting

InstanceID: OneTime

DCIM_BootConfigSetting

InstanceID:vFlash

DCIM_BootConfigSetting

InstanceID: UEFI

DCIM_BootConfigSetting

InstanceID: BCV

DCIM_BIOSEnumeration

InstanceID = BIOS.Setup.1-1:BootMode

DCIM_BootConfigSetting

InstanceID: IPL

DCIM_BootSourceSetting

InstanceID: IPL:HardDisk...

DCIM_BootSourceSetting

InstanceID: IPL:...

DCIM_BootSourceSetting

InstanceID: BCV:...

DCIM_BootSourceSetting

InstanceID: UEFI:...

DCIM_BootSourceSetting

InstanceID: vFlash:...

...

Version 1.1.0 11

7 Implementation Requirements 142

Requirements and guidelines for propagating and formulating certain properties of the classes are 143

discussed in this section. Methods are listed in section 8. Table 2 shows the instances of CIM Elements 144

for this profile. Instances of the CIM Elements shall be implemented as described in Table 2. Sections 7 145

(“Implementation Requirements” and “Methods”) may impose additional requirements on these elements. 146

Table 2 – CIM Elements: BIOS and Boot Management Profile 147

Element Name

Requirement

Description

Classes

DCIM_BIOSService

Mandatory