2 Software Update Profile 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 26 Document Number: DCIM 1038 Document Type: Specification Document Status: Final Document Language: E Date: 2012-03-08 27 Version: 1.0.
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 57 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.
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 CONTENTS 1 2 3 4 5 6 7 8 9 10 11 Scope .................................................................................................................................................... 5 Normative References........................................................................................................................... 5 Terms and Definitions ................................................................................................
84 Figures 85 86 Figure 1 – Software Update Profile: Class Diagram ..................................................................................... 8 87 Tables 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 Table 1 – Related Profiles ............................................................................................................................. 7 Table 2 – CIM Elements: Software Update Profile .....................................................................................
Software Update Profile 105 106 1 107 108 The Software Update Profile extends the management capabilities of referencing profiles by adding the capability to update platform firmware or software. 109 2 110 Refer to the following documents for more information. 111 112 NOTE: For dated references, only the edition cited applies.
129 3 130 For the purposes of this document, the following terms and definitions apply. 131 132 3.1 133 134 Terms and Definitions can - Used for statements of possibility and capability, whether material, physical, or causal. 3.2 cannot - Used for statements of possibility and capability, whether material, physical, or causal. 3.3 135 136 137 conditional - Indicates requirements to be followed strictly in order to conform to the document when the specified conditions are met.
3.14 165 166 Implementation Namespace: root/dcim 167 168 Implementation Namespace: root/dcim is where instrumentation instantiates classes relevant to executing core management tasks. 169 170 3.15 ENUMERATE 171 172 Refers to WS-MAN ENUMERATE operation as described in Section 8.2 of DSP0226_V1.1 and Section 9.1 of DSP0227_V1.0 173 174 3.16 GET 175 176 Refers to WS-MAN GET operation as defined in Section 7.3 of DSP00226_V1.1 and Section 7.1 of DSP0227_V1.
194 6 Description 195 The Software Update Profile describes the management interface for driver/firmware updates. 196 197 198 199 Figure 1 represents the class schema for the Software Update Profile. The software update in a managed system is represented by the instance of DCIM_SoftwareInstallationService class. The software update profile information is represented with the instance of LC_RegisteredProfile. The result of a software update represented as the instance of DCIM_SoftUpdateConcreteJob.
206 207 7.1 DCIM_SoftwareInstallationService 208 This section describes the implementation for the DCIM_SoftwareInstallationService. 209 This class is instantiated in the Implementation Namespace: root/dcim. 210 211 The DCIM_LCElementConformsToProfile association’s ManagedElement property shall references the DCIM_SoftwareInstallationService instance(s). 212 7.1.1 213 The class Resource URI shall be: 214 215 http://schemas.dell.
232 7.2 Software Update Profile Registration – DCIM_LCRegisteredProfile 233 This section describes the implementation for the DCIM_LCRegisteredProfile class. 234 This class shall be instantiated in the Interop Namespace: root/interop. 235 236 The DCIM_LCElementConformsToProfile association(s)’ ConformantStandard property shall reference the DCIM_LCRegisteredProfile instance. 237 7.2.1 238 239 The class Resource URI shall be "http://schemas.dmtf.
Properties Type Requirement Additional Requirements This property array shall describe the required licenses for this profile. ProfileRequireLicense[] ProfileRequireLicenseStatus[] string string Mandatory If no license is required for the profile, the property shall have value NULL. Mandatory This property array shall contain the status for the corresponding license in the same element index of the ProfileRequireLicense array property.
260 Table 7 – DCIM_SoftwareInstallationService.InstallFromURI () Method: Return Values Value Description 2 Error 1 Job started1 4096 261 262 263 264 Table 8 – SoftwareInstallationService.InstallFromURI () Method: Parameters Qualifiers Name Type Description/Values IN URI String URI location of firmware to update a component. IN Target CIM_SoftwareIdentity REF Reference to CIM_SoftwareIdentity. InstanceID value of this instance maps with firmware to be updated.
270 271 272 Table 10 – DCIM_SoftwareInstallationService.InstallFromSoftwareIdentity () Method: Return Values Value Description 2 Error 40961 Job started1 Table 11 – DCIM_SoftwareInstallationService.InstallFromSoftwareIdentity () Method: Parameters Qualifiers Name Type Description/Values IN Target CIM_SoftwareIdentity REF Reference to CIM_SoftwareIdentity. InstanceID value of this instance maps with firmware to be updated. OUT Message string Job Completed Error Message in English.
280 8.3 281 This method is used to generate the reboot job to apply the updates. 282 DCIM_SoftwareInstallationService.CreateRebootJob () Table 13 – DCIM_SoftwareInstallationService.CreateRebootJob ()Method: Return Values Value Description 2 Error 1 Job started1 4096 283 Table 14 – DCIM_SoftwareInstallationService.
290 10 CIM Elements 291 No other requirements are defined. 292 11 Privilege and License Requirement 293 294 295 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. 296 Table 16 – Privilege and License Requirements Class and Method Operation DCIM_SoftwareInstallationService ENUMERATE, GET DCIM_SoftwareInstallationService.