Device\CIM_StorageSettingWithHints.mof.mof (HTML version)

Return to index
CIM_StorageSettingWithHints Superclass: CIM_StorageSetting
This subclass of StorageSetting allows a client to specify 'hint's for optimization of the volume performance. The effect of these hints is implementation dependent.
Qualifiers:Version ( "2.7.1" ) UMLPackagePath ( "CIM::Device::StorageServices" )
Parameters (local in grey)
MaxValue ( 10 )
MinValue ( 0 )
Write
uint16 AccessDirectionHint ;
This hint is an indication from a client of the direction of accesses. Values are 0=Entirely Read to 10=Entirely Write.
MaxValue ( 10 )
MinValue ( 0 )
Write
uint16 AccessLatencyHint ;
This hint is an indication from a client how important access latency is. Values are 0=Don't Care to 10=Very Important.
MaxValue ( 10 )
MinValue ( 0 )
Write
uint16 AccessBandwidthWeight ;
This hint is an indication from a client of bandwidth prioritization. Values are 0=Don't Care to 10=Very Important.
MaxValue ( 10 )
MinValue ( 0 )
Write
uint16 StorageCostHint ;
This hint is an indication of the importance the client places on the cost of storage. Values are 0=Don't Care to 10=Very Important. A StorageVolume provider might choose to place data on low cost or high cost drives based on this parameter.
MaxValue ( 10 )
MinValue ( 0 )
Write
uint16 StorageEfficiencyHint ;
This hint is an indication of the importance placed on storage space efficiency by the client. Values are 0=Don't Care to 10=Very Important. A StorageVolume provider might choose different RAID levels based on this hint.
Punit ( "byte" )
Write
Units ( "Bytes" )
uint16 AccessSizeHint [ ] ;
This hint is an indication from a client of the optimal access sizes (in bytes). Since this property is an array, several sizes can be specified.
MaxValue ( 10 )
MinValue ( 0 )
Write
uint16 DataAvailabilityHint ;
This hint is an indication from a client of the importance placed on data availability. Values are 0=Don't Care to 10=Very Important.
MaxValue ( 10 )
MinValue ( 0 )
Write
uint16 AccessRandomnessHint ;
This hint is an indication from a client of the randomness of accesses. Values are 0=Entirely Sequential to 10=Entirely Random.
MinValue ( 1 )
Write
ModelCorrespondence { "CIM_StorageSetting.DataRedundancyMax" , "CIM_StorageSetting.DataRedundancyMin" }
uint16 DataRedundancyGoal ;
DataRedundancyGoal describes the desired number of complete copies of data to be maintained. Examples would be RAID 5 where 1 copy is maintained and RAID 1 where 2 or more copies are maintained. Possible values are 1 to n. The bounds (max and min) for redundancy are defined using the properties, DataRedundancyMax and DataRedundancyMin.
Punit ( "percent" )
MaxValue ( 100 )
MinValue ( 1 )
Write
Units ( "Percentage" )
ModelCorrespondence { "CIM_StorageSetting.DeltaReservationMin" , "CIM_StorageSetting.DeltaReservationMax" }
uint8 DeltaReservationGoal ;
DeltaReservationGoal is a number between 1 (1%) and a 100 (100%) which specifies the desired amount of space that should be reserved in a replica for caching changes. For a complete copy this would be 100%. The bounds (max and min) for the reservation are defined using the properties, DeltaReservationMax and DeltaReservationMin.
Write
ModelCorrespondence { "CIM_StorageSetting.PackageRedundancyMax" , "CIM_StorageSetting.PackageRedundancyGoal" }
uint16 PackageRedundancyMin ;
PackageRedundancyMin describes the minimum number of redundant packages to be used. For example, in the storage domain, package redundancy describes how many disk spindles can fail without data loss including, at most, one spare. An example would be RAID5 with a spare disk which would have a PackageRedundancy of 2. Possible values are 0 to n. The desired redundancy is specified using PackageRedundancyGoal, while the maximum is defined by PackageRedundancyMax.
Experimental
boolean IncrementalDeltas ;
True indicates delta replicas associated with the source element associated with this settingdata are incrementally dependent. Only the oldest replica in the set may be deleted or resynced.
Punit ( "percent" )
MaxValue ( 100 )
MinValue ( 0 )
Units ( "Percentage" )
Experimental
ModelCorrespondence { "CIM_StoragePool.RemainingManagedSpace" }
uint16 LowSpaceWarningThreshold ;
LowSpaceWarningThreshold simplifies the creation of a pool specific Indication based on RemainingManagedSpace <=
(TotalManagedSpace*LowSpaceWarningThreshold)/100. One example client for an Indication based on this property is a delta copy implementation where the pool enables continuous, variable space consumption for the delta storage. Another example client for an Indication based on this property is a provisioning manager implementing a policy for adding storage to a pool when it becomes low.
ValueMap { "1" , "2" , "3" , "4" , "5" , "6" , "7" , "8" , ".." , "32768..65535" }
Values { "Other" , "Unrestricted" , "Reserved for ComputerSystem (the block server)" , "Reserved as a Delta Replica Container" , "Reserved for Migration Services" , "Reserved for Local Replication Services" , "Reserved for Remote Replication Services" , "Reserved for Sparing" , "DMTF Reserved" , "Vendor Reserved" }
Experimental
ModelCorrespondence { "CIM_StoragePool.Usage" }
uint16 StoragePoolInitialUsage ;
The Usage value to be used when creating a new StoragePool.
Write
ModelCorrespondence { "CIM_StorageSetting.PackageRedundancyMax" , "CIM_StorageSetting.PackageRedundancyMin" }
uint16 PackageRedundancyGoal ;
PackageRedundancyGoal describes the desired number of redundant packages to be used. For example, in the storage domain, package redundancy describes how many disk spindles can fail without data loss including, at most, one spare. An example would be RAID5 with a spare disk which would have a PackageRedundancy of 2. Possible values are 0 to n. The bounds (max and min) for redundancy are defined using the properties, PackageRedundancyMax and PackageRedundancyMin.
ValueMap { "0" , "1" , "2" , "3" , "4" , ".." , "0x8000.." }
Values { "Not Applicable" , "Not Managed" , "Low" , "Same" , "High" , "DMTF Reserved" , "Vendor Specific" }
Write
Experimental
ModelCorrespondence { "CIM_StorageReplicationCapabilities.ReplicationPriorityDefault" }
uint16 ReplicationPriority ;
Not Applicable indicates that this property is not applicable to the associated storage element. Other values indicate the relative priority of background Replication I/O operations relative to host I/O operations. These other values are:
- 'Low': Replication engine I/O lower priority than host I/O.
- 'Same': Replication engine I/O has the same priority as host I/O.
- 'High': Replication engine I/O has higher priority than host I/O.
MinValue ( 1 )
Write
ModelCorrespondence { "CIM_StorageSetting.DataRedundancyMax" , "CIM_StorageSetting.DataRedundancyGoal" }
uint16 DataRedundancyMin ;
DataRedundancyMin describes the minimum number of complete copies of data to be maintained. Examples would be RAID 5 where 1 copy is maintained and RAID 1 where 2 or more copies are maintained. Possible values are 1 to n. The desired redundancy is specified using DataRedundancyGoal, while the maximum is defined by DataRedundancyMax.
ValueMap { "1" , "2" , "3" , ".." , "32768..65535" }
Values { "Other" , "Unrestricted" , "Reserved for ComputerSystem (the block server)" , "DMTF Reserved" , "Vendor Reserved" }
Experimental
ModelCorrespondence { "CIM_StorageExtent.Usage" }
uint16 StorageExtentInitialUsage ;
The Usage value to be used when creating a new element that is derived from a StorageExtent.
Punit ( "percent" )
MaxValue ( 100 )
MinValue ( 1 )
Write
Units ( "Percentage" )
ModelCorrespondence { "CIM_StorageSetting.DeltaReservationMin" , "CIM_StorageSetting.DeltaReservationGoal" }
uint8 DeltaReservationMax ;
DeltaReservationMax is a number between 1 (1%) and a 100 (100%) which specifies the maximum amount of space that should be reserved in a replica for caching changes. For a complete copy this would be 100%. The desired reservation is specified using DeltaReservationGoal, while the minimum is defined by DeltaReservationMin.
Punit ( "byte" )
Units ( "Bytes" )
Experimental
uint64 SpaceLimit = 0 ;
SpaceLimit is the consumption limit for the allocated storage element from all associated StoragePools. If asserted, then the assumption is that the storage element can grow, (for instance an element representing the storage for a delta replica).
If SpaceLimit is greater than zero, the space consumed by the storage element shall not exceed the value of SpaceLimit.
If SpaceLimit = 0 (the default) then no limits are asserted on the amount of space consumed.
Punit ( "percent" )
MaxValue ( 100 )
MinValue ( 0 )
Units ( "Percentage" )
Experimental
uint16 SpaceLimitWarningThreshold ;
If the associated storage element may dynamically consume an increasing amount of space and a space limit is enforced on the element, then a non-zero warning threshold percentage indicates when a warning indication should be generated based on the total amount of space consumed being >= (SpaceLimit*SpaceLimitWarningThreshold)/100.
Experimental
boolean PersistentReplica ;
True indicates the associated replicas persist during power off or system reset. False indicates replicas lost during these events.
Punit ( "byte" )
MinValue ( 1 )
Write
Units ( "Bytes" )
ModelCorrespondence { "CIM_StorageSetting.UserDataStripeDepthMax" , "CIM_StorageSetting.UserDataStripeDepth" }
uint64 UserDataStripeDepthMin ;
UserDataStripeDepth describes the number of bytes forming a strip in common striping-based storage organizations. The strip is defined as the size of the portion of a stripe that lies on one extent. Thus, ExtentStripeLength * UserDataStripeDepth will yield the size of one stripe of user data. When used in a goal setting instance, UserDataStripeDepthMin is the minimum acceptable value. The desired Stripe Depth is specified using UserDataStripeDepth, while the maximum is defined by UserDataStripeDepthMax. UserDataStripeDepthMin MUST be set to NULL if the scoping StorageCapablities indicates that it is not supported in this context. If the property is supported, and is part of StorageSettingWithHints it MAY be set to NULL. If used it will constrain the effects of Hint selections. When used in a Setting instance associated to a Volume, this property is set to the specific value of UserDataStripeDepth.
Write
boolean NoSinglePointOfFailure ;
Indicates the desired value for No Single Point of Failure. Possible values are false = single point of failure, and true = no single point of failure.
MinValue ( 1 )
Write
ModelCorrespondence { "CIM_StorageSetting.DataRedundancyMin" , "CIM_StorageSetting.DataRedundancyGoal" }
uint16 DataRedundancyMax ;
DataRedundancyMax describes the maximum number of complete copies of data to be maintained. Examples would be RAID 5 where 1 copy is maintained and RAID 1 where 2 or more copies are maintained. Possible values are 1 to n. The desired redundancy is specified using DataRedundancyGoal, while the minimum is defined by DataRedundancyMin.
ValueMap { "0" , "1" , "2" }
Values { "Fixed - Not Changeable" , "Changeable - Transient" , "Changeable - Persistent" }
Override ( "ChangeableType" )
uint16 ChangeableType ;
Enumeration indicating the type of setting. 'Fixed - Not Changeable' settings are primordial. These setting are defined at the implementor of the class. 'Changeable - Transient' is the type of setting produced by the 'CreateSetting' method. A client can subsequently request that the implementation persist the generated and potentially modified setting indefinately. Only a 'Changeable - Transient' setting SHALL be converted to a 'Changeable = Persistent' setting; the setting SHALL NOT be changed back.
MinValue ( 1 )
Write
ModelCorrespondence { "CIM_StorageSetting.ExtentStripeLengthMin" , "CIM_StorageSetting.ExtentStripeLength" }
uint16 ExtentStripeLengthMax ;
ExtentStripeLength describes the number of underlying StorageExtents across which data is striped in the common striping-based storage organizations. This is also known as the number of 'members' or 'columns'. When used in a goal setting instance, ExtentStripeLengthMax is the maximum acceptable value. The desired Stripe Length is specified using ExtentStripeLength, while the minimum is defined by ExtentStripeLengthMin. ExtentStripeLengthMax MUST be set to NULL if the scoping StorageCapablities indicates that it is not supported in this context. If the property is supported, and is part of StorageSettingWithHints it MAY be set to NULL. If used it will constrain the effects of Hint selections. When used in a Setting instance associated to a Volume, this property is set to the specific value of ExtentStripeLength.
MinValue ( 1 )
Write
ModelCorrespondence { "CIM_StorageSetting.ExtentStripeLengthMax" , "CIM_StorageSetting.ExtentStripeLength" }
uint16 ExtentStripeLengthMin ;
ExtentStripeLength describes the number of underlying StorageExtents across which data is striped in the common striping-based storage organizations. This is also known as the number of 'members' or 'columns'. When used in a goal setting instance, ExtentStripeLengthMin is the minimum acceptable value. The desired Stripe Length is specified using ExtentStripeLength, while the maximum is defined by ExtentStripeLengthMax. ExtentStripeLengthMin MUST be set to NULL if the scoping StorageCapablities indicates that it is not supported in this context. If the property is supported, and is part of StorageSettingWithHints it MAY be set to NULL. If used it will constrain the effects of Hint selections. When used in a Setting instance associated to a Volume, this property is set to the specific value of ExtentStripeLength.
Punit ( "byte" )
MinValue ( 1 )
Write
Units ( "Bytes" )
ModelCorrespondence { "CIM_StorageSetting.UserDataStripeDepthMax" , "CIM_StorageSetting.UserDataStripeDepthMin" }
uint64 UserDataStripeDepth ;
UserDataStripeDepth describes the number of bytes forming a strip in common striping-based storage organizations. The strip is defined as the size of the portion of a stripe that lies on one extent. Thus, ExtentStripeLength * UserDataStripeDepth will yield the size of one stripe of user data. When used in a goal setting instance, UserDataStripeDepth is the optimal desired value. The bounds (max and min) for Stripe Depth are defined using the properties UserDataStripeDepthMax and UserDataStripeDepthMin. UserDataStripeDepth MUST be set to NULL if the scoping StorageCapablities indicates that it is not supported in this context. If the property is supported, and is part of StorageSettingWithHints it MAY be set to NULL. If used it will constrain the effects of Hint selections. When used in a Setting instance associated to a Volume, this property indicates the specific value that the Volume was created with, and UserDataStripeDepthMin and UserDataStripeDepthMax will be set to the same specific value.
Punit ( "byte" )
MinValue ( 1 )
Write
Units ( "Bytes" )
ModelCorrespondence { "CIM_StorageSetting.UserDataStripeDepthMin" , "CIM_StorageSetting.UserDataStripeDepth" }
uint64 UserDataStripeDepthMax ;
UserDataStripeDepth describes the number of bytes forming a strip in common striping-based storage organizations. The strip is defined as the size of the portion of a stripe that lies on one extent. Thus, ExtentStripeLength * UserDataStripeDepth will yield the size of one stripe of user data. When used in a goal setting instance, UserDataStripeDepthMax is the maximum acceptable value. The desired Stripe Depth is specified using UserDataStripeDepthGoal, while the minimum is defined by UserDataStripeDepthMin. UserDataStripeDepthMax MUST be set to NULL if the scoping StorageCapablities indicates that it is not supported in this context. If the property is supported, and is part of StorageSettingwWithHints it MAY be set to NULL. If used it will constrain the effects of Hint selections. When used in a Setting instance associated to a Volume, this property is set to the specific value of UserDataStripeDepth.
ValueMap { "1" , "2" }
Values { "Non-rotated Parity" , "Rotated Parity" }
Write
uint16 ParityLayout ;
ParityLayout specifies whether a parity-based storage organization is using rotated or non-rotated parity. When used in a goal setting instance, ParityLayout is the desired value. It MUST be set to NULL if the scoping StorageCapablities indicates that it is not supported in this context. If the property is supported, and is part of StorageSettingWithHints it MAY be set to NULL. If used it will constrain the effects of Hint selections. When used in a Setting instance associated to a Volume, this property indicates the specific value that the Volume was created with.
Write
ModelCorrespondence { "CIM_StorageSetting.PackageRedundancyMin" , "CIM_StorageSetting.PackageRedundancyGoal" }
uint16 PackageRedundancyMax ;
PackageRedundancyMax describes the maximum number of redundant packages to be used. For example, in the storage domain, package redundancy describes how many disk spindles can fail without data loss including, at most, one spare. An example would be RAID5 with a spare disk which would have a PackageRedundancy of 2. Possible values are 0 to n. The desired redundancy is specified using PackageRedundancyGoal, while the minimum is defined by PackageRedundancyMin.
ValueMap { "0" , "1" , "2" , "3" , ".." , "0x8000.." }
Values { "Not Applicable" , "Not Managed" , "Start" , "Do Not Start" , "DMTF Reserved" , "Vendor Specific" }
Write
Experimental
ModelCorrespondence { "CIM_StorageReplicationCapabilities.InitialSynchronizationDefault" }
uint16 InitialSynchronization = 0 ;
Not Applicable indicates that this property is not applicable to the associated storage element. Other values indicate whether or not a source element should be fully copied to a target element at the time the replication is initiated. The provider does not have to comply with the client request. These other values are defined as:
- 'Not Managed': to start or not at initiation is up to the implementation.
- 'Start': start replication on initiation.
- 'Do Not Start': do not start replication on initiation.
Punit ( "percent" )
MaxValue ( 100 )
MinValue ( 1 )
Write
Units ( "Percentage" )
ModelCorrespondence { "CIM_StorageSetting.DeltaReservationMax" , "CIM_StorageSetting.DeltaReservationGoal" }
uint8 DeltaReservationMin ;
DeltaReservationMin is a number between 1 (1%) and a 100 (100%) which specifies the minimum amount of space that should be reserved in a replica for caching changes. For a complete copy this would be 100%. The desired reservation is specified using DeltaReservationGoal, while the maximum is defined by DeltaReservationMax.
MinValue ( 1 )
Write
ModelCorrespondence { "CIM_StorageSetting.ExtentStripeLengthMax" , "CIM_StorageSetting.ExtentStripeLengthMin" }
uint16 ExtentStripeLength ;
ExtentStripeLength describes the number of underlying StorageExtents across which data is striped in the common striping-based storage organizations. This is also known as the number of 'members' or 'columns'. When used in a goal setting instance, ExtentStripeLength is the optimal desired value. The bounds (max and min) for Stripe Length are defined using the properties ExtentStripeLengthMax and ExtentStripeLengthMin. ExtentStripeLength MUST be set to NULL if the scoping StorageCapablities indicates that it is not supported in this context. ExtentStripeLength can be used in conjunction with CreateOrModifyElementFromELements to explicitly configure storage. An example would be RAID 0+1 with mirroring two stripe sets, each set being three wide. In this case CreateOrModifyElementFromElements would be passed a goal setting with DataRedundancy = 2 and ExtentStripeLength = 3. The size of the InElements array would be 6 and would contain the StorageExtents to be used to construct the StorageElement as a RAID 0+1. ExtentStripeLengthMin and ExtentStripeLengthMax are meaningless and wouldbe set to NULL. If the property is supported, and is part of StorageSettingWithHints it MAY be set to NULL. If used it will constrain the effects of Hint selections. When used in a Setting instance associated to a Volume, this property indicates the specific value that the Volume was created with, and ExtentStripeLengthMin and ExtentStripeLengthMax will be set to the same specific value.
ValueMap { "0" , "1" , "2" , "3" , ".." , "0x8000.." }
Values { "Not Applicable" , "Not Managed" , "Use Buffer" , "Do Not Use Buffer" , "DMTF Reserved" , "Vendor Specific" }
Write
Experimental
ModelCorrespondence { "CIM_StorageReplicationCapabilities.UseReplicationBufferDefault" }
uint16 UseReplicationBuffer = 0 ;
'Not Applicable' indicates that this property is not applicable to the associated storage element. Other values indicate whether or not remote mirror pair created with SynchronizationType 'Async' is allowed to use a write buffer for asynchronous buffering. These other values are defined as:
- 'Not Managed': use or not of the buffer is up to the implementation.
- 'Use Buffer': use of a buffer for logging is required.
- 'Do Not Use Buffer': a buffer for logging shall not be used.
Required
Override ( "ElementName" )
string ElementName ;
The user-friendly name for this instance of SettingData. In addition, the user-friendly name can be used as an index property for a search or query. (Note: The name does not have to be unique within a namespace.)
Experimental
string ConfigurationName ;
An instance of CIM_SettingData may correspond to a well-known configuration that exists for an associated CIM_ManagedElement. If the ConfigurationName property is non-NULL, the instance of CIM_SettingData shall correspond to a well-known configuration for a Managed Element, the value of the ConfigurationName property shall be the name of the configuration, and the ChangeableType property shall have the value 0 or 2. A value of NULL for the ConfigurationName property shall mean that the instance of CIM_SettingData does not correspond to a well-known configuration for a Managed Element or that this information is unknown.
Key
string InstanceID ;
Within the scope of the instantiating Namespace, InstanceID opaquely and uniquely identifies an instance of this class. To ensure uniqueness within the NameSpace, the value of InstanceID should be constructed using the following 'preferred' algorithm:
<OrgID>:<LocalID>
Where <OrgID> and <LocalID> are separated by a colon (:), and where <OrgID> must include a copyrighted, trademarked, or otherwise unique name that is owned by the business entity that is creating or defining the InstanceID or that is a registered ID assigned to the business entity by a recognized global authority. (This requirement is similar to the <Schema Name>_<Class Name> structure of Schema class names.) In addition, to ensure uniqueness, <OrgID> must not contain a colon (:). When using this algorithm, the first colon to appear in InstanceID must appear between <OrgID> and <LocalID>.
<LocalID> is chosen by the business entity and should not be reused to identify different underlying (real-world) elements. If the above 'preferred' algorithm is not used, the defining entity must assure that the resulting InstanceID is not reused across any InstanceIDs produced by this or other providers for the NameSpace of this instance.
For DMTF-defined instances, the 'preferred' algorithm must be used with the <OrgID> set to CIM.
MaxLen ( 64 )
string Caption ;
The Caption property is a short textual description (one- line string) of the object.
string Description ;
The Description property provides a textual description of the object.