Persistent Storage Profile Document Number: DCIM1046 Document Type: Specification Document Status: Published Document Language: E Date: 2012-03-08 Version: 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. © 2010 - 2012 Dell Inc. All rights reserved.
CONTENTS 1 2 3 4 5 6 7 8 9 10 11 Scope .................................................................................................................................................... 5 Normative References........................................................................................................................... 5 Terms and Definitions ...........................................................................................................................
Figures Figure 1 – Persistent Storage Profile: Class Diagram .................................................................................. 9 Tables Table 1 – Related Profiles ............................................................................................................................. 8 Table 2 – CIM Elements: Persistent Storage Profile .................................................................................. 10 Table 3 – DCIM_VFlashView - Operations ...........................
Persistent Storage Profile 1 Scope The Persistent Storage Profile extends the management capabilities of referencing profiles by adding the capability to represent and manage the partitions on the Virtual flash media on Dell platforms. The information in this specification is intended to be sufficient to manage the Persistent Storage feature using the DMTF CIM Schema and Dell extensions to the CIM schema.
3.1 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 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.
3.13 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.14 GET Refers to WS-MAN GET operation as defined in Section 7.3 of DSP00226_V1.1 and Section 7.1 of DSP0227_V1.0 4 Symbols and Abbreviated Terms 4.1 CIM Common Information Model 4.2 iDRAC Integrated Dell Remote Access Controller – management controller for blades and monolithic servers 4.3 CMC Chassis Manager Controller – management controller for the modular chassis 4.
4.9 WBEM Web-Based Enterprise Management 5 Synopsis Profile Name: Persistent Storage Version: 1.0.0 Organization: Dell Inc. CIM Schema Version: 2.26 Experimental Central Class: DCIM_PersistentStorageService Scoping Class: CIM_ComputerSystem The Persistent Storage Profile extends the management capability of the referencing profiles by adding the capability to represent and manage the partitions on the virtual flash media of Dell platforms.
Figure 1 represents the class schema for the Persistent Storage Profile. For simplicity, the prefix CIM_ has been removed from the names of the classes. The vFlash media and its attributes are represented by the DCIM_VFlashView class. Each partition on the vFlash is represented by DCIM_OpaqueManagementData. The DCIM_PersistentStorageService class is used to configure the vFlash and its partitions. The Persistent Storage Profile information is represented with the instance of CIM_RegisteredProfile.
Table 2 – CIM Elements: Persistent Storage Profile Element Name Requirement Description Mandatory The class maybe implemented in the Implementation Namespace. Classes DCIM_PersistentStorageService See sections 7.3 DCIM_VFlashView Mandatory The class shall be implemented in the Implementation Namespace. DCIM_OpaqueManagementData Mandatory The class shall be implemented in the Implementation Namespace.
Operation Name DCIM_PersistentStorageService.InitializeMedia() DCIM_PersistentStorageService.VFlashStateChange() 7.1.3 Requirements Mandatory Mandatory Required Input See section 8.1 See section 8.2 Properties The following table details the implemented properties for DCIM_VFlashView instance representing media storage in a system. The “Requirements” column shall denote the implementation requirement for the corresponding property.
The key properties shall be the SystemCreationClassName, CreationClassName, SystemName, and DeviceID. The instance Resource URI for DCIM_OpaqueManagementData instance shall be: “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_OpaqueManagementData?__cimnamespace=root/dcim +SystemCreationClassName=DCIM_ComputerSystem+CreationClassName= DCIM_OpaqueManagementData+ SystemName= DCIM:ComputerSystem+DeviceID= DCIM_OpaqueManagementData:Partition” 7.2.
Table 6 – Class: DCIM_OpaqueManagementData Properties Requirement Type SystemCreationClassName Mandatory string The property value shall be “DCIM_ComputerSystem”. CreationClassName Mandatory string The property value shall be “DCIM_OpaqueManagementData”. SystemName Mandatory string The property value shall be “DCIM:ComputerSystem”. DeviceID Mandatory string The property value shall be “DCIM_OpaqueManagementData:Partition where is equal to partition index.
Operation Name Get Enumerate Invoke 7.3.3 Requirements Mandatory Mandatory Mandatory Required Input Instance URI Class URI Instance URI Properties The following table details the implemented properties for DCIM_PersistentStorageService instance representing a system in a system. The “Requirement” column shall denote the implementation requirement for the corresponding property.
Operation Name Enumerate 7.4.3 Requirements Mandatory Required Input Class URI Properties The following table details the implemented properties for DCIM_LCRegisteredProfile instance representing Persistent Storage Profile implementation. The “Requirement” column shall denote the implementation requirement for the corresponding property. If the column “Properties” matches the property name, the property shall have the value denoted in the corresponding column “Description”.
Return code values for the InitializeMedia( ) method are specified in Table 11 and parameters are specified in Table 12. Table 11 – InitializeMedia( ) Method: Return Code Values Value Description 2 Failed 4096 Job Created Table 12 – InitializeMedia( ) Method: Parameters Qualifiers Name Type Description/Values OUT Job CIM_Concrete Job REF Returned if job is created.
Table 15 – VFlashStateChange( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ RequestedState Uint32 Shall be set to: 1 (Enable) or 2 (Disable) OUT MessageID String Error MessageID OUT Message String Error Message OUT MessageArguments[] String Error MessageArguments Table 16 – VFlashStateChange( ) Method: Standard Messages MessageID (OUT parameter) Message VF001 The command was successful VF002 General failure VF003 Missing required parameter Reque
Table 18 – CreatePartition( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ PartitionIndex Uint16 The index of the partition that shall have value be between 1 and 16. IN, REQ Size Uint16 The size of the partition that needs to be created in units specified by the SizeUnit parameter. IN, REQ SizeUnit Uint16 The value shall be: 1(MB) or 2(GB). IN, REQ PartitionType Uint16 The value shall be: 1(Floppy) or 2(Hard Disk).
Table 19 – CreatePartition( ) Method: Standard Messages MessageID (OUT parameter) Message JCP017 Maximum job limit reached JCP018 Cannot create new jobs until the existing Export job is completed or deleted. JCP019 Cannot create new jobs until the existing Import job is completed or deleted.
Table 21 – CreatePartitionUsingImage( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ PartitionIndex Uint16 The index of the partition that shall have value be between 1 and 16. IN, REQ PartitionType Uint16 The value shall be: 1(Floppy), 2(Hard Disk), or 3(CDROM) IN, REQ OSVolumeLabel String The value shall be limited to 6 characters. This is the same label which will be seen in the OS after attaching the partition.
MessageID (OUT parameter) Message MessageArguments[] VF004 Invalid value of parameter OSVolumeLabel, PartitionIndex, PartitionType, HashType, ShareType VF012 SD card not present VF013 SD card locked VF015 VFlash not enabled VF016 SD card is read only VF019 Not enough space on SD card VF021 Exceeded maximum partition size VF022 Partition size below minimum VF023 Partition label not unique VF031 Invalid partition label VF032 Invalid partition type VF040 Image hash verifi
Qualifiers Name Type Description/Values OUT MessageArguments[] String Error MessageArguments Table 25 – DeletePartition( ) Method:Standard Messages MessageID (OUT parameter) Message MessageArguments[] VF001 The command was successful VF002 General failure VF004 Invalid value of parameter %s VF012 SD card not present VF013 SD card locked VF015 VFlash not enabled VF017 SD card not initialized VF024 Partition locked VF026 Partition index in use VF027 Partition already attached VF
Table 28 – FormatPartition( ) Method:Standard Messages MessageID (OUT parameter) Message JCP017 Maximum job limit reached JCP018 Cannot create new jobs until the existing Export job is completed or deleted. JCP019 Cannot create new jobs until the existing Import job is completed or deleted.
Qualifiers Name Type Description/Values IN, REQ AccessType Uint16 The value shall be: 1 (Read-Only), or 3(Read-Write) OUT MessageID String Error MessageID OUT Message String Error Message OUT MessageArguments[] String Error MessageArguments Table 31 – ModifyPartition( ) Method:Standard Messages MessageID (OUT parameter) Message MessageArguments[] VF001 The command was successful VF002 General failure VF004 Invalid value of parameter VF012 SD card not present VF013
Qualifiers Name Type Description/Values OUT Job CIM_Concrete Job REF Returned if job is created. OUT MessageID String Error MessageID OUT Message String Error Message OUT MessageArguments[] String Error MessageArguments Table 34 – AttachPartition( ) Method:Standard Messages MessageID (OUT parameter) Message JCP017 Maximum job limit reached JCP018 Cannot create new jobs until the existing Export job is completed or deleted.
Table 36 – DetachPartition( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ PartitionIndex Uint16 The index of the partition that shall have value be between 1 and 16. OUT Job CIM_Concrete Job REF Returned if job is created.
Value Description 4096 Job Created Table 39 – ExportDataFromPartition( ) Method: Parameters Qualifiers Name Type Description/Values IN, REQ PartitionIndex Uint16 The index of the partition that shall have value be between 1 and 16.
9 MessageID (OUT parameter) Message VF016 SD card is read only VF017 SD card not initialized VF018 Partition does not exist VF018 Partition does not exist VF024 Partition locked VF041 Remote mount failed VF042 Remote file missing VF043 Remote file too large VF044 TFTP download failed VF045 FTP download failed VF047 Unsupported SD card VF052 SD card not ready MessageArguments[] Use Cases See Lifecycle Controller (LC) Integration Best Practices Guide.
Class and Method Operation User Privilege Required License Required DCIM_PersistentStorageService. CreatePartitionUsingImage() INVOKE Login, Virtual Media LM_VIRTUAL_FLASH_PART ITIONS DCIM_PersistentStorageService. DeletePartition() INVOKE Login, Virtual Media LM_VIRTUAL_FLASH_PART ITIONS DCIM_PersistentStorageService. FormatPartition() INVOKE Login, Virtual Media LM_VIRTUAL_FLASH_PART ITIONS DCIM_PersistentStorageService.