1 tony 1.1 // ===================================================================
2 // Title: Core Storage Extents 2.8
3 // Filename: Core28_StorageExtent.mof
4 // Version: 2.8
5 // Release: Preliminary
6 // Date: 06/04/2003
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 Preliminary
53 // CR978 - Promote NoSinglePointOfFailure, DataRedundancy, and
54 // SpindleRedundancy from StorageVolue to StorageExtent.
55 // CR1019 - CIM Versioning for 2.8 Preliminary
56 // CR1044 - Add StorageExtent.Primordial
57 //
58 // Change Log for v2.7 Final
59 // CR967 - Add values "DMTF reserved" and "Vendor reserved" to
60 // StorageExtent.ExtentStatus.
61 // CR968 - Remove the Experimental qualifier
62 //
63 // Change Log for v2.7
64 tony 1.1 // CR722 - Add StorageExtent.ExtentStatus
65 // CR775 - StorageExtent.NoSinglePointOfFailure, StorageExtent.
66 // DataRedundancy, StorageExtent.SpindleRedundancy
67 // CR777 - Add StorageExtent.DeltaReservation
68 // CR862 - Define StorageExtent.ExtentStatus as an array
69 // CR884 - Move RAID centric properties from StorageExtent to
70 // StorageVolume
71 // ==================================================================
72
73 #pragma locale ("en_US")
74
75
76 // ===================================================================
77 // StorageExtent
78 // ===================================================================
79 [Version ("2.7.1000"), Description (
80 "StorageExtent describes the capabilities and management of the "
81 "various media that exist to store data and allow data "
82 "retrieval. This superclass could be used to represent the "
83 "various components of RAID (Hardware or Software) or as a raw "
84 "logical extent on top of physical media.") ]
85 tony 1.1 class CIM_StorageExtent : CIM_LogicalDevice {
86
87 [Description (
88 "Type of data organization used."),
89 ValueMap {"0", "1", "2", "3", "4"},
90 Values {"Other", "Unknown", "Fixed Block", "Variable Block",
91 "Count Key Data"} ]
92 uint16 DataOrganization;
93
94 [Description (
95 "A free form string describing the media and/or its use."),
96 MappingStrings { "MIB.IETF|HOST-RESOURCES-MIB.hrStorageDescr"} ]
97 string Purpose;
98
99 [Description (
100 "Access describes whether the media is readable (value=1), "
101 "writeable (value=2), or both (value=3). \"Unknown\" (0) "
102 "and \"Write Once\" (4) can also be defined."),
103 ValueMap {"0", "1", "2", "3", "4"},
104 Values {"Unknown", "Readable", "Writeable",
105 "Read/Write Supported", "Write Once"} ]
106 tony 1.1 uint16 Access;
107
108 [Description (
109 "ErrorMethodology is a free-form string describing the type "
110 "of error detection and correction supported by this "
111 "StorageExtent.") ]
112 string ErrorMethodology;
113
114 [Description (
115 "Size in bytes of the blocks which form this StorageExtent. "
116 "If variable block size, then the maximum block size in "
117 "bytes should be specified. If the block size is unknown or "
118 "if a block concept is not valid (for example, for "
119 "AggregateExtents, Memory or LogicalDisks), enter a 1."),
120 Units ("Bytes"),
121 MappingStrings {"MIF.DMTF|Host Storage|001.4",
122 "MIB.IETF|HOST-RESOURCES-MIB.hrStorageAllocationUnits",
123 "MIF.DMTF|Storage Devices|001.5"} ]
124 uint64 BlockSize;
125
126 [Description (
127 tony 1.1 "Total number of logically contiguous blocks, of size Block "
128 "Size, which form this Extent. The total size of the Extent "
129 "can be calculated by multiplying BlockSize by "
130 "NumberOfBlocks. If the BlockSize is 1, this property is "
131 "the total size of the Extent."),
132 MappingStrings {"MIF.DMTF|Host Storage|001.5",
133 "MIB.IETF|HOST-RESOURCES-MIB.hrStorageSize"} ]
134 uint64 NumberOfBlocks;
135
136 [Description (
137 "The maximum number of blocks, of size BlockSize, which are "
138 "available for consumption when layering StorageExtents "
139 "using the BasedOn association. This property only has "
140 "meaning when this StorageExtent is an Antecedent reference "
141 "in a BasedOn relationship. For example, a StorageExtent "
142 "could be composed of 120 blocks. However, the Extent "
143 "itself may use 20 blocks for redundancy data. If another "
144 "StorageExtent is BasedOn this Extent, only 100 blocks would "
145 "be available to it. This information ('100 blocks is "
146 "available for consumption') is indicated in the "
147 "ConsumableBlocks property.") ]
148 tony 1.1 uint64 ConsumableBlocks;
149
150 [Description (
151 "True indicates that the underlying StorageExtent(s) "
152 "participate in a StorageRedundancyGroup.") ]
153 boolean IsBasedOnUnderlyingRedundancy;
154
155 [Description (
156 "Boolean set to TRUE if the Storage is sequentially accessed "
157 "by a MediaAccessDevice. A TapePartition is an example of a "
158 "sequentially accessed StorageExtent. StorageVolumes, Disk "
159 "Partitions and LogicalDisks represent randomly accessed "
160 "Extents.") ]
161 boolean SequentialAccess;
162
163 [Description (
164 "StorageExtents have additional status information beyond "
165 "that captured in the OperationalStatus and other "
166 "properties, inherited from ManagedSystemElement. This "
167 "additional information (for example, \"Protection "
168 "Disabled\", value=9) is captured in the VolumeStatus "
169 tony 1.1 "property."),
170 ValueMap {"0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
171 "10", "11", "12", "13", "14", "15..32767", "32768..65535"},
172 Values {"Other", "Unknown", "None/Not Applicable", "Broken",
173 "Data Lost", "Dynamic Reconfig", "Exposed",
174 "Fractionally Exposed", "Partially Exposed",
175 "Protection Disabled", "Readying", "Rebuild", "Recalculate",
176 "Spare in Use", "Verify In Progress", "DMTF Reserved",
177 "Vendor Reserved"} ]
178 uint16 ExtentStatus[];
179
180 [Experimental, Description (
181 "Indicates whether or not there exists no single point of "
182 "failure."),
183 ModelCorrespondence
184 {"CIM_StorageSetting.NoSinglePointOfFailure"} ]
185 boolean NoSinglePointOfFailure;
186
187 [Experimental, Description (
188 "Number of complete copies of data currently maintained."),
189 ModelCorrespondence {"CIM_StorageSetting.DataRedundancyGoal",
190 tony 1.1 "CIM_StorageSetting.DataRedundancyMax",
191 "CIM_StorageSetting.DataRedundancyMin"} ]
192 uint16 DataRedundancy;
193
194 [Experimental, Description (
195 "How many physical packages can currently fail without data "
196 "loss. For example, in the storage domain, this might be "
197 "disk spindles."),
198 ModelCorrespondence {"CIM_StorageSetting.PackageRedundancyGoal",
199 "CIM_StorageSetting.PackageRedundancyMax",
200 "CIM_StorageSetting.PackageRedundancyMin"} ]
201 uint16 PackageRedundancy;
202
203 [Experimental, Description (
204 "Current value for Delta reservation. This is a percentage "
205 "that specifies the amount of space that should be reserved "
206 "in a replica for caching changes."),
207 Units ("Percentage"), MinValue (1), MaxValue (100),
208 ModelCorrespondence {"CIM_StorageSetting.DeltaReservationGoal",
209 "CIM_StorageSetting.DeltaReservationMax",
210 "CIM_StorageSetting.DeltaReservationMin"} ]
211 tony 1.1 uint8 DeltaReservation;
212
213 [Experimental, Description (
214 "If true, \"Primordial\" indicates that the containing "
215 "System does not have the ability to create or delete this "
216 "operational element. This is important because "
217 "StorageExtents are assembled into higher-level abstractions "
218 "using the BasedOn association. Although the higher-level "
219 "abstractions can be created and deleted, the most basic, "
220 "(i.e. primordial), hardware-based storage entities "
221 "cannot. They are physically realized as part of the "
222 "System, or are actually managed by some other System and "
223 "imported as if they were physically realized. In other "
224 "words, a Primordial StorageExtent exists in, but is not "
225 "created by its System and conversely a non-Primordial "
226 "StorageExtent is created in the context of its System. For "
227 "StorageVolumes, this property will generally be false. One "
228 "use of this property is to enable algorithms that aggregate "
229 "StorageExtent.ConsumableSpace across all, StorageExtents "
230 "but that also want to distinquish the space that underlies "
231 "Primordial StoragePools. Since implementations are not "
232 tony 1.1 "required to surface all Component StorageExtents of a "
233 "StoragePool, this information is not accessible in any "
234 "other way.") ]
235 boolean Primordial=false;
236 };
237
238
239 // ===================================================================
240 // BasedOn
241 // ===================================================================
242 [Association, Version ("2.6.0"), Description (
243 "BasedOn is an association describing how StorageExtents can be "
244 "assembled from lower level Extents. For example, "
245 "ProtectedSpaceExtents are parts of PhysicalExtents, while "
246 "VolumeSets are assembled from one or more Physical or "
247 "ProtectedSpaceExtents. As another example, CacheMemory can be "
248 "defined independently and realized in a PhysicalElement or can "
249 "be 'based on' Volatile or NonVolatileStorageExtents.") ]
250 class CIM_BasedOn : CIM_Dependency {
251
252 [Override ("Antecedent"), Description (
253 tony 1.1 "The lower level StorageExtent.") ]
254 CIM_StorageExtent REF Antecedent;
255
256 [Override ("Dependent"), Description (
257 "The higher level StorageExtent.") ]
258 CIM_StorageExtent REF Dependent;
259
260 [Description (
261 "StartingAddress indicates where in lower level storage, the "
262 "higher level Extent begins.") ]
263 uint64 StartingAddress;
264
265 [Description (
266 "EndingAddress indicates where in lower level storage, the "
267 "higher level Extent ends. This property is useful when "
268 "mapping non-contiguous Extents into a higher level "
269 "grouping.") ]
270 uint64 EndingAddress;
271
272 [Description (
273 "If there is an order to the BasedOn associations that "
274 tony 1.1 "describe how a higher level StorageExtent is assembled, the "
275 "OrderIndex property indicates this. When an order exists, "
276 "the instances of BasedOn with the same Dependent value "
277 "(i.e., the same higher level Extent) should place unique "
278 "values in the OrderIndex property. The lowest value "
279 "implies the first member of the collection of lower level "
280 "Extents, and increasing values imply successive members of "
281 "the collection. If there is no ordered relationship, a "
282 "value of zero should be specified. An example of the use "
283 "of this property is to define a RAID-0 striped array of 3 "
284 "disks. The resultant RAID array is a StorageExtent that is "
285 "dependent on (BasedOn) the StorageExtents that describe "
286 "each of the 3 disks. The OrderIndex of each BasedOn "
287 "association from the disk Extents to the RAID array could "
288 "be specified as 1, 2 and 3 to indicate the order in which "
289 "the disk Extents are used to access the RAID data.") ]
290 uint16 OrderIndex;
291 };
292
293
294 // ===================================================================
295 tony 1.1 // end of file
296 // ===================================================================
|