(file) Return to Core_Software.mof CVS log (file) (dir) Up to [Pegasus] / pegasus / Schemas / CIMPrelim29

  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           // ===================================================================

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2