1 tony 1.1 // ===================================================================
2 // Title: Core Storage Extents 2.8
3 // Filename: Core28_StorageExtent.mof
4 // Version: 2.8
5 // Status: Final
6 // Date: Jan 26, 2004
7 // ===================================================================
8 // Copyright 2000-2003 Distributed Management Task Force, Inc. (DMTF).
9 // All rights reserved.
10 // DMTF is a not-for-profit association of industry members dedicated
11 // to promoting enterprise and systems management and interoperability.
12 // DMTF specifications and documents may be reproduced for uses
13 // consistent with this purpose by members and non-members,
14 // provided that correct attribution is given.
15 // As DMTF specifications may be revised from time to time,
16 // the particular version and release date should always be noted.
17 //
18 // Implementation of certain elements of this standard or proposed
19 // standard may be subject to third party patent rights, including
20 // provisional patent rights (herein "patent rights"). DMTF makes
21 // no representations to users of the standard as to the existence
22 tony 1.1 // of such rights, and is not responsible to recognize, disclose, or
23 // identify any or all such third party patent right, owners or
24 // claimants, nor for any incomplete or inaccurate identification or
25 // disclosure of such rights, owners or claimants. DMTF shall have no
26 // liability to any party, in any manner or circumstance, under any
27 // legal theory whatsoever, for failure to recognize, disclose, or
28 // identify any such third party patent rights, or for such party's
29 // reliance on the standard or incorporation thereof in its product,
30 // protocols or testing procedures. DMTF shall have no liability to
31 // any party implementing such standard, whether such implementation
32 // is foreseeable or not, nor to any patent owner or claimant, and shall
33 // have no liability or responsibility for costs or losses incurred if
34 // a standard is withdrawn or modified after publication, and shall be
35 // indemnified and held harmless by any party implementing the
36 // standard from any and all claims of infringement by a patent owner
37 // for such implementations.
38 //
39 // For information about patents held by third-parties which have
40 // notified the DMTF that, in their opinion, such patent may relate to
41 // or impact implementations of DMTF standards, visit
42 // http://www.dmtf.org/about/policies/disclosures.php.
43 tony 1.1 // ===================================================================
44 // Description: The Core Model defines basic management concepts.
45 // This file defines the concepts and classes to model
46 // a type of LogicalDevice, StorageExtents.
47 //
48 // The object classes below are listed in an order that
49 // avoids forward references. Required objects, defined
50 // by other working groups, are omitted.
51 // ==================================================================
52 // Change Log for v2.8 Final
53 // CR1210 - Removal of experimental Qualifiers for core.
54 //
55 // Change Log for v2.8 Preliminary
56 // CR978 - Promote NoSinglePointOfFailure, DataRedundancy, and
57 // SpindleRedundancy from StorageVolue to StorageExtent.
58 // CR1019 - CIM Versioning for 2.8 Preliminary
59 // CR1044 - Add StorageExtent.Primordial
60 //
61 // Change Log for v2.7 Final
62 // CR967 - Add values "DMTF reserved" and "Vendor reserved" to
63 // StorageExtent.ExtentStatus.
64 tony 1.1 // CR968 - Remove the Experimental qualifier
65 //
66 // Change Log for v2.7
67 // CR722 - Add StorageExtent.ExtentStatus
68 // CR775 - StorageExtent.NoSinglePointOfFailure, StorageExtent.
69 // DataRedundancy, StorageExtent.SpindleRedundancy
70 // CR777 - Add StorageExtent.DeltaReservation
71 // CR862 - Define StorageExtent.ExtentStatus as an array
72 // CR884 - Move RAID centric properties from StorageExtent to
73 // StorageVolume
74 // ==================================================================
75
76 #pragma locale ("en_US")
77
78
79 // ===================================================================
80 // StorageExtent
81 // ===================================================================
82 [Version ( "2.8.0" ), Description (
83 "StorageExtent describes the capabilities and management of the "
84 "various media that exist to store data and allow data "
85 tony 1.1 "retrieval. This superclass could be used to represent the "
86 "various components of RAID (Hardware or Software) or as a raw "
87 "logical extent on top of physical media.")]
88 class CIM_StorageExtent : CIM_LogicalDevice {
89
90 [Description (
91 "Type of data organization used."),
92 ValueMap { "0", "1", "2", "3", "4" },
93 Values { "Other", "Unknown", "Fixed Block", "Variable Block",
94 "Count Key Data" }]
95 uint16 DataOrganization;
96
97 [Description (
98 "A free form string describing the media and/or its use."),
99 MappingStrings { "MIB.IETF|HOST-RESOURCES-MIB.hrStorageDescr" }]
100 string Purpose;
101
102 [Description (
103 "Access describes whether the media is readable (value=1), "
104 "writeable (value=2), or both (value=3). \"Unknown\" (0) and "
105 "\"Write Once\" (4) can also be defined."),
106 tony 1.1 ValueMap { "0", "1", "2", "3", "4" },
107 Values { "Unknown", "Readable", "Writeable",
108 "Read/Write Supported", "Write Once" }]
109 uint16 Access;
110
111 [Description (
112 "ErrorMethodology is a free-form string describing the type "
113 "of error detection and correction supported by this "
114 "StorageExtent.")]
115 string ErrorMethodology;
116
117 [Description (
118 "Size in bytes of the blocks which form this StorageExtent. "
119 "If variable block size, then the maximum block size in "
120 "bytes should be specified. If the block size is unknown or "
121 "if a block concept is not valid (for example, for "
122 "AggregateExtents, Memory or LogicalDisks), enter a 1."),
123 Units ( "Bytes" ),
124 MappingStrings { "MIF.DMTF|Host Storage|001.4",
125 "MIB.IETF|HOST-RESOURCES-MIB.hrStorageAllocationUnits",
126 "MIF.DMTF|Storage Devices|001.5" }]
127 tony 1.1 uint64 BlockSize;
128
129 [Description (
130 "Total number of logically contiguous blocks, of size Block "
131 "Size, which form this Extent. The total size of the Extent "
132 "can be calculated by multiplying BlockSize by "
133 "NumberOfBlocks. If the BlockSize is 1, this property is the "
134 "total size of the Extent."),
135 MappingStrings { "MIF.DMTF|Host Storage|001.5",
136 "MIB.IETF|HOST-RESOURCES-MIB.hrStorageSize" }]
137 uint64 NumberOfBlocks;
138
139 [Description (
140 "The maximum number of blocks, of size BlockSize, which are "
141 "available for consumption when layering StorageExtents "
142 "using the BasedOn association. This property only has "
143 "meaning when this StorageExtent is an Antecedent reference "
144 "in a BasedOn relationship. For example, a StorageExtent "
145 "could be composed of 120 blocks. However, the Extent itself "
146 "may use 20 blocks for redundancy data. If another "
147 "StorageExtent is BasedOn this Extent, only 100 blocks would "
148 tony 1.1 "be available to it. This information ('100 blocks is "
149 "available for consumption') is indicated in the "
150 "ConsumableBlocks property.")]
151 uint64 ConsumableBlocks;
152
153 [Description (
154 "True indicates that the underlying StorageExtent(s) "
155 "participate in a StorageRedundancyGroup.")]
156 boolean IsBasedOnUnderlyingRedundancy;
157
158 [Description (
159 "Boolean set to TRUE if the Storage is sequentially accessed "
160 "by a MediaAccessDevice. A TapePartition is an example of a "
161 "sequentially accessed StorageExtent. StorageVolumes, Disk "
162 "Partitions and LogicalDisks represent randomly accessed "
163 "Extents.")]
164 boolean SequentialAccess;
165
166 [Description (
167 "StorageExtents have additional status information beyond "
168 "that captured in the OperationalStatus and other "
169 tony 1.1 "properties, inherited from ManagedSystemElement. This "
170 "additional information (for example, \"Protection "
171 "Disabled\", value=9) is captured in the VolumeStatus "
172 "property."),
173 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
174 "10", "11", "12", "13", "14", "15..32767", "32768..65535" },
175 Values { "Other", "Unknown", "None/Not Applicable", "Broken",
176 "Data Lost", "Dynamic Reconfig", "Exposed",
177 "Fractionally Exposed", "Partially Exposed",
178 "Protection Disabled", "Readying", "Rebuild", "Recalculate",
179 "Spare in Use", "Verify In Progress", "DMTF Reserved",
180 "Vendor Reserved" }]
181 uint16 ExtentStatus[];
182
183 [Description (
184 "Indicates whether or not there exists no single point of "
185 "failure."),
186 ModelCorrespondence {
187 "CIM_StorageSetting.NoSinglePointOfFailure" }]
188 boolean NoSinglePointOfFailure;
189
190 tony 1.1 [Description (
191 "Number of complete copies of data currently maintained."),
192 ModelCorrespondence { "CIM_StorageSetting.DataRedundancyGoal",
193 "CIM_StorageSetting.DataRedundancyMax",
194 "CIM_StorageSetting.DataRedundancyMin" }]
195 uint16 DataRedundancy;
196
197 [Description (
198 "How many physical packages can currently fail without data "
199 "loss. For example, in the storage domain, this might be "
200 "disk spindles."),
201 ModelCorrespondence {
202 "CIM_StorageSetting.PackageRedundancyGoal",
203 "CIM_StorageSetting.PackageRedundancyMax",
204 "CIM_StorageSetting.PackageRedundancyMin" }]
205 uint16 PackageRedundancy;
206
207 [Description (
208 "Current value for Delta reservation. This is a percentage "
209 "that specifies the amount of space that should be reserved "
210 "in a replica for caching changes."),
211 tony 1.1 Units ( "Percentage" ), MinValue ( 1 ), MaxValue ( 100 ),
212 ModelCorrespondence { "CIM_StorageSetting.DeltaReservationGoal",
213 "CIM_StorageSetting.DeltaReservationMax",
214 "CIM_StorageSetting.DeltaReservationMin" }]
215 uint8 DeltaReservation;
216
217 [Description (
218 "If true, \"Primordial\" indicates that the containing "
219 "System does not have the ability to create or delete this "
220 "operational element. This is important because "
221 "StorageExtents are assembled into higher-level abstractions "
222 "using the BasedOn association. Although the higher-level "
223 "abstractions can be created and deleted, the most basic, "
224 "(i.e. primordial), hardware-based storage entities cannot. "
225 "They are physically realized as part of the System, or are "
226 "actually managed by some other System and imported as if "
227 "they were physically realized. In other words, a Primordial "
228 "StorageExtent exists in, but is not created by its System "
229 "and conversely a non-Primordial StorageExtent is created in "
230 "the context of its System. For StorageVolumes, this "
231 "property will generally be false. One use of this property "
232 tony 1.1 "is to enable algorithms that aggregate "
233 "StorageExtent.ConsumableSpace across all, StorageExtents "
234 "but that also want to distinquish the space that underlies "
235 "Primordial StoragePools. Since implementations are not "
236 "required to surface all Component StorageExtents of a "
237 "StoragePool, this information is not accessible in any "
238 "other way.")]
239 boolean Primordial=false;
240 };
241
242
243 // ===================================================================
244 // BasedOn
245 // ===================================================================
246 [Association, Version ( "2.6.0" ), Description (
247 "BasedOn is an association describing how StorageExtents can be "
248 "assembled from lower level Extents. For example, "
249 "ProtectedSpaceExtents are parts of PhysicalExtents, while "
250 "VolumeSets are assembled from one or more Physical or "
251 "ProtectedSpaceExtents. As another example, CacheMemory can be "
252 "defined independently and realized in a PhysicalElement or can "
253 tony 1.1 "be 'based on' Volatile or NonVolatileStorageExtents.")]
254 class CIM_BasedOn : CIM_Dependency {
255
256 [Override ( "Antecedent" ), Description (
257 "The lower level StorageExtent.")]
258 CIM_StorageExtent REF Antecedent;
259
260 [Override ( "Dependent" ), Description (
261 "The higher level StorageExtent.")]
262 CIM_StorageExtent REF Dependent;
263
264 [Description (
265 "StartingAddress indicates where in lower level storage, the "
266 "higher level Extent begins.")]
267 uint64 StartingAddress;
268
269 [Description (
270 "EndingAddress indicates where in lower level storage, the "
271 "higher level Extent ends. This property is useful when "
272 "mapping non-contiguous Extents into a higher level "
273 "grouping.")]
274 tony 1.1 uint64 EndingAddress;
275
276 [Description (
277 "If there is an order to the BasedOn associations that "
278 "describe how a higher level StorageExtent is assembled, the "
279 "OrderIndex property indicates this. When an order exists, "
280 "the instances of BasedOn with the same Dependent value "
281 "(i.e., the same higher level Extent) should place unique "
282 "values in the OrderIndex property. The lowest value implies "
283 "the first member of the collection of lower level Extents, "
284 "and increasing values imply successive members of the "
285 "collection. If there is no ordered relationship, a value of "
286 "zero should be specified. An example of the use of this "
287 "property is to define a RAID-0 striped array of 3 disks. "
288 "The resultant RAID array is a StorageExtent that is "
289 "dependent on (BasedOn) the StorageExtents that describe "
290 "each of the 3 disks. The OrderIndex of each BasedOn "
291 "association from the disk Extents to the RAID array could "
292 "be specified as 1, 2 and 3 to indicate the order in which "
293 "the disk Extents are used to access the RAID data.")]
294 uint16 OrderIndex;
295 tony 1.1 };
296
297
298 // ===================================================================
299 // end of file
300 // ===================================================================
|