Simple RAID Profile Document Number: DCIM1031 Document Type: Specification Document Status: Published Document Language: E Date: 2010-08-10 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. © 2010 Dell Inc. All rights reserved.
CONTENTS 1 2 Scope .............................................................................................................................................. 6 Normative References...................................................................................................................... 6 2.1 Approved References ............................................................................................................ 6 2.2 Other References...................................................
Figures Figure 1 –RAID profile: Class Diagram..................................................................................................... 8 Tables Table 1 – Related Profiles........................................................................................................................ 8 Table 2 – DCIM_RAIDService.AssignSpare ( ) Method: Return Code Values ......................................... 13 Table 3 – DCIM_RAIDService.AssignSpare ( ) Method: Standard Messages ......................
Table 42 – DCIM_RAIDService.DeletePendingConfiguration () Method: Parameters ............................. 26 Table 43 – CIM Elements: RAID ProfileRAID profile............................................................................... 34 Table 44 – Class: DCIM_RAIDService ................................................................................................... 34 Table 45 – Class: DCIM_ControllerView ..............................................................................................
Simple RAID Profile 1 Scope The RAID profile extends the management capabilities of referencing profiles by adding the capability to represent the configuration of RAID storage. The RAID storage is modeled as collections of attributes where there are collections for the storage adaptors, physical disks, logical disks, end enclosures and parent-child relationships between the collections. Additionally, there is a configuration service that contains all the methods used to configure the RAID storage.
3.3 optionalcreate indicates a course of action permissible within the limits of the document 3.4 referencing profile indicates a profile that owns the definition of this class and can include a reference to this profile in its “Related Profiles” table 3.5 ENUMERATE Refers to WS-MAN ENUMERATE operation as described in Section 8.2 of DSP0226_V1.1 and Section 9.1 of DSP0227_V1.0 3.6 GET Refers to WS-MAN GET operation as defined in Section 7.3 of DSP00226_V1.1 and Section 7.1 of DSP0227_V1.
Table 1 identifies profiles that are related to this profile. Table 1 – Related Profiles Profile Name Organization Version Relationship Profile Registration Profile DMTF 1.0 Mandatory 6 Description The RAID profile describes the RAID configuration service and the groups that the service manages. The profile also describes the relationship of the RAID groups to the profile version information. Figure 1 represents the class schema for the RAID profile.
7 Implementation Requirements Requirements and guidelines for propagating and formulating certain properties of the classes are discussed in this section. A single instance of DCIM_RAIDService shall be instantiated and one instance of DCIM_ControllerView shall be instantiated. DCIM_RAIDService shall be associated with its view(s) through the FQDD property. 7.1 Views The view classes group object class inventory properties and status properties into a single convenient class.
Product Name SAS Address 7.1.
Uint32 Read Cache Policy Uint32 RAID Types (Raid Level) SizeInBytes Stripe Size Name Span Length SpanDepth Physical Disk IDs Virtual Disk Target ID RemainingRedundancy Uint64 Uint32 string Uint32 Uint32 Array of string Uint32 Uint16 Uint32 DiskCachePolicy Uint8 ObjectStatus 7.1.
SizeInBytes Uint64 Coerced size of physical disk Model string Model Name of the physical disk Manufacturer ManufacturingDay string Manufacturer of the physical disk Manufacturing Day ManufacturingWeek Uint16 Uint16 ManufacturingYear Uint32 Manufacturing Year Revision string revision number of Virtual disk SerialNumber string Serial number of physical disk Protocol: Unknown, SCSI, PATA, FIBRE, USB, SATA, SAS Hotspare Status: No, Dedicated, Global Smart alert: Smart Alert Absent, Smart Aler
8 Methods This section details the requirements for supporting intrinsic operations and extrinsic methods for the CIM elements defined by this profile 8.1 Method: DCIM_RAIDService.AssignSpare () The AssignSpare() method is used to assign a physical disk as a dedicated hot spare for a virtual disk, or as a global hot spare. Table 2 – DCIM_RAIDService.AssignSpare ( ) Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is not supported in the implementation.
8.2 Method: DCIM_RAIDService.ResetConfig () The ResetConfig () method is used to delete all virtual disks and unassign all hot spare physical disks. All data on the existing virtual disks will be lost! Table 5 – DCIM_RAIDService.ResetConfig () Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is not supported in the implementation. 2 Error occurred Table 6 – DCIM_RAIDService.
Table 8 – DCIM_RAIDService.ClearForeignConfig ( ) Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is not supported in the implementation. 2 Error occurred Table 9 – DCIM_RAIDService.ClearForeignConfig ( ) Method: Standard Messages MessageID (OUT parameter) Message STOR003 Missing parameter STOR004 Invalid parameter value STOR006 General failure STOR007 Resource Allocation Failure STOR018 No foreign drives detected Table 10 – DCIM_RAIDService.
MessageID (OUT parameter) Message STOR004 Invalid parameter value STOR006 General failure STOR007 Resource Allocation Failure STOR017 Virtual Disk provided is not valid for the operation Table 12 – DCIM_RAIDService.
Table 14 – DCIM_RAIDService.CreateVirtualDisk () Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is not supported in the implementation. 2 Error occurred 3 Warning Optional parameter not applied Table 15 – DCIM_RAIDService.
Qualifier s Name OUT (optional) 8.6 Message Type String Description/Values Error Message in English corresponding to MessageID is returned If the method fails to execute. Method: DCIM_RAIDService.GetDHSDisks () The GetDHSDisks () method is used to determine possible choices of drives to be a dedicated hotspare for the identified Virtual disk.
Table 20 – DCIM_RAIDService.GetRAIDLevels () Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is not supported in the implementation. 2 Error occurred Table 21 – DCIM_RAIDService.GetRAIDLevels () Method: Standard Messages MessageID (OUT parameter) Message STOR003 Missing parameter STOR004 Invalid parameter value STOR006 General failure STOR007 Resource Allocation Failure Table 22 – DCIM_RAIDService.
Table 23 – DCIM_RAIDService.GetAvailableDisks () Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is not supported in the implementation. 2 Error occurred Table 24 – DCIM_RAIDService.GetAvailableDisks () Method: Standard Messages MessageID (OUT parameter) Message STOR003 Missing parameter STOR004 Invalid parameter value STOR006 General failure STOR007 Resource Allocation Failure Table 25 – DCIM_RAIDService.
Table 26 – DCIM_RAIDService.CheckVDValues() Method: VDPropNameArrayIn values VDPropValueArrayIn Value Description Size Size, in MB, of the virtual disk.(optional) SpanDepth Number of spans in virtual disk (optional) RAIDLevel The new RAID level, such as 0, 1, 5, or 6..(required) Table 27 – DCIM_RAIDService.CheckVDValues() Method: VDPropNameArrayOut values VDPropValueArrayOut Value Description Size Size, in MB, of the virtual disk. RAIDLevel The new RAID level, such as 0, 1, 5, or 6..
Table 30 – DCIM_RAIDService.CheckVDValues () Method: Parameters Qualifiers Name Type Description/Values IN, REQ Target String FQDD of target device (Controller) IN, REQ PDArray String Array Array of FQDD(s) identifies physical disk(s). IN, REQ VDPropNameArrayIn String Array Indexed array of Virtual Disk property names with relative values contained in VDPropValueArray parameter.
Table 33 – DCIM_RAIDService.
Qualifiers Name Type Description/Values OUT (optional) MessageID String Error MessageID is returned If the method fails to execute. OUT (optional) Message String Error Message in English corresponding to MessageID is returned If the method fails to execute. 8.12 Method: DCIM_RAIDService.CreateTargetedConfigJob() The CreateTargetedConfigJob( ) method is used to apply the pending values set by previous RAIDService methods.
MessageID (OUT parameter) Message STOR023 Configuration already committed, cannot set configuration Table 39 – DCIM_RAIDService.CreateTargetedConfigJob() Method: Parameters Qualifiers Name Type Description/Values IN, REQ Target String FQDD of target device (Controller) IN RebootJobType uint16 Shall contain the requested reboot type: 1 - PowerCycle 2 - Graceful Reboot without forced shutdown 3 - Graceful Reboot with forced shutdown.
Value Description 0 Request was successfully executed. 1 Method is not supported in the implementation. 2 Error occurred Table 41 – DCIM_RAIDService.DeletePendingConfiguration () Method: Standard Messages MessageID (OUT parameter) Message STOR003 Missing parameter STOR004 Invalid parameter value STOR006 General failure STOR007 Resource Allocation Failure STOR025 Configuration already committed, cannot delete pending configuration Table 42 – DCIM_RAIDService.
8.14 Profile Conventions for Operations Support for operations for each profile class (including associations) is specified in the following subclauses. Each subclause includes either the statement “All operations in the default list in section 8.14 are supported as described by DSP0200 version 1.2” or a table listing all of the operations that are not supported by this profile or where the profile requires behavior other than that described by DSP0200.
RegisteredVersion = 1.0.0 B) ENUMERATE the CIM_RegisteredProfile class. See section 3.5 for a definition of ENUMERATE . Class URI: http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/CIM_RegisteredProfile?__cimnamespace=root/interop Then query the result for the following properties: RegisteredName = Simple RAID, OtherRegisteredOrganization = DCIM, RegisteredVersion = 1.0.0 9.
http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/DCIM_PhysicalDiskView?__cimnamespace=root/dcim The instance information of all available physical disks will be returned 9.6 Apply pending values for a particular RAID configuration A) To invoke the CreateTargetedConfigJob( ) method, construct input parameters per Table 39 and use the RAID FQDD from section Error! Reference source not found. B) INVOKE CreateTargetedConfigJob( ) method Class URI: http://schemas.dmtf.
9.9 Determine available RAID configurations for a given set of disks A) To invoke the GetRAIDLevels( ) method, construct input parameters per Table 22 and use the desired RAID FQDDs from Section Error! Reference source not found. B) INVOKE GetRAIDLevels( ) method Class URI: http://schemas.dmtf.
B) Select physical disks for RAID configuration from Section Error! Reference source not found. C) Check available sizes and default virtual disk parameters in Section Error! Reference ource not found. D) To invoke the createVirtualDisk( ) method, construct input parameters per Table 16 and use the particular RAID FQDDs from Section Error! Reference source not found. E) INVOKE createVirtualDisk( ) method Class URI: http://schemas.dmtf.
http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_RAIDService?SystemCreationClassName=DCIM_ComputerS ystem+CreationClassName=DCIM_RAIDService+SystemName=DCIM:ComputerSystem +Name=DCIM:RAIDService E) Examine output parameters per Table 2 F) Apply the pending values (Section Error! Reference source not found.) using the FQDD btained from Section Error! Reference source not found.
C) Examine output parameters per Table 5 D) Apply the pending values (Section Error! Reference source not found.) using the FQDD btained from Section Error! Reference source not found. E) Allow several minutes for the UEFI to execute the SSIB task, which will be followed by an automatic reboot of the system F) Confirm successful execution of the method by listing the virtual disks and physical disks, per Section Error! Reference source not found. and Section Error! Reference source not und., respectively.
Table 43 – CIM Elements: RAID ProfileRAID profile Element Name Requirement Description DCIM_RAIDService Mandatory See section 10.1 DCIM_ControllerView Mandatory See section 10.2 DCIM_EnclosureView Mandatory See section 10.3 DCIM_VirtualDiskView Mandatory See section 10.4 DCIM_PhysicalDiskView Mandatory See section 10.5 DCIM_LCElementConformsToProfile Mandatory See section 10.6 DCIM_LCRegisteredProfile Mandatory See section 10.6 Classes Indications None defined in this profile 10.
Table 45 – Class: DCIM_ControllerView Properties Notes Mandatory FQDD Mandatory PrimaryStatus Mandatory RollupStatus ControllerFirmwareVersion PCISlot Bus Device Function PCIVendorID PCISubVendorID PCIDeviceID PCISubDeviceID DeviceCardManufacturer Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory DeviceCardDataBusWidth Mandatory DeviceCardSlotLength Mandatory DeviceCardSlotType Optional SecurityStatus ProductName SASAddress 10.
Mandatory RollupStatus Connector WiredOrder ServiceTag AssetTag Version SlotCount EMMCount PSUCount FanCount TempProbeCount ProductName 10.
Size Stripe Size Name Span Length Numberof Spans Physical Disk IDs Virtual Disk Target ID RemainingRedundancy Mandatory Mandatory Optional Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory DiskCachePolicy Mandatory ObjectStatus 10.
Mandatory BusProtocol Mandatory HotSpareStatus Mandatory PredictiveFailureState Optional SecurityState Mandatory MediaType Protocol: Unknown, SCSI, PATA, FIBRE, USB, SATA, SAS Hotspare Status: No, Dedicated, Global Smart alert: Smart Alert Absent, Smart Alert Present Security State: Unknown, Secured, Locked, Foreign Drive media type: Magnetic Drive, Solid State Drive FreeSize Mandatory Free space available for use by a virtual disk UsedSize Mandatory Space already Consumed by Virtual Disks Speed di
ANNEX A (informative) Related MOF Files Dell Tech Center MOF Library: http://www.delltechcenter.com/page/DCIM.Library.MOF Related Managed Object Format (MOF) files: DCIM_ControllerView.mof DCIM_EnclosureView.mof DCIM_PhysicalDiskView.mof DCIM_RAIDService.mof DCIM_VirtualDiskView.mof DCIM_LCElementConformsToProfile.mof DCIM_LCRegisteredProfile.