1 karl 1.1 // ===================================================================
2 // Title: Core Software
3 // $State: Preliminary $
4 // $Date: 2004/06/25 16:11:06 $
5 // $Source: /home/dmtf2/dotorg/var/cvs/repositories/dev/Schema/MOF/Core_Software.mof,v $
6 // $Revision: 1.6 $
7 // ===================================================================
8 //#pragma inLine ("Includes/copyright.inc")
9 // Copyright 1998-2004 Distributed Management Task Force, Inc. (DMTF).
10 // All rights reserved.
11 // DMTF is a not-for-profit association of industry members dedicated
12 // to promoting enterprise and systems management and interoperability.
13 // DMTF specifications and documents may be reproduced for uses
14 // consistent with this purpose by members and non-members,
15 // provided that correct attribution is given.
16 // As DMTF specifications may be revised from time to time,
17 // the particular version and release date should always be noted.
18 //
19 // Implementation of certain elements of this standard or proposed
20 // standard may be subject to third party patent rights, including
21 // provisional patent rights (herein "patent rights"). DMTF makes
22 karl 1.1 // no representations to users of the standard as to the existence
23 // of such rights, and is not responsible to recognize, disclose, or
24 // identify any or all such third party patent right, owners or
25 // claimants, nor for any incomplete or inaccurate identification or
26 // disclosure of such rights, owners or claimants. DMTF shall have no
27 // liability to any party, in any manner or circumstance, under any
28 // legal theory whatsoever, for failure to recognize, disclose, or
29 // identify any such third party patent rights, or for such party's
30 // reliance on the standard or incorporation thereof in its product,
31 // protocols or testing procedures. DMTF shall have no liability to
32 // any party implementing such standard, whether such implementation
33 // is foreseeable or not, nor to any patent owner or claimant, and shall
34 // have no liability or responsibility for costs or losses incurred if
35 // a standard is withdrawn or modified after publication, and shall be
36 // indemnified and held harmless by any party implementing the
37 // standard from any and all claims of infringement by a patent owner
38 // for such implementations.
39 //
40 // For information about patents held by third-parties which have
41 // notified the DMTF that, in their opinion, such patent may relate to
42 // or impact implementations of DMTF standards, visit
43 karl 1.1 // http://www.dmtf.org/about/policies/disclosures.php.
44 //#pragma inLine
45 // http://www.dmtf.org/about/policies/disclosures.php.
46 // ===================================================================
47 // Description: The Core Model defines basic management concepts.
48 // This file defines the SoftwareIdentity class,
49 // representing software assets/inventory/units of
50 // existence.
51 //
52 // The object classes below are listed in an order that
53 // avoids forward references. Required objects, defined
54 // by other working groups, are omitted.
55 // ==================================================================
56 // Change Log for v2.9 Preliminary
57 // CR1352 - Add 'Service/Support Pack' to SoftwareIdentity
58 // classifications
59 // CR1180 - Addition of SoftwareInstallationService and related classes
60 // CR1330 - Addition of SoftwareIdentityComponent association
61 //
62 // Change Log for v2.8 Final
63 // CR1189 - Add SerialNumber property to SoftwareIdentity
64 karl 1.1 // CR1200 - ElementSoftwareIdentity
65 // CR1210 - Removal of experimental Qualifiers for core.
66 //
67 // Change Log for v2.8 Preliminary
68 // CR1019 - CIM Versioning for 2.8 Preliminary
69 // CR1020 - Add ServiceSoftware relationship
70 // CR1049 - Modify the ServiceSoftware association to be
71 // ServiceSoftwareIdentity
72 // CR1098 - Addition of InstalledSoftwareIdentity
73 // CR1131 - Add enumerations to SoftwareIdentity.Classification
74 //
75 // Change Log for v2.7
76 // CR968 - Remove the Experimental qualifier
77 // CR994 - Update the description of InstanceID
78 //
79 // Change Log for v2.7
80 // CR753 - Add SoftwareIdentity
81 // CR904 - Added missing brackets to SoftwareIdentity.
82 // ClassificationDescriptions array
83 // ===================================================================
84
85 karl 1.1 #pragma locale ("en_US")
86
87
88 // ==================================================================
89 // SoftwareIdentity
90 // ==================================================================
91 [Version ( "2.8.1000" ), Description (
92 "SoftwareIdentity represents software, viewed as an asset "
93 "and/or individually identifiable entity (similar to Physical "
94 "Element). It does NOT indicate whether the software is "
95 "installed, executing, etc. (The latter is the role of the "
96 "SoftwareFeature/ SoftwareElement classes and the Application "
97 "Model.) Since software may be acquired, SoftwareIdentity can "
98 "be associated with a Product using the "
99 "ProductSoftwareComponent relationship. \n"
100 "Note that the Application Model manages the deployment and "
101 "installation of software via the classes, SoftwareFeatures and "
102 "SoftwareElements. The deployment/installation concepts are "
103 "related to the asset/identity one. In fact, a SoftwareIdentity "
104 "may correspond to a Product, or to one or more "
105 "SoftwareFeatures or SoftwareElements - depending on the "
106 karl 1.1 "granularity of these classes and the deployment model. The "
107 "correspondence of Software Identity to Product, "
108 "SoftwareFeature or SoftwareElement is indicated using the "
109 "ConcreteIdentity association. Note that there may not be "
110 "sufficient detail or instrumentation to instantiate "
111 "ConcreteIdentity. And, if the association is instantiated, "
112 "some duplication of information may result. For example, the "
113 "Vendor described in the instances of Product and "
114 "SoftwareIdentity MAY be the same. However, this is not "
115 "necessarily true, and it is why vendor and similar information "
116 "are duplicated in this class. \n"
117 "Note that ConcreteIdentity can also be used to describe the "
118 "relationship of the software to any LogicalFiles that result "
119 "from installing it. As above, there may not be sufficient "
120 "detail or instrumentation to instantiate this association.")]
121 class CIM_SoftwareIdentity : CIM_LogicalElement {
122
123 [Key, Description (
124 "Within the scope of the instantiating Namespace, InstanceID "
125 "opaquely and uniquely identifies an instance of this class. "
126 "In order to ensure uniqueness within the NameSpace, the "
127 karl 1.1 "value of InstanceID SHOULD be constructed using the "
128 "following 'preferred' algorithm: \n"
129 "<OrgID>:<LocalID> \n"
130 "Where <OrgID> and <LocalID> are separated by a colon ':', "
131 "and where <OrgID> MUST include a copyrighted, trademarked "
132 "or otherwise unique name that is owned by the business "
133 "entity creating/defining the InstanceID, or is a registered "
134 "ID that is assigned to the business entity by a recognized "
135 "global authority (This is similar to the <Schema "
136 "Name>_<Class Name> structure of Schema class names.) In "
137 "addition, to ensure uniqueness <OrgID> MUST NOT contain a "
138 "colon (':'). When using this algorithm, the first colon to "
139 "appear in InstanceID MUST appear between <OrgID> and "
140 "<LocalID>. \n"
141 "<LocalID> is chosen by the business entity and SHOULD not "
142 "be re-used to identify different underlying (real-world) "
143 "elements. If the above 'preferred' algorithm is not used, "
144 "the defining entity MUST assure that the resultant "
145 "InstanceID is not re-used across any InstanceIDs produced "
146 "by this or other providers for this instance's NameSpace. \n"
147 "For DMTF defined instances, the 'preferred' algorithm MUST "
148 karl 1.1 "be used with the <OrgID> set to 'CIM'.")]
149 string InstanceID;
150
151 [Description (
152 "The major number component of the software's version "
153 "information - for example, '12' from version 12.1(3)T. This "
154 "property is defined as a numeric value to allow the "
155 "determination of 'newer' vs. 'older' releases. A 'newer' "
156 "major release is indicated by a larger numeric value.")]
157 uint16 MajorVersion;
158
159 [Description (
160 "The minor number component of the software's version "
161 "information - for example, '1' from version 12.1(3)T. This "
162 "property is defined as a numeric value to allow the "
163 "determination of 'newer' vs. 'older' releases. A 'newer' "
164 "minor release is indicated by a larger numeric value.")]
165 uint16 MinorVersion;
166
167 [Description (
168 "The revision or maintenance release component of the "
169 karl 1.1 "software's version information - for example, '3' from "
170 "version 12.1(3)T. This property is defined as a numeric "
171 "value to allow the determination of 'newer' vs. 'older' "
172 "releases. A 'newer' revision is indicated by a larger "
173 "numeric value.")]
174 uint16 RevisionNumber;
175
176 [Description (
177 "The build number of the software.")]
178 uint16 BuildNumber;
179
180 [Description (
181 "A string representing the complete software version "
182 "information - for example, '12.1(3)T'. This string and the "
183 "numeric major/minor/revision/build properties are "
184 "complementary. Since vastly different representations and "
185 "semantics exist for versions, it is not assumed that one "
186 "representation is sufficient to permit a client to perform "
187 "computations (i.e., the values are numeric) and a user to "
188 "recognize the software's version (i.e., the values are "
189 "understandable and readable). Hence, both numeric and "
190 karl 1.1 "string representations of version are provided.")]
191 string VersionString;
192
193 [Description (
194 "Specifies the target operating systems of the software. Due "
195 "to the extreme variability in operating systems, this "
196 "property is defined as a string array.")]
197 string TargetOperatingSystems[];
198
199 [Description (
200 "Manufacturer of this software.")]
201 string Manufacturer;
202
203 [Description (
204 "The language editions supported by the software. The "
205 "language codes defined in ISO 639 should be used.")]
206 string Languages[];
207
208 [Description (
209 "An array of enumerated integers that classify this "
210 "software. For example, the software MAY be instrumentation "
211 karl 1.1 "(value=5) or firmware and diagnostic software (10 and 7). "
212 "The use of value 6, Firmware/BIOS, is being deprecated. "
213 "Instead, either the value 10 (Firmware) and/or 11 "
214 "(BIOS/FCode) SHOULD be used."),
215 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
216 "10", "11", "12", "..", "0x8000..0xFFFF" },
217 Values { "Unknown", "Other", "Driver", "Configuration Software",
218 "Application Software", "Instrumentation", "Firmware/BIOS",
219 "Diagnostic Software", "Operating System", "Middleware",
220 "Firmware", "BIOS/FCode", "Support/Service Pack",
221 "DMTF Reserved", "Vendor Reserved" }, ArrayType ( "Indexed" ),
222 ModelCorrespondence {
223 "CIM_SoftwareIdentity.ClassificationDescriptions" }]
224 uint16 Classifications[];
225
226 [Description (
227 "An array of free-form strings providing more detailed "
228 "explanations for any of the entries in the Classifications "
229 "array. Note that each entry is related to one in the "
230 "Classifications array located at the same index."),
231 ArrayType ( "Indexed" ),
232 karl 1.1 ModelCorrespondence { "CIM_SoftwareIdentity.Classifications" }]
233 string ClassificationDescriptions[];
234
235 [Description (
236 "A manufacturer-allocated number used to identify the "
237 "software.")]
238 string SerialNumber;
239
240 [Experimental, Description (
241 "An application specific invariant identifier that will be "
242 "consistent between versions of a SoftwareIdentity. It will "
243 "also be consistent across more major changes to the "
244 "Software Identity naming structure. The purpose of the "
245 "parameter is to allows Software Identities to be selected "
246 "by a client that are compatible with a specific "
247 "SoftwareInstallationService. A client uses this parameter "
248 "to select candidate Software Identities by comparing "
249 "TargetType with the contents of the SupportedTargetTypes "
250 "parameter in SoftwareInstallationServiceCapabilities."),
251 ModelCorrespondence {
252 "CIM_SoftwareInstallationServiceCapabilities.SupportedTargetTypes"
253 karl 1.1 }]
254 string TargetType;
255
256 [Experimental, Description (
257 "The date the software was released.")]
258 datetime ReleaseDate;
259 };
260
261 // ==================================================================
262 // SoftwareIdentityCollection
263 // ==================================================================
264 [Experimental, Version ( "2.8.1000" ), Description (
265 "A subclass of SystemSpecificCollection which collects together "
266 "Software Identities for a single system, to be managed or "
267 "manipulated together. The collection MAY be populated as "
268 "software is downloaded using the SoftwareInstallationService "
269 "or MAY be automatically populated by the management system "
270 "from, say, a web service.")]
271 class CIM_SoftwareIdentityCollection : CIM_SystemSpecificCollection {
272 };
273
274 karl 1.1 // ==================================================================
275 // SoftwareInstallationServiceCapabilities
276 // ==================================================================
277 [Experimental, Version ( "2.8.1000" ), Description (
278 "A subclass of capabilities that defines the capabilities of a "
279 "SoftwareInstallationService. A single instance of "
280 "SoftwareInstallationServiceCapabilities is associated with a "
281 "SoftwareInstallationService using ElementCapabilities.")]
282 class CIM_SoftwareInstallationServiceCapabilities : CIM_Capabilities {
283
284 [Required, Description (
285 "Enumeration indicating what operations will be executed as "
286 "asynchronous jobs. If an operation is included in both this "
287 "and SupportedSynchronousActions then the underlying "
288 "implementation is indicating that it may or may not create "
289 "a job. If a Job is created, then the methods in "
290 "SoftwareInstallationService return a reference to that Job "
291 "as the Job parameter."),
292 ValueMap { "2", "3", "4", "5" },
293 Values { "None supported", "Install From Software Identity",
294 "Install from ByteStream", "Install from URI" },
295 karl 1.1 ModelCorrespondence {
296 "CIM_SoftwareInstallationServiceCapabilities.SupportedSynchronousActions"
297 }]
298 uint16 SupportedAsynchronousActions[];
299
300 [Required, Description (
301 "Enumeration indicating what operations will be executed "
302 "without the creation of a job. If an operation is included "
303 "in both this and SupportedAsynchronousActions then the "
304 "underlying instrumentation is indicating that it may or may "
305 "not create a job."),
306 ValueMap { "2", "3", "4","5" },
307 Values { "None supported", "Install From Software Identity",
308 "Install from ByteStream", "Install from URI" },
309 ModelCorrespondence {
310 "CIM_SoftwareInstallationServiceCapabilities.SupportedAsynchronousActions"
311 }]
312 uint16 SupportedSynchronousActions[];
313
314 [Required, Description (
315 "An array containing a list of SoftwareIdentity.TargetType "
316 karl 1.1 "properties that this service 'knows' how to install. "
317 "TargetType is an application specific string which is "
318 "invariant across version or name changes of the "
319 "SoftwareIdentity and so can be used by a client to select "
320 "Software Identities compatible with this service."),
321 ModelCorrespondence { "CIM_SoftwareIdentity.TargetType" }]
322 string SupportedTargetTypes[];
323
324 [Required, Description (
325 "This property indicates whether "
326 "SoftwareInstallationService.InstallFromSoftwareIdentity "
327 "supports adding a SoftwareIdentity to a "
328 "SoftwareIdentityCollection.")]
329 boolean CanAddToCollection;
330
331 };
332
333 // ==================================================================
334 // SoftwareInstallationService
335 // ==================================================================
336 [Experimental, Version ( "2.8.1000" ), Description (
337 karl 1.1 "A subclass of service which provides methods to install (or "
338 "update) Software Identities in ManagedElements.")]
339 class CIM_SoftwareInstallationService : CIM_Service {
340
341 [Description (
342 "This method allows a client application to determine "
343 "whether a specific SoftwareIdentity can be installed (or "
344 "updated) on a ManagedElement. It also allows other "
345 "characteristics to be determined such as whether install "
346 "will require a reboot. In addition a client can check "
347 "whether the SoftwareIdentity can be added simulataneously "
348 "to a specified SofwareIndentityCollection. A client MAY "
349 "specify either or both of the Collection and Target "
350 "parameters. The Collection parameter is only supported if "
351 "SoftwareInstallationService.CanAddToCollection is TRUE."),
352 ValueMap { "0", "1", "2", "3", "4", "5", "6", "..",
353 "4096","4097","4098","4099","4100","4101","4102", "4103",
354 "4104", "4105","4106","4107","4108", "4109..32767",
355 "32768..65535" },
356 Values { "Job Completed with No Error", "Not Supported",
357 "Unspecified Error", "Timeout", "Failed",
358 karl 1.1 "Invalid Parameter", "Target In Use", "DMTF Reserved",
359 "Method Reserved", "Unsupported TargetType",
360 "Unattended/silent installation not supported",
361 "Downgrade/reinstall not supported", "Not enough memory",
362 "Not enough swap-space", "Unsupported version transition",
363 "Not enough disk space",
364 "Software and target operating system mismatch",
365 "Missing dependencies", "Not applicable to target",
366 "No supported path to image",
367 "Cannot add to SoftwareIdentityCollection","Method Reserved",
368 "Vendor Specific" }]
369 uint32 CheckSoftwareIdentity(
370 [IN, Description (
371 "Reference to the SoftwareIdentity to be checked.")]
372 CIM_SoftwareIdentity REF Source,
373 [IN, Description (
374 "Reference to the ManagedElement that the Software "
375 "Identity is going to be installed in (or updated).")]
376 CIM_ManagedElement REF Target,
377 [IN, Description (
378 "Reference to the SoftwareIdentityCollection to which the "
379 karl 1.1 "Software Identity will be added.")]
380 CIM_SoftwareIdentityCollection REF Collection,
381 [IN ( false ), OUT, Description (
382 "The parameter describes the characteristics of this "
383 "installation/update: \n"
384 "Target automatic reset: The target element will "
385 "automatically reset once the installation is complete. \n"
386 "System automatic reset: The containing system of the "
387 "target ManagedElement (normally a logical device or the "
388 "system itself) will automatically reset/reboot once the "
389 "installation is complete. \n"
390 "Separate target reset required: "
391 "EnabledLogicalElement.RequestStateChange MUST be used to "
392 "reset the target element after the SoftwareIdentity is "
393 "installed. \n"
394 "Separate system reset required: "
395 "EnabledLogicalElement.RequestStateChange MUST be used to "
396 "reset/reboot the containing system of the target "
397 "ManagedElement after the SoftwareIdentity is installed. "
398 "\nManual Reboot Required: The system MUST be manually "
399 "rebooted by the user. \n"
400 karl 1.1 "No reboot required : No reboot is required after "
401 "installation. \n"
402 "User Intervention Recomended : It is recommended that a "
403 "user confirm installation of this SoftwareIdentity. "
404 "Inappropriate application MAY have serious consequences. "
405 "\nMAY be added to specified collection : The "
406 "SoftwareIndentity MAY be added to specified "
407 "SoftwareIdentityCollection."),
408 ValueMap { "2","3","4","5","6","7","8","9", "..",
409 "0x7FFF..0xFFFF" },
410 Values { "Target automatic reset", "System automatic reset",
411 "Separate target reset Required",
412 "Separate system reset Required",
413 "Manual Reboot Required","No Reboot Required",
414 "User Intervention recommended",
415 "MAY be added to specified Collection", "DMTF Reserved",
416 "Vendor Specific" }]
417 uint16 InstallCharacteristics[]);
418
419 [Description (
420 "Start a job to install or update a SoftwareIdentity "
421 karl 1.1 "(Source) on a ManagedElement (Target). \n"
422 "In addition the method can be used to add the "
423 "SoftwareIdentity simulataneously to a specified "
424 "SofwareIndentityCollection. A client MAY specify either or "
425 "both of the Collection and Target parameters. The "
426 "Collection parameter is only supported if "
427 "SoftwareInstallationService.CanAddToCollection is TRUE. \n"
428 "If 0 is returned, the function completed successfully and "
429 "no ConcreteJob instance was required. If 4096/0x1000 is "
430 "returned, a ConcreteJob will be started to perform the "
431 "install. The Job's reference will be returned in the output "
432 "parameter Job."),
433 ValueMap { "0", "1", "2", "3", "4", "5", "6", "..",
434 "4096","4097","4098","4099","4100","4101","4102", "4103",
435 "4104", "4105","4106","4107","4108", "4109..32767",
436 "32768..65535" },
437 Values { "Job Completed with No Error", "Not Supported",
438 "Unspecified Error", "Timeout", "Failed",
439 "Invalid Parameter", "Target In Use", "DMTF Reserved",
440 "Method Parameters Checked - Job Started",
441 "Unsupported TargetType",
442 karl 1.1 "Unattended/silent installation not supported",
443 "Downgrade/reinstall not supported", "Not enough memory",
444 "Not enough swap-space", "Unsupported version transition",
445 "Not enough disk space",
446 "Software and target operating system mismatch",
447 "Missing dependencies", "Not applicable to target",
448 "No supported path to image",
449 "Cannot add to SoftwareIdentityCollection","Method Reserved",
450 "Vendor Specific" }]
451 uint32 InstallFromSoftwareIdentity(
452 [IN ( false ), OUT, Description (
453 "Reference to the job (may be null if job completed).")]
454 CIM_ConcreteJob REF Job,
455 [IN, Description (
456 "Reference to the source of the install.")]
457 CIM_SoftwareIdentity REF Source,
458 [IN, Description (
459 "The installation target. If NULL then the "
460 "SOftwareIdentity will be added to Collection only. The "
461 "underlying implementation is expected to be able to "
462 "obtain any necessary metadata from the Software "
463 karl 1.1 "Identity.")]
464 CIM_ManagedElement REF Target,
465 [IN, Description (
466 "Reference to the SoftwareIdentityCollection to which the "
467 "Software Identity SHALL be added. If NULL then the "
468 "SOftware Identity will not be added to a Collection.")]
469 CIM_SoftwareIdentityCollection REF Collection);
470
471 [Description (
472 "Start a job to download a series of bytes containing a "
473 "software image to a ManagedElement. \n"
474 "Note that this method is provided to support existing, "
475 "alternative download mechanisms (such as used for firmware "
476 "download). The 'normal' mechanism will be to use the "
477 "InstallFromSoftwareIdentity method. \n"
478 "If 0 is returned, the function completed successfully and "
479 "no ConcreteJob instance was required. If 4096/0x1000 is "
480 "returned, a ConcreteJob will be started to to perform the "
481 "install. The Job's reference will be returned in the output "
482 "parameter Job."),
483 ValueMap { "0", "1", "2", "3", "4", "5", "6", "..",
484 karl 1.1 "4096","4097","4098","4099","4100","4101","4102", "4103",
485 "4104", "4105","4106","4107","4108..32767", "32768..65535" },
486 Values { "Job Completed with No Error", "Not Supported",
487 "Unspecified Error", "Timeout", "Failed",
488 "Invalid Parameter", "Target In Use", "DMTF Reserved",
489 "Method Parameters Checked - Job Started",
490 "Unsupported TargetType",
491 "Unattended/silent installation not supported",
492 "Downgrade/reinstall not supported", "Not enough memory",
493 "Not enough swap-space", "Unsupported version transition",
494 "Not enough disk space",
495 "Software and target operating system mismatch",
496 "Missing dependencies", "Not applicable to target",
497 "No supported path to image", "Method Reserved",
498 "Vendor Specific" }]
499 uint32 InstallFromByteStream(
500 [IN ( false ), OUT, Description (
501 "Reference to the job (may be null if job completed).")]
502 CIM_ConcreteJob REF Job,
503 [IN, Description (
504 "A array of bytes containing the install image."),
505 karl 1.1 OctetString]
506 uint8 Image[],
507 [IN, Description (
508 "The installation target.")]
509 CIM_ManagedElement REF Target );
510
511 [Description (
512 "Start a job to install software from a specific URI in a "
513 "ManagedElement. \n"
514 "Note that this method is provided to support existing, "
515 "alternative download mechanisms (such as used for firmware "
516 "download). The 'normal' mechanism will be to use the "
517 "InstallFromSoftwareIdentity method. \n"
518 "If 0 is returned, the function completed successfully and "
519 "no ConcreteJob instance was required. If 4096/0x1000 is "
520 "returned, a ConcreteJob will be started to to perform the "
521 "install. The Job's reference will be returned in the output "
522 "parameter Job."),
523 ValueMap { "0", "1", "2", "3", "4", "5", "6", "..",
524 "4096","4097","4098","4099","4100","4101","4102", "4103",
525 "4104", "4105","4106","4107", "4108..32767", "32768..65535" },
526 karl 1.1 Values { "Job Completed with No Error", "Not Supported",
527 "Unspecified Error", "Timeout", "Failed",
528 "Invalid Parameter", "Target In Use", "DMTF Reserved",
529 "Method Parameters Checked - Job Started",
530 "Unsupported TargetType",
531 "Unattended/silent installation not supported",
532 "Downgrade/reinstall not supported", "Not enough memory",
533 "Not enough swap-space", "Unsupported version transition",
534 "Not enough disk space",
535 "Software and target operating system mismatch",
536 "Missing dependencies", "Not applicable to target",
537 "URI not accessible", "Method Reserved", "Vendor Specific" }]
538 uint32 InstallFromURI(
539 [IN ( false ), OUT, Description (
540 "Reference to the job (may be null if job completed).")]
541 CIM_ConcreteJob REF Job,
542 [IN, Description (
543 "A URI for the software based on RFC 2079.")]
544 string URI,
545 [IN, Description (
546 "The installation target.")]
547 karl 1.1 CIM_ManagedElement REF Target );
548 };
549
550
551 // ===================================================================
552 // ElementSoftwareIdentity
553 // ===================================================================
554 [Association, Version ( "2.8.0" ), Description (
555 "ElementSoftwareIdentity allows a Managed Element to report its "
556 "software related asset information (firmware, drivers, "
557 "configuration software, and etc.)")]
558 class CIM_ElementSoftwareIdentity : CIM_Dependency {
559
560 [Override ( "Antecedent" ), Description (
561 "A LogicalElement's Software Asset.")]
562 CIM_SoftwareIdentity REF Antecedent;
563
564 [Override ( "Dependent" ), Description (
565 "The ManagedElement that requires or uses the software.")]
566 CIM_ManagedElement REF Dependent;
567
568 karl 1.1 [Description (
569 "Indicates the element's ability to upgrade this software "
570 "asset. \n"
571 "'Resides off element'(2), indicates the persistence of the "
572 "software is outside of the element. Typically for a element "
573 "this software is part of the OperatingSystem is typically "
574 "upgradeable. \n"
575 "'Owner Upgradeable' (3), indicates the persistence of the "
576 "software is on the element and is upgradeable by the owner. "
577 "\n'FactoryUpgradeable' (4),indicates the persistence of the "
578 "software is on the element and is upgradeable by the "
579 "manufacturer. \n"
580 "'Not Upgradeable' (5), indicates the presistence of the "
581 "software is on the element and is not upgradeable. (i.e. "
582 "burned into a non replaceable ROM chip."),
583 ValueMap { "0", "1", "2", "3", "4", "5", "..","0x8000..0xFFFF" },
584 Values { "Unknown", "Other", "Resides off device",
585 "Owner Upgradeable", "Factory Upgradeable","Not Upgradeable",
586 "DMTF Reserved", "Vendor Reserved" },
587 ModelCorrespondence {
588 "CIM_ElementSoftwareIdentity.OtherUpgradeCondition" }]
589 karl 1.1 uint16 UpgradeCondition;
590
591 [Description (
592 "Describes the upgrade condition, when UpgradeCondition is "
593 "set to 1 (\"Other\")."),
594 ModelCorrespondence {
595 "CIM_ElementSoftwareIdentity.UpgradeCondition" }]
596 string OtherUpgradeCondition;
597 };
598
599 // ==================================================================
600 // InstalledSoftwareIdentity
601 // ==================================================================
602 [Association, Version ( "2.8.0" ), Description (
603 "The InstalledSoftwareIdentity association identifies the "
604 "System on which a SoftwareIdentity is installed. This class is "
605 "a corollary to InstalledSoftwareElement, but deals with the "
606 "asset aspects of software (as indicated by SoftwareIdentity), "
607 "versus the deployment aspects (as indicated by "
608 "SoftwareElement).")]
609 class CIM_InstalledSoftwareIdentity {
610 karl 1.1
611 [Key, Description (
612 "The system on which the software is installed.")]
613 CIM_System REF System;
614
615 [Key, Description (
616 "The SoftwareIdentity that is installed.")]
617 CIM_SoftwareIdentity REF InstalledSoftware;
618 };
619
620 // ==================================================================
621 // CIM_SoftwareIdentityComponent
622 // ==================================================================
623 [Association, Experimental, Aggregation, Version ( "2.8.1000" ),
624 Description (
625 "SoftwareIdentities can have an arbitrarily complex hierarchy. "
626 "SoftwareIdentityComponent is used to construct that hierarchy. "
627 "It SHOULD not be used to represent dependency. For example, if "
628 "a 'support pack' represented by a CIM_SoftwareIdentity consist "
629 "of multiple installable software packages then this "
630 "association class enables a management client to determine all "
631 karl 1.1 "the SoftwareIdentities that are be contained in the support "
632 "pack.")]
633 class CIM_SoftwareIdentityComponent : CIM_Component {
634
635 [Override ( "GroupComponent" ), Description (
636 "The container SoftwareIdentity in the association.")]
637 CIM_SoftwareIdentity REF GroupComponent;
638
639 [Override ( "PartComponent" ), Description (
640 "The contained SoftwareIdentity in the association.")]
641 CIM_SoftwareIdentity REF PartComponent;
642 };
643
644 // ===================================================================
645 // end of file
646 // ===================================================================
|