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

  1 a.dunfey 1.1 // ===================================================================
  2              // Title:  Core Software
  3              // $State: Preliminary $
  4              // $Date: 2005/01/05 00:54:00 $
  5              // $Source: /home/dmtf2/dotorg/var/cvs/repositories/dev/Schema/MOF/Core_Software.mof,v $
  6              // $Revision: 1.7 $
  7              // ===================================================================
  8              //#pragma inLine ("Includes/copyright.inc")
  9              // Copyright 1998-2005 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 1.1           }]
254                 string TargetType;
255              
256                    [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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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 a.dunfey 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