Dell Lifecycle Controller (LC) Management Profile Document Number: DCIM1039 Document Type: Specification Document Status: Published Document Language: E Date: 2009-12-16 Version: 1.0.
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. © 2008 – 2009 Dell Inc. All rights reserved.
CONTENTS 1 2 Scope .................................................................................................................................................... 5 Normative References ........................................................................................................................... 5 2.1 Approved References ................................................................................................................. 5 2.2 Other References .................................
Figures Figure 1 – LC Management Profile: Class Diagram ..................................................................................... 8 Figure 2 – Object Diagram representing CCR, System ID and DHS attributes .......................................... 17 Tables Table 1 – Related Profiles ............................................................................................................................. 7 Table 2 – CCR Attributes .............................................................
Lifecycle Controller Management Profile 1 Scope The Lifecycle Controller (LC) Management Profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration attributes for the Dell Lifecycle Controller. The LC configuration attributes are modeled as attribute collections for an individual LC; typically there is one LC per system platform. This profile is a specialization of the BIOS Management Profile.
3.3 conditional indicates requirements to be followed strictly in order to conform to the document when the specified conditions are met 3.4 mandatory indicates requirements to be followed strictly in order to conform to the document and from which no deviation is permitted 3.5 may indicates a course of action permissible within the limits of the document 3.6 need not indicates a course of action permissible within the limits of the document 3.
4 Symbols and Abbreviated Terms 4.1 CIM Common Information Model 5 Synopsis Profile Name: Lifecycle Controller (LC) Management Version: 1.0.0 Organization: DCIM CIM Schema Version: 2.19.1 Central Class: DCIM_LCService Scoping Class: CIM_ComputerSystem The LC Management Profile extends the management capability of the referencing profiles by adding the capability to describe LC configuration attributes simply.
RegisteredProfile RegisteredProfile = “LC Management” OwningEntity = “DCIM” “interop” Namespace “root/dcim” Implementation Namespace LCService ConcreteCollection LCServiceCapabilities ElementName = “LC” LCAttribute LCEnumeration LCString .
7.4 DCIM_LCRegisteredProfile One instance of DCIM_LCRegisteredProfile shall be instantiated. 7.5 Lifecycle Controller Attributes to be Represented by LC Management Profile The LC Management Profile defines the modeling of LC configuration attributes using the derivation of CIM_BIOSAttribute class to represent each LC configuration attribute. The following are the LC configuration areas that may require representation using this profile.
Table 3 – Discovery and Handshake Attributes Attribute Name Possible Values Provisioning Server provisioning server addresses and ports Examples: hostname hostname.domain.com 1.1.1.1 Mypc:8080 Myps.dell.com(1.2.3.
Table 4 – DCIM_LCService.SetAttribute() Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is unsupported. 2 Error occurred Table 5 – DCIM_LCService.SetAttribute() Method: Parameters 11 Qualifiers Name Type Description/Values IN AttributeName string DCIM_LCAttribute.
8.2 DCIM_LCService.SetAttributes() A method used to set the values of multiple attributes. Table 6 – DCIM_LCService.SetAttributes() Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is unsupported. 2 Error occurred Table 7 – DCIM_LCService.SetAttributes() Method: Parameters 12 Qualifiers Name Type Description/Values IN AttributeName string [ ] Array of DCIM_LCAttribute.
8.3 DCIM_LCService.CreateConfigJob() A method used to apply the pending values set by the SetAttribute and SetAttributes methods. Table 8 – DCIM_LCService.CreateConfigJob() Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is unsupported. 2 Error occurred 4096 Job started: REF returned to started CIM_ConcreteJob Table 9 – DCIM_LCService.
8.4 DCIM_LCService.ReInitiateDHS() A method used to reinitiate the provisioning server discovery and handshake. Table 10 – DCIM_LCService.ReInitiateDHS() Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is unsupported. 2 Error occurred Table 11 – DCIM_LCService.
Table 12 – DCIM_LCService.ClearProvisioningServer() Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is unsupported. 2 Error occurred Table 13 – DCIM_LCService.
Table 16 – DCIM_LCService.DownloadClientCerts() Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is unsupported. 2 Error occurred 4096 Job started: REF returned to started CIM_ConcreteJob Table 17 – DCIM_LCService.DownloadClientCerts() Method: Parameters Qualifiers Name Type Description/Values IN, OctetString KeyContent string Base64 encoded private key content.
9.2 Use Case 1 – Representing CCR, System ID and DHS attributes DCIM_LCService DCIM_LCRegisteredProfile SetAttribute() SetAttributes() CreateConfigJob() ReInitiateDHS() ClearProvisiontinServer() DownloadServerPublicKey() DownloadClientCerts() DCIM_LCEnumeration DCIM_LCString DCIM_LifecycleJob AttributeName = “Licensed” CurrentValue = Yes DefaultValue = IsReadOnly = True PossibleValues[] = {“Yes”, “No”} AttributeName = “Provisioning Server” CurrentValue = “127.0.0.
10.1 DCIM_LCAttribute DCIM_LCAttribute is a trivial derivation of CIM_BIOSAttribute. The CIM_BIOSAttribute class is implemented to represent all LC attributes. Table21 contains the element requirements for this class. Table 19 – Class: DCIM_LCAttribute Properties Notes Description InstanceID Mandatory Key: This element shall specify the unique identifier for an instance of this class within the Implementation namespace.
Table 21 – Class: DCIM_LCEnumeration Properties and Methods Requirement Description Inherited from DCIM_LCAttribue Mandatory Keys and mandatory properties inherited from DCIM_LCAttribute PossibleValues[ ] Mandatory 19 Version 1.0.
10.4 DCIM_LCString DCIM_LCString is derived from DCIM_LCAttribute, and also contains properties from CIM_BIOSString. Table 22 – Class: DCIM_LCString Properties and Methods Requirement Description Inherited from DCIM_LCAttribue Mandatory Keys and mandatory properties inherited from DCIM_LCAttribute StringType Mandatory 10.5 DCIM_LCRegisteredProfile DCIM_LCRegisteredProfile is a trivial derivation of CIM_RegisteredProfile.The CIM_RegisteredProfile class is defined by the Profile Registration Profile.
ANNEX A (informative) Dell Extension MOF // // // // Copyright (c) 2009 Dell Inc. All rights reserved. ================================================================== DCIM_LCEnumeration ================================================================== [Version ( "1.0.0" ), Description ( "This class extends the DCIM_LCAttribute base class definition " "to provide informational detail for enumeration data types. " "Enumerations are single-selection lists with a finite set of " "entities.
// // // // Copyright (c) 2009 Dell Inc. All rights reserved. ================================================================== DCIM_LCString ================================================================== [Version ( "1.0.0" ),Description( "The DCIM_LCString object may be used to instantiate " "string-based LC attributes.")] class DCIM_LCString : DCIM_LCAttribute { [Description ( "The StringType property provides management applications " "with information defining implementation\'s capabilities " "reg
// // // // Copyright (c) 2009 Dell Inc. All rights reserved. ================================================================== DCIM_LCService ================================================================== [Version ( "1.0.
"Error Message in english corresponding to the " "MessageID" )] string Message, [OUT, Description ( "Any dynamic string substitutions for the Message" )] string MessageArguments[]); uint32 SetAttributes( [Required, IN, Description ( "A reference to a LCAttribute specified by " "AttributeName of the LCAttribute to be modified." )] string AttributeName[], [Required, IN, Description ( "A new value to assign to the specified " "LCAttribute.
uint32 ReInitiateDHS( [IN, Description ( "This is an optional parameter to specify " "Provisioning Server addresses and ports " "used for auto discovery, if omitted, the " "Lifecycle Controller will get the value " "from DHCP or DNS" )] string ProvisioningServer, [Required, IN, Description ( "If true, all configuration information is " "replaced with auto discovery factory defaults. " "If false, an error will be returned" )] boolean ResetToFactoryDefaults, [Required, IN ( false ), Description ( "\"Off\" dis
"to execute." )] string MessageID, [OUT, Description ( "Error Message in english corresponding to the " "MessageID" )] string Message, [OUT, Description ( "Any dynamic string substitutions for the Message" )] string MessageArguments[]); [Experimental, Description ( "This method is called to clear the values for " "provisioning server" ), ValueMap { "0", "1", "2", "3..32767", "32768..
"This method is called to generate a client certificate " "and private key using the provided CA certificate, " "CA private key and CA password" ), ValueMap { "0", "1", "2", "3..32767", "32768..