Dell Enterprise Solution Resources Owner's manual

Dell
Brand
Dell
Model
Enterprise Solution Resources
Type
Owner's manual

This manual is also suitable for

Operating System (OS) 1
Deployment 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
Document Number: DCIM1035
Document Type: Specification
Document Status: Published
Document Language: E
Date: 2012-03-08
Version: 1.4.0
2 Version 1.4.0
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
THIS PROFILE IS FOR INFORMATIONAL PURPOSES ONLY, AND MAY CONTAIN TYPOGRAPHICAL 52
ERRORS AND TECHNICAL INACCURACIES. THE CONTENT IS PROVIDED AS IS, WITHOUT 53
EXPRESS OR IMPLIED WARRANTIES OF ANY KIND. ABSENT A SEPARATE AGREEMENT 54
BETWEEN YOU AND DELL™ WITH REGARD TO FEEDBACK TO DELL ON THIS PROFILE 55
SPECIFICATION, YOU AGREE ANY FEEDBACK YOU PROVIDE TO DELL REGARDING THIS 56
PROFILE SPECIFICATION WILL BE OWNED AND CAN BE FREELY USED BY DELL. 57
58
© 2008 – 2012 Dell Inc. All rights reserved. Reproduction in any manner whatsoever without the express 59
written permission of Dell, Inc. is strictly forbidden. For more information, contact Dell. 60
61
Dell and the DELL logo are trademarks of Dell Inc. Other trademarks and trade names may be used in 62
this document to refer to either the entities claiming the marks and names or their products. Dell 63
disclaims proprietary interest in the marks and names of others. 64
65
66
Version 1.4.0 3
CONTENTS 67
1 Scope .................................................................................................................................................... 7 68
2 Normative References ........................................................................................................................... 7 69
3 Terms and Definitions ........................................................................................................................... 8 70
4 Symbols and Abbreviated Terms .......................................................................................................... 9 71
5 Synopsis ................................................................................................................................................ 9 72
6 Description .......................................................................................................................................... 10 73
7 Implementation Requirements ............................................................................................................ 12 74
7.1 DCIM_OSDeploymentService .................................................................................................. 12 75
7.2 DCIM_OSDConcreteJob .......................................................................................................... 13 76
7.3 Operating System (OS) Deployment Profile Registration – DCIM_LCRegistered Profile ........ 15 77
8 Methods ............................................................................................................................................... 17 78
8.1 DCIM_OSDeploymentService.GetDriverPackInfo() ................................................................. 17 79
8.2 DCIM_OSDeploymentService.UnpackAndAttach() .................................................................. 18 80
8.3 DCIM_OSDeploymentService.DetachDrivers() ........................................................................ 20 81
8.4 DCIM_OSDeploymentService.UnpackAndShare() .................................................................. 20 82
8.5 DCIM_OSDeploymentService.BootToNetworkISO() ................................................................ 22 83
8.6 DCIM_OSDeploymentService.DetachISOImage() ................................................................... 24 84
8.7 DCIM_OSDeploymentService.BootToPXE() ............................................................................ 25 85
8.8 Method: DCIM_OSDeploymentService.BootToHD() ................................................................ 26 86
8.9 DCIM_OSDeploymentService.DownloadISOToVFlash() ......................................................... 27 87
8.10 DCIM_OSDeploymentService.BootToISOFromVFlash() ......................................................... 29 88
8.11 DCIM_OSDeploymentService.DetachISOFromVFlash() ......................................................... 30 89
8.12 DCIM_OSDeploymentService.DeleteISOFromVFlash() .......................................................... 31
90
8.13 DCIM_OSDeploymentService.ConnectNetworkISOImage() .................................................... 32 91
8.14 DCIM_OSDeploymentService.DisconnectNetworkISOImage() ............................................... 34 92
8.15 DCIM_OSDeploymentService.GetNetworkISOImageConnectionInfo() ................................... 34
93
8.16 DCIM_OSDeploymentService.SkipISOImageBoot() ................................................................ 35 94
8.17 DCIM_OSDeploymentService.DisconnectRFSISOImage() ..................................................... 36 95
8.18 DCIM_OSDeploymentService.ConnectRFSISOImage() .......................................................... 37
96
8.19 DCIM_OSDeploymentService.GetRFSISOImageConnectionInfo() ......................................... 39 97
8.20 DCIM_OSDeploymentService.GetHostMACInfo() ................................................................... 39 98
9 Use Cases ........................................................................................................................................... 40 99
10 CIM Elements ...................................................................................................................................... 40
100
11 Privilege and License Requirement .................................................................................................... 40 101
102
4 Version 1.4.0
Figures 103
Figure 1 – Operating System (OS) Deployment Profile: Class Diagram .................................................... 11 104
105
Tables 106
Table 1 – Related Profiles ........................................................................................................................... 10 107
Table 2 – Class Requirements: Power State Management Profile ............................................................. 12 108
Table 3 –DCIM_OSDeploymentService - Operations ................................................................................ 13 109
Table 3 – DCIM_OSDeploymentService - Properties ................................................................................. 13 110
Table 4 – DCIM_OSDConcreteJob - Properties ......................................................................................... 14 111
Table 5 – Job Descriptions .......................................................................................................................... 14 112
Table 6 – DCIM_LCRegisteredProfile - Operations .................................................................................... 16 113
Table 7 – Class: DCIM_LCRegisteredProfile .............................................................................................. 16 114
Table 8 – DCIM_OSDeploymentService.GetDriverPackInfo() Method: Return Code Values .................... 17 115
Table 9 – DCIM_OSDeploymentService.GetDriverPackInfo() Method: Parameters .................................. 18 116
Table 10 – DCIM_OSDeploymentService.GetDriverPackInfo() Method: Standard Messages .................. 18 117
Table 11 – DCIM_OSDeploymentService.UnpackAndAttach() Method: Return Code Values .................. 18 118
Table 12 – DCIM_OSDeploymentService.UnpackAndAttach() Method: Parameters ................................ 19 119
Table 13 – DCIM_OSDeploymentService.UnpackAndAttach() Method: Standard Messages ................... 19 120
Table 14 – DCIM_OSDeploymentService.DetachDrivers() Method: Return Code Values ........................ 20 121
Table 15 – DCIM_OSDeploymentService.DetachDrivers() Method: Parameters ...................................... 20 122
Table 16 – DCIM_ OSDeploymentService.DetachDrivers() Method: Standard Messages ........................ 20 123
Table 17 – DCIM_OSDeploymentService.UnpackAndShare() Method: Return Code Values ................... 20 124
Table 18 – DCIM_OSDeploymentService.UnpackAndShare() Method: Parameters ................................. 21 125
Table 19 – DCIM_ OSDeploymentService.UnpackAndShare() Method: Standard Messages .................. 21 126
Table 20 – DCIM_OSDeploymentService.BootToNetworkISO() Method: Return Code Values ................ 22 127
Table 21 – DCIM_OSDeploymentService.BootToNetworkISO() Method: Parameters ............................. 23 128
Table 22 – DCIM__OSDeploymentService.BootToNetworkISO() Method: Standard Messages .............. 23 129
Table 23 – DCIM_OSDeploymentService.DetachISOImage() Method: Return Code Values ................... 24 130
Table 24 – DCIM_OSDeploymentService.DetachISOImage() Method: Parameters ................................. 25 131
Table 25 – DCIM_OSDeploymentService.DetachISOImage() Method: Standard Messages .................... 25 132
Table 26 – DCIM_OSDeploymentService.BootToPXE() Method: Return Code Values ............................ 25 133
Table 27 – DCIM_OSDeploymentService.BootToPXE() Method: Parameters .......................................... 26 134
Table 28 – DCIM_OSDeploymentService.BootToPXE() Method: Standard Messages ............................. 26 135
Table 29 – DCIM_OSDeploymentService.BootToHD() Method: Return Code Values .............................. 26 136
Table 30 – DCIM_OSDeploymentService.BootToHD() Method: Parameters ............................................ 26 137
Table 31 – DCIM_OSDeploymentService.BootToHD() Method: Standard Messages ............................... 27 138
Table 32 – DCIM_OSDeploymentService.DownloadISOToVFlash() Method: Return Code Values ......... 27 139
Table 33 – DCIM_OSDeploymentService.DownloadISOToVFlash() Method: Parameters ....................... 28 140
Table 34 – DCIM_OSDeploymentService.DownloadISOToVFlash() Method: Standard Messages .......... 28 141
Table 35 – DCIM_OSDeploymentService.BootToISOFromVFlash() Method: Return Code Values .......... 29 142
Table 36 – DCIM_OSDeploymentService.BootToISOFromVFlash() Method: Parameters ....................... 29 143
Table 37 – DCIM_OSDeploymentService.BootToISOFromVFlash() Method: Standard Messages .......... 29 144
Table 38 – DCIM_OSDeploymentService.DetachISOFromVFlash() Method: Return Code Values .......... 30 145
Table 39 – DCIM_OSDeploymentService.DetachISOFromVFlash() Method: Parameters ........................ 31 146
Table 40 – DCIM_OSDeploymentService.DetachISOFromVFlash() Method: Standard Messages .......... 31 147
Table 41 – DCIM_OSDeploymentService.DeleteISOFromVFlash() Method: Return Code Values ........... 31 148
Version 1.4.0 5
Table 42 – DCIM_OSDeploymentService.DeleteISOFromVFlash() Method: Parameters ......................... 32 149
Table 43 – DCIM_OSDeploymentService.DeleteISOFromVFlash() Method: Standard Messages ........... 32 150
Table 44 – DCIM_OSDeploymentService.ConnectNetworkISOImage () Method: Return Code Values ... 32 151
Table 45 – DCIM_OSDeploymentService.ConnectNetworkISOImage() Method: Parameters .................. 33 152
Table 46 – DCIM_OSDeploymentService.ConnectNetworkISOImage () Method: Standard Messages .... 33 153
Table 47 – DCIM_OSDeploymentService.DisconnectNetworkISOImage () Method: Return Code Values34 154
Table 48 – DCIM_OSDeploymentService.DisconnectNetworkISOImage () Method: Parameters ............. 34 155
Table 49 – DCIM_OSDeploymentService.DisconnectNetworkISOImage () Method: Standard Messages 34 156
Table 50 – DCIM_OSDeploymentService.GetNetworkISOImageConnectionInfo() Method: Return Code 157
Values ............................................................................................................................... 35 158
Table 51 – DCIM_OSDeploymentService.GetNetworkISOImageConnectionInfo() Method: Parameters . 35 159
Table 52 – DCIM_OSDeploymentService.GetNetworkISOImageConnectionInfo () Method: Standard 160
Messages .......................................................................................................................... 35 161
Table 53 – DCIM_OSDeploymentService.SkipISOImageBoot () Method: Return Code Values ............... 36 162
Table 54 – DCIM_OSDeploymentService.SkipISOImageBoot() Method: Parameters .............................. 36 163
Table 55 – DCIM_OSDeploymentService.SkipISOImageBoot () Method: Standard Messages ................ 36 164
Table 56 – DCIM_OSDeploymentService.DisconnectRFSISOImage() Method: Return Code Values ...... 36 165
Table 57 – DCIM_OSDeploymentService.DisconnectRFSISOImage() Method: Parameters .................... 37 166
Table 58 – DCIM_OSDeploymentService. DisconnectRFSISOImage() Method: Standard Messages ..... 37 167
Table 59 – DCIM_OSDeploymentService.ConnectRFSISOImage () Method: Return Code Values ......... 37 168
Table 60 – DCIM_OSDeploymentService.ConnectRFSISOImage() Method: Parameters ........................ 38 169
Table 61 – DCIM_OSDeploymentService.ConnectRFSISOImage() Method: Standard Messages ........... 38 170
Table 62 – DCIM_OSDeploymentService.GetRFSISOImageConnectionInfo() Method: Return Code 171
Values ............................................................................................................................... 39 172
Table 63 – DCIM_OSDeploymentService.GetRFSISOImageConnectionInfo () Method: Parameters ...... 39 173
Table 64 – DCIM_OSDeploymentService.GetRFSISOImageConnectionInfo() Method: Standard 174
Messages .......................................................................................................................... 39 175
Table 65 – DCIM_OSDeploymentService.GetHostMACInfo() Method: Return Code Values .................... 39 176
Table 66 – DCIM_OSDeploymentService.GetHostMACInfo() Method: Parameters .................................. 40 177
Table 67 – DCIM_OSDeploymentService.GetHostMACInfo() Method: Standard Messages .................... 40 178
Table 68 – Privilege and License Requirements ........................................................................................ 40 179
180
Version 1.4.0 7
Operating System (OS) Deployment Profile 181
1 Scope 182
The Operating System (OS) Deployment Profile extends the management capabilities of referencing 183
profiles by adding the capability to represent OS deployment configuration features. The OS deployment 184
feature consists of: 185
• Provide the supported OS and version information from the embedded OS driver pack. 186
• Unpack the OS Driver Update Package (DUP) and extract drivers for a specified OS; the drivers 187
are placed on a local flash drive (nvram) or on a network share. 188
• Expose the unpacked drivers to the host as a USB device. 189
• Ability to boot to PXE images. 190
• Ability to boot to the ISO image present on a network share. 191
• Ability to download ISO Image and save it in vFlash. 192
• Ability to boot to the ISO present in vFlash. 193
2 Normative References 194
The following referenced documents are indispensable for the application of this document. For dated 195
references, only the edition cited applies. For undated references, the latest edition of the referenced 196
document (including any amendments) applies. 197
• DMTF DSP1033, Profile Registration Profile 1.0.0 198
• DMTF DSP0200, CIM Operations over HTTP 1.2.0 199
• DMTF DSP0004, CIM Infrastructure Specification 2.3.0 200
• DMTF DSP1000, Management Profile Specification Template 201
• DMTF DSP1001, Management Profile Specification Usage Guide 202
• Dell Lifecycle Controller Best Practices Guide 1.0, 203
http://en.community.dell.com/techcenter/extras/m/white_papers/20066173.aspx 204
• Dell WSMAN Licenses and Privileges 1.0 205
• ISO/IEC Directives, Part 2, Rules for the structure and drafting of International Standards, 206
http://isotc.iso.org/livelink/livelink.exe?func=ll&objId=4230456&objAction=browse&sort=subtype 207
• Unified Modeling Language (UML) from the Open Management Group (OMG), 208
http://www.uml.org 209
• Dell Tech Center MOF Library:http://www.delltechcenter.com/page/DCIM.Library.MOF 210
• Related Managed Object Format (MOF) files: 211
o DCIM_OSDeploymentService.mof 212
8 Version 1.4.0
o DCIM_OSDConcreteJob.mof 213
o DCIM_LCElementConformsToProfile.mof 214
o DCIM_LCRegisteredProfile.mof 215
3 Terms and Definitions 216
For the purposes of this document, the following terms and definitions apply. 217
3.1 218
Conditional – Indicates requirements to be followed strictly in order to conform to the document when the 219
specified conditions are met. 220
3.2 221
Mandatory – Indicates requirements to be followed strictly in order to conform to the document and from 222
which no deviation is permitted. 223
3.3 224
May – Indicates a course of action permissible within the limits of the document. 225
3.4 226
Optional – Indicates a course of action permissible within the limits of the document. 227
3.5 228
can – Used for statements of possibility and capability, whether material, physical, or causal. 229
3.6 230
cannot – Used for statements of possibility and capability, whether material, physical, or causal. 231
3.7 232
need not – Indicates a course of action permissible within the limits of the document. 233
3.8 234
referencing profile – Indicates a profile that owns the definition of this class and can include a reference 235
to this profile in its “Related Profiles” table. 236
3.9 237
shall – Indicates requirements to be followed strictly in order to conform to the document and from which 238
no deviation is permitted. 239
Version 1.4.0 9
3.10 240
shall not – Indicates requirements to be followed strictly in order to conform to the document and from 241
which no deviation is permitted. 242
3.11 243
should – Indicates that among several possibilities, one is recommended as particularly suitable, without 244
mentioning or excluding others, or that a certain course of action is preferred but not necessarily required. 245
3.12 246
should not – Indicates that a certain possibility or course of action is deprecated but not prohibited 247
3.13 248
FQDD – Fully Qualified Device Descriptor is used to identify a particular component in a system. 249
3.14 250
Interop Namespace – Interop Namespace is where instrumentation instantiates classes to advertise its 251
capabilities for client discovery. 252
3.15 253
Implementation Namespace – Implementation Namespace is where instrumentation instantiates 254
classes relevant to executing core management tasks. 255
3.16 256
ENUMERATE – Refers to WS-MAN ENUMERATE operation as described in Section 8.2 of 257
DSP0226_V1.1 and Section 9.1 of DSP0227_V1.0 258
3.17 259
GET – Refers to WS-MAN GET operation as defined in Section 7.3 of DSP00226_V1.1 and Section 7.1 260
of DSP0227_V1.0 261
262
4 Symbols and Abbreviated Terms 263
4.1 264
CIM 265
Common Information Model 266
4.2 267
RFS 268
Remote File Share 269
5 Synopsis 270
Profile Name: Operating System (OS) Deployment 271
Version: 1.2.0 272
Organization: DCIM 273
CIM Schema Version: 2.26 Experimental 274
Central Class: DCIM_OSDeploymentService 275
10 Version 1.4.0
Scoping Class: CIM_ComputerSystem 276
The Operating System (OS) Deployment Profile extends the management capability of the referencing 277
profiles by adding the capability to support OS deployment activities by manipulating the OS deployment 278
features provided by the service processor. These features include: 279
• Identify the list of OS drivers. 280
• Unpack the OS DUP and extract drivers for a specified OS; the drivers are placed on a local flash 281
drive (nvram). 282
• Expose the unpacked drivers to the host as a USB device. 283
• Expose the drivers to the network in a secure manner for access by a management application. 284
• Support booting to an OS provisioning image from a network share. 285
• Download a pre-boot OS provisioning image from a network share to vFlash. 286
• Support booting to an OS provisioning image from vFlash. 287
DCIM_OSDeploymentService shall be the Central Class. 288
Table 1 identifies related profiles. 289
Table 1 – Related Profiles 290
Profile Name Organization Version Relationship
Profile Registration DCIM 1.0 Reference
6 Description 291
The Operating System (OS) Deployment Profile describes the OS deployment configuration service and 292
the related methods. The profile also describes the relationship of the OS Deployment Profile classes to 293
DMTF and Dell profile version information. 294
The OS deployment features are: 295
• Identifying the list of OS drivers. 296
• Unpacking the OS DUP and extract drivers for a specified OS. The drivers are placed on a local 297
flash drive (nvram). 298
• Exposing the unpacked drivers to the host as a USB device. 299
• Securely exposing the drivers to the network for access by a management application. 300
• Booting to an OS provisioning image from a network share. 301
• Downloading a pre-boot OS provisioning image from a network share to vFlash SD card. 302
• Booting to an OS provisioning image from vFlash SD card. 303
Version 1.4.0 11
Figure 1 represents the class schema for the Operating System (OS) Deployment Profile. For 304
simplicity, the prefix CIM_ has been removed from the names of the classes that are standard DMTF 305
classes. 306
The OS Deployment feature in a service processor is represented by the instance of the 307
DCIM_OSDeploymentService class. The DCIM_OSDeploymentService has extrinsic methods for 308
accomplishing the various OS deployment features described above. The OS Deployment profile 309
information is represented with the instance of CIM_RegisteredProfile. 310
DCIM_LCRegisteredProfile
DCIM_OSDeploymentService
DCIM_OSDConcreteJob
“interop”
Namespace
“root/dcim”
Namespace
DCIM_LCElementConformsToProfile
311
Figure 1 – Operating System (OS) Deployment Profile: Class Diagram 312
12 Version 1.4.0
7 Implementation Requirements 313
Requirements and guidelines for propagating and formulating certain properties of the classes are 314
discussed in this section. 315
This section describes the implementation of Dell OS Deployment. 316
Table 2 – Class Requirements: Power State Management Profile 317
Element Name Requirement Description
Classes
DCIM_OSDeploymentService Mandatory
The class shall be implemented in the
“root/dcim” namespace.
See section 7.1
DCIM_OSDConcreteJob Mandatory
The class shall be implemented in the
“root/dcim” namespace.
See section 7.2
DCIM_LCElementConformsToProfile Mandatory
The class shall be implemented in both
the Interop and “root/dcim” namespaces.
See section 7.1 and 7.3.
DCIM_LCRegisteredProfile
Mandatory
The class shall be implemented in the
“root/interop” namespace.
See section 7.3.
Indications
None defined in this profile
318
7.1 DCIM_OSDeploymentService 319
This section describes the implementation for the DCIM_OSDeploymentService class. 320
This class is instantiated in the “root/dcim” namespace. 321
The DCIM_LCElementConformsToProfile association’s ManagedElement property shall references the 322
DCIM_OSDeploymentService instance(s). 323
7.1.1 Resource URIs for WinRM
®
324
The class Resource URI is: 325
“http://schemas.dell.com/wbem/wscim/1/cim-schema/2 / 326
DCIM_OSDeploymentService?__cimnamespace=root/dcim” 327
The key properties are the SystemCreationClassName, CreationClassName, SystemName, and Name. 328
The instance Resource URI for DCIM_OSDeploymentService instance is: 329
http://schemas.dell.com/wbem/wscim/1/cim-330
schema/2/DCIM_OSDeploymentService?__cimnamespace=root/dcim+SystemCreationClassName=331
DCIM_ComputerSystem+SystemName=DCIM:ComputerSystem+CreationClassName=DCIM_OSDe332
ploymentService +Name= DCIM:OSDeploymentService” 333
Version 1.4.0 13
7.1.2 Operations 334
The following table details the implemented operations on DCIM_OSDeploymentService. 335
Table 3 –DCIM_OSDeploymentService - Operations 336
Operation Name
Requirements
Required Input
Get
Mandatory
Instance URI
Enumerate
Mandatory
Class URI
Invoke
Mandatory
Instance URI and Method parameters
337
7.1.3 Class Properties 338
The following table details the implemented properties for DCIM_OSDeploymentService instance in a 339
system. The “Requirements” column shall denote the implementation requirement for the corresponding 340
property. The “Type” column denotes the corresponding property type. The “Additional Requirement” 341
Column specifies additional information on the property value. 342
Table 3 – DCIM_OSDeploymentService - Properties 343
Property Name
Type
Requirement
Additional Requirement
CreationClassName
String
Mandatory
The property value shall be
"DCIM_OSDeploymentService"
Name
String
Mandatory
The property value shall be
"DCIM:OSDeploymentService"
ElementName
String
Mandatory
The property value shall be "Operating System
Deployment Service"
SystemCreationClassName
String
Mandatory
The property value shall be
"DCIM_ComputerSystem"
SystemName
String
Mandatory
The property value shall be
"DCIM:ComputerSystem"
344
7.2 DCIM_OSDConcreteJob 345
This section describes the implementation for the DCIM_OSDConcreteJob class. 346
This class shall be instantiated in the “root/dcim” namespace. 347
7.2.1 Resource URIs for WinRM
®
348
The class Resource URI is: 349
“http://schemas.dell.com/wbem/wscim/1/cim-schema/2 / 350
DCIM_OSDConcreteJob?__cimnamespace=root/dcim” 351
The key property is the InstanceID property. 352
The instance Resource URI for DCIM_OSDConcreteJob instance is: 353
http://schemas.dell.com/wbem/wscim/1/cim-schema/2/ 354
DCIM_OSDConcreteJob?__cimnamespace=root/dcim+InstanceID=<InstanceID> 355
where <InstanceID> is the InstanceID property value. 356
14 Version 1.4.0
7.2.2 Class Properties 357
The following table lists the implemented properties for DCIM_OSDConcreteJob instance in a system. 358
The “Requirements” column shall denote whether the property is implemented (for requirement 359
definitions, see section 3). The “Additional Requirements” column shall denote either possible values for 360
the property, or requirements on the value formulation. 361
Table 4 – DCIM_OSDConcreteJob - Properties 362
Type
Requirement
Additional Requirement
String
Mandatory
The property shall have unique and
opaque value.
JobStatus
String
Mandatory
The property shall have a value from the
“Job Status” column in the Table 5.
String
Mandatory
The property shall have a value from the
“Job Name” column in the Table 5.
Boolean
Mandatory
The property shall denote whether the
DCIM_OSDConcreteJob instance will be
deleted on the completion. The value of
TRUE shall represent the deletion on
completion.
Message
String
Mandatory
The property shall have a message string
from the Dell Message Registry.
String
Mandatory
The property shall have a message ID
from the Dell Message Registry.
String
Optional
The following table lists the JobName and JobStatus property values, and their respective descriptions. 363
Table 5 – Job Descriptions 364
Job Name Job Status JobStatus Description
UnpackAndAttach
Processing Driver Pack
Extracting drivers, creating dynamic partition,
copying drivers, and attaching the partition as a
USB device to the host.
Success Successfully executed the method.
Failed
Failed to execute the method. For more
information, see MessageID and Message
properties on the returned
DCIM_OSDConcreteJob instance.
Processing Driver Pack
Extracting drivers and copying drivers to the
network share.
Success Successfully executed the method.
Failed
Failed to execute the method. For more
information, see MessageID and Message
properties on the returned
DCIM_OSDConcreteJob instance.
BootToNetworkISO
Rebooting to ISO
Attaching the network ISO image as a local CD-
ROM to the host and booting to it.
Success Successfully executed the method.
Failed
Failed to execute the method, For more
information, see MessageID and Message
properties on the returned
DCIM_OSDConcreteJob instance.
BootToISOFromVFlash Rebooting to ISO
Attaching the ISO image on vFlash as a local
Version 1.4.0 15
Job Name Job Status JobStatus Description
CD-ROM to the host and booting to it.
Success Successfully executed the method.
Failed
Failed to execute the method, refer to
MessageID and Message properties on the
returned DCIM_OSDConcreteJob instance for
detailed information.
DownloadISOToVFlash
Downloading
Copying the ISO image from network share to
vFlash SD card.
Success Successfully executed the method.
Failed
Failed to execute the method. For more
informaiton, see MessageID and Message
properties on the returned
DCIM_OSDConcreteJob instance.
ConnectNetworkISOImage
Connecting to Network ISO
Connecting to the ISO present on a network
share and attaching it as a CD-ROM device to
the host.
Success Successfully executed the method.
Failed
Failed to execute the method. For more
information, see MessageID and Message
properties on the returned
DCIM_OSDConcreteJob instance.
ConnectRFSISOImage
Connecting to Network ISO
Connecting to the ISO present on a network
share, and attaching it to the host server as a
USB CD-ROM device through RFS end point.
Success Successfully executed the method.
Failed
Failed to execute the method. For more
information, see MessageID and Message
properties on the returned
DCIM_OSDConcreteJob instance.
7.3 Operating System (OS) Deployment Profile Registration – 365
DCIM_LCRegistered Profile 366
This section describes the implementation for the DCIM_LCRegisteredProfile class. 367
This class shall be instantiated in the “root/interop” namespace. 368
The DCIM_LCElementConformsToProfile association(s)’ ConformantStandard property shall reference 369
the DCIM_LCRegisteredProfile instance. 370
7.3.1 Resource URIs for WinRM
®
371
The class WBEM URI shall be "http://schemas.dmtf.org/wbem/wscim/1/cim-372
schema/2/CIM_RegisteredProfile?__cimnamespace=root/interop" 373
The key property shall be the InstanceID property. 374
The instance WBEM URI shall be: “http://schemas.dell.com/wbem/wscim/1/cim-375
schema/2/DCIM_LCRegisteredProfile?__cimnamespace=root/interop+InstanceID= 376
DCIM:OSDeployment:1.1.0” 377
7.3.2 Operations 378
The following table details the implemented operations on DCIM_LCRegisteredProfile. 379
16 Version 1.4.0
Table 6 – DCIM_LCRegisteredProfile - Operations 380
Operation Name
Requirements
Required Input
Get
Mandatory
Instance URI
Enumerate
Mandatory
Class URI
381
7.3.3 Class Properties 382
The following table lists the implemented properties for DCIM_LCRegisteredProfile instance representing 383
Operating System (OS) Deployment Profile implementation. The “Requirements” column shall denote 384
whether the property is implemented (for requirement definitions, see section 3). The “Additional 385
Requirements” column shall denote either possible values for the property, or requirements on the value 386
formulation. 387
Table 7 – Class: DCIM_LCRegisteredProfile 388
Properties Type Requirement Additional Requirements
InstanceID
string
Mandatory
This property shall have a value of
“DCIM:OSDeployment:1.1.0"
RegisteredName
string
Mandatory
This property shall have a value of “OS
Deployment”.
RegisteredVersion string Mandatory This property shall have a value of “1.4.0”.
RegisteredOrganization uint16 Mandatory This property shall have a value of 1 (Other).
OtherRegisteredOrganization string Mandatory This property shall match “DCIM”
AdvertiseTypes[]
uint16 Mandatory
This property array shall have values “1(Other)”
and “1(Other)”
AdvertiseTypeDescriptions[]
string Mandatory
This property array shall have values “WS-Identify”
and ““root/interop” namespace”
AdvertisedTypes[]
uint16 Mandatory
This property array shall contain [1(Other), 1
(Other)].
AdvertiseTypeDescriptions[]
string Mandatory
This property array shall contain ["WS-
Identify", "Interop Namespace"].
ProfileRequireLicense[]
string Mandatory
This property array shall describe the
required licenses for this profile.
If no license is required for the profile, the
property shall have value NULL.
ProfileRequireLicenseStatus[]
string Mandatory
This property array shall contain the status for
the corresponding license in the same
element index of the ProfileRequireLicense
array property. Each array element shall
contain:
• “LICENSED”
• “NOT_LICENSED”
If no license is required for the profile, the
property shall have value NULL.
389
Version 1.4.0 17
8 Methods 390
This section details the requirements for supporting extrinsic methods for the CIM elements defined by 391
this profile. 392
8.1 DCIM_OSDeploymentService.GetDriverPackInfo() 393
The GetDriverPackInfo() method is used get the list of operating systems that can be installed on the host 394
system using the embedded device drivers present in the Lifecycle Controller. 395
The following table lists the return values for GetDriverPackInfo() method, where the method-execution 396
behavior matches the return-code description. 397
Table 8 – DCIM_OSDeploymentService.GetDriverPackInfo() Method: Return Code Values 398
Value Description
0 Request was successfully executed.
2 Error occurred.
The following table lists the output parameters for GetDriverPackInfo() method. 399
18 Version 1.4.0
Table 9 – DCIM_OSDeploymentService.GetDriverPackInfo() Method: Parameters 400
Qualifiers Name Type Description/Values
OUT, REQ Version String NULL or version of the driver pack.
OUT, REQ OSList[] String
NULL or contains the list of operating systems
supported for this server.
OUT MessageID String
If the method fails to execute, the error
message ID is returned.
OUT Message String
If the method fails to execute, the error
message in English is returned.
OUT
MessageArguments[] string
Substitution variables for dynamic error
messages.
Table 10 – DCIM_OSDeploymentService.GetDriverPackInfo() Method: Standard Messages 401
MessageID (OUT parameter) Message MessageArguments[]
OSD2 General failure
OSD3
Lifecycle Controller is being used by
another process
OSD4
Cannot access Driver Pack partition
in Lifecycle Controller
OSD5
Driver Pack not found in Lifecycle
Controller
OSD6 Cannot allocate memory
OSD29
Driver Pack config file not found in
Lifecycle Controller. Driver Pack
might be corrupt
OSD35 Lifecycle Controller is disabled
8.2 DCIM_OSDeploymentService.UnpackAndAttach() 402
The UnpackAndAttach() method is used to extract the drivers for the selected operating system to a USB 403
device that is attached locally to the server for the specified time interval. The following talbe specifies the 404
return values for UnpackAndAttach() method, where the method-execution behavior matches the return-405
code description. 406
Table 11 – DCIM_OSDeploymentService.UnpackAndAttach() Method: Return Code Values 407
Value Description
2 Error occurred.
4096 Job started: REF returned to started CIM_ConcreteJob
The following table lists the output parameters for UnpackAndAttach() method. 408
Version 1.4.0 19
Table 12 – DCIM_OSDeploymentService.UnpackAndAttach() Method: Parameters 409
Qualifiers Name Type Description/Values
IN, REQ OSName String
Name of the OS to unpack drivers for, this
value shall match one of the strings in OSList
returned for GetDriverPackInfo
IN, REQ ExposeDuration DateTime
Identifies the amount of time up to 18 hours for
the drivers to be exposed as an USB device to
the host.
OUT, REQ Job CIM_ConcreteJob REF
Returned to keep track of OSD – USB attach
job.
OUT MessageID String
If the method fails to execute, the error
message ID is returned.
OUT Message String
If the method fails to execute, the error
message in English is returned.
OUT
MessageArguments[] string
Substitution variables for dynamic error
messages
Table 13 – DCIM_OSDeploymentService.UnpackAndAttach() Method: Standard Messages 410
MessageID (OUT parameter) Message MessageArguments[]
OSD1 The command was successful
OSD2 General failure
OSD3
Lifecycle Controller is being used by
another process
OSD4
Cannot access Driver Pack partition
in Lifecycle Controller
OSD5
Driver Pack not found in Lifecycle
Controller
OSD10
Installation not supported for the
selected operating system
OSD11
Driver Pack does not have drivers for
the selected operating system
OSD12
Cannot create USB device to copy
drivers for the selected operating
system
OSD13
Cannot mount USB device to copy
drivers for the selected operating
system
OSD19
The fork() command for a child
process to do the task failed
OSD20
Unable to get size or label from
Driver Pack for selected operating
system
OSD27
Copying drivers for selected
operating system failed
OSD30
Invalid value for ExposeDuration –
must be 60-65535 seconds
OSD35 Lifecycle Controller is not enabled
411
20 Version 1.4.0
8.3 DCIM_OSDeploymentService.DetachDrivers() 412
This OSDeploymentService.DetachDrivers() method is used to detach the USB device containing the 413
drivers from the host server. The following table lists the return values for DetachDrivers() method,, where 414
the method-execution behavior matches the return-code description. 415
416
Table 14 – DCIM_OSDeploymentService.DetachDrivers() Method: Return Code Values 417
Value Description
0 Request was successfully executed.
2 Error occurred.
The following table lists the output parameters for the DetachDrivers() method. 418
Table 15 – DCIM_OSDeploymentService.DetachDrivers() Method: Parameters 419
Qualifiers Name Type Description/Values
OUT MessageID String
If the method fails to execute, the error
message ID is returned.
OUT Message String
If the method fails to execute, the error
message in English is returned.
OUT
MessageArguments[] string
Substitution variables for dynamic error
messages
Table 16 – DCIM_ OSDeploymentService.DetachDrivers() Method: Standard Messages 420
MessageID (OUT parameter) Message MessageArguments[]
OSD7
Unable to retrieve Lifecycle
Controller handle
OSD24
Unable to continue with
DetachDrivers - UnPackAndAttach is
in progress
OSD25
Unable to detach USB device
containing operating system drivers
421
8.4 DCIM_OSDeploymentService.UnpackAndShare() 422
The UnpackAndShare() method is used to extract the drivers for the selected operating system, and copy 423
them to the specified network share. The following table lists the return values for UnpackAndShare(), 424
where the method-execution behavior matches the return-code description. 425
Table 17 – DCIM_OSDeploymentService.UnpackAndShare() Method: Return Code Values 426
Value Description
2 Error occurred.
4096 Job started: REF returned to started CIM_ConcreteJob
The following table lists the input and output parameters for the UnpackAndShare() method. 427
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41

Dell Enterprise Solution Resources Owner's manual

Dell
Brand
Dell
Model
Enterprise Solution Resources
Type
Owner's manual
This manual is also suitable for
Download PDF
report

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI

Related papers

Other documents