1 karl 1.1.2.2 // Copyright (c) 2009 DMTF. All rights reserved.
2 [Version ( "2.22.0" ),
3 UMLPackagePath ( "CIM::Core::Software" ),
4 Description (
5 "A subclass of service which provides methods to install (or "
6 "update) Software Identities in ManagedElements." )]
7 class CIM_SoftwareInstallationService : CIM_Service {
8
9
10 [Description (
11 "This method allows a client application to determine "
12 "whether a specific SoftwareIdentity can be installed (or "
13 "updated) on a ManagedElement. It also allows other "
14 "characteristics to be determined such as whether install "
15 "will require a reboot. In addition a client can check "
16 "whether the SoftwareIdentity can be added "
17 "simulataneously to a specified "
18 "SofwareIndentityCollection. A client MAY specify either "
19 "or both of the Collection and Target parameters. The "
20 "Collection parameter is only supported if "
21 "SoftwareInstallationServiceCapabilities.CanAddToCollection "
22 karl 1.1.2.2 "is TRUE." ),
23 ValueMap { "0", "1", "2", "3", "4", "5", "6", "..", "4096",
24 "4097", "4098", "4099", "4100", "4101", "4102", "4103",
25 "4104", "4105", "4106", "4107", "4108", "4109",
26 "4110..32767", "32768..65535" },
27 Values { "Job Completed with No Error", "Not Supported",
28 "Unspecified Error", "Timeout", "Failed",
29 "Invalid Parameter", "Target In Use", "DMTF Reserved",
30 "Method Reserved", "Unsupported TargetType",
31 "Unattended/silent installation not supported",
32 "Downgrade/reinstall not supported", "Not enough memory",
33 "Not enough swap-space", "Unsupported version transition",
34 "Not enough disk space",
35 "Software and target operating system mismatch",
36 "Missing dependencies", "Not applicable to target",
37 "No supported path to image", "Cannot add to Collection",
38 "Asynchronous Job already in progress", "Method Reserved",
39 "Vendor Specific" }]
40 uint32 CheckSoftwareIdentity(
41 [IN, Description (
42 "Reference to the SoftwareIdentity to be checked." )]
43 karl 1.1.2.2 CIM_SoftwareIdentity REF Source,
44 [IN, Description (
45 "Reference to the ManagedElement that the Software "
46 "Identity is going to be installed in (or updated)." )]
47 CIM_ManagedElement REF Target,
48 [IN, Description (
49 "Reference to the Collection to which the Software "
50 "Identity will be added." )]
51 CIM_Collection REF Collection,
52 [IN ( false ), OUT, Description (
53 "The parameter describes the characteristics of the "
54 "installation/update that will take place if the "
55 "Source Software Identity is installed: \n"
56 "Target automatic reset: The target element will "
57 "automatically reset once the installation is "
58 "complete. \n"
59 "System automatic reset: The containing system of "
60 "the target ManagedElement (normally a logical "
61 "device or the system itself) will automatically "
62 "reset/reboot once the installation is complete. \n"
63 "Separate target reset required: "
64 karl 1.1.2.2 "EnabledLogicalElement.RequestStateChange MUST be "
65 "used to reset the target element after the "
66 "SoftwareIdentity is installed. \n"
67 "Separate system reset required: "
68 "EnabledLogicalElement.RequestStateChange MUST be "
69 "used to reset/reboot the containing system of the "
70 "target ManagedElement after the SoftwareIdentity "
71 "is installed. \n"
72 "Manual Reboot Required: The system MUST be "
73 "manually rebooted by the user. \n"
74 "No reboot required : No reboot is required after "
75 "installation. \n"
76 "User Intervention Recomended : It is recommended "
77 "that a user confirm installation of this "
78 "SoftwareIdentity. Inappropriate application MAY "
79 "have serious consequences. \n"
80 "MAY be added to specified collection : The "
81 "SoftwareIndentity MAY be added to specified "
82 "Collection." ),
83 ValueMap { "2", "3", "4", "5", "6", "7", "8", "9",
84 "..", "0x7FFF..0xFFFF" },
85 karl 1.1.2.2 Values { "Target automatic reset",
86 "System automatic reset",
87 "Separate target reset Required",
88 "Separate system reset Required",
89 "Manual Reboot Required", "No Reboot Required",
90 "User Intervention recommended",
91 "MAY be added to specified Collection",
92 "DMTF Reserved", "Vendor Specific" }]
93 uint16 InstallCharacteristics[]);
94
95 [Description (
96 "Start a job to install or update a SoftwareIdentity "
97 "(Source) on a ManagedElement (Target). \n"
98 "In addition the method can be used to add the "
99 "SoftwareIdentity simulataneously to a specified "
100 "SofwareIndentityCollection. A client MAY specify either "
101 "or both of the Collection and Target parameters. The "
102 "Collection parameter is only supported if "
103 "SoftwareInstallationServiceCapabilities.CanAddToCollection "
104 "is TRUE. \n"
105 "If 0 is returned, the function completed successfully "
106 karl 1.1.2.2 "and no ConcreteJob instance was required. If 4096/0x1000 "
107 "is returned, a ConcreteJob will be started to perform "
108 "the install. The Job\'s reference will be returned in "
109 "the output parameter Job." ),
110 ValueMap { "0", "1", "2", "3", "4", "5", "6", "..", "4096",
111 "4097", "4098", "4099", "4100", "4101", "4102", "4103",
112 "4104", "4105", "4106", "4107", "4108", "4109..32767",
113 "32768..65535" },
114 Values { "Job Completed with No Error", "Not Supported",
115 "Unspecified Error", "Timeout", "Failed",
116 "Invalid Parameter", "Target In Use", "DMTF Reserved",
117 "Method Parameters Checked - Job Started",
118 "Unsupported TargetType",
119 "Unattended/silent installation not supported",
120 "Downgrade/reinstall not supported", "Not enough memory",
121 "Not enough swap-space", "Unsupported version transition",
122 "Not enough disk space",
123 "Software and target operating system mismatch",
124 "Missing dependencies", "Not applicable to target",
125 "No supported path to image", "Cannot add to Collection",
126 "Method Reserved", "Vendor Specific" }]
127 karl 1.1.2.2 uint32 InstallFromSoftwareIdentity(
128 [IN ( false ), OUT, Description (
129 "Reference to the job (may be null if job completed)."
130 )]
131 CIM_ConcreteJob REF Job,
132 [IN, Description (
133 "Options to control the install process.\n"
134 "Defer target/system reset : do not automatically "
135 "reset the target/system.\n"
136 "Force installation : Force the installation of the "
137 "same or an older SoftwareIdentity. Install: "
138 "Perform an installation of this software on the "
139 "managed element.\n"
140 "Update: Perform an update of this software on the "
141 "managed element.\n"
142 "Repair: Perform a repair of the installation of "
143 "this software on the managed element by forcing "
144 "all the files required for installing the software "
145 "to be reinstalled.\n"
146 "Reboot: Reboot or reset the system immediately "
147 "after the install or update of this software, if "
148 karl 1.1.2.2 "the install or the update requires a reboot or reset.\n"
149 "Password: Password will be specified as clear text "
150 "without any encryption for performing the install "
151 "or update.\n"
152 "Uninstall: Uninstall the software on the managed element.\n"
153 "Log: Create a log for the install or update of the software.\n"
154 "SilentMode: Perform the install or update without "
155 "displaying any user interface.\n"
156 "AdministrativeMode: Perform the install or update "
157 "of the software in the administrative mode. "
158 "ScheduleInstallAt: Indicates the time at which "
159 "theinstall or update of the software will occur." ),
160 ValueMap { "2", "3", "4", "5", "6", "7", "8", "9",
161 "10", "11", "12", "13", "..", "32768..65535" },
162 Values { "Defer target/system reset",
163 "Force installation", "Install", "Update", "Repair",
164 "Reboot", "Password", "Uninstall", "Log",
165 "SilentMode", "AdministrativeMode",
166 "ScheduleInstallAt", "DMTF Reserved",
167 "Vendor Specific" },
168 ArrayType ( "Indexed" ),
169 karl 1.1.2.2 ModelCorrespondence {
170 "CIM_SoftwareInstallationService.InstallOptionsValues[]",
171 "CIM_SoftwareInstallationServiceCapabilities.SupportedInstallOptions[]" }]
172 uint16 InstallOptions[],
173 [IN, Description (
174 "InstallOptionsValues is an array of strings "
175 "providing additional information to InstallOptions "
176 "for the method to install the software. Each entry "
177 "of this array is related to the entry in "
178 "InstallOptions that is located at the same index "
179 "providing additional information for "
180 "InstallOptions. \n"
181 "If the index in InstallOptions has the value "
182 "\"Password \" then a value at the corresponding "
183 "index of InstallOptionValues shall not be NULL. \n"
184 "If the index in InstallOptions has the value "
185 "\"ScheduleInstallAt\" then the value at the "
186 "corresponding index of InstallOptionValues shall "
187 "not be NULL and shall be in the datetime type "
188 "format. \n"
189 "If the index in InstallOptions has the value \"Log "
190 karl 1.1.2.2 "\" then a value at the corresponding index of "
191 "InstallOptionValues may be NULL. \n"
192 "If the index in InstallOptions has the value "
193 "\"Defer target/system reset\", \"Force "
194 "installation\",\"Install\", \"Update\", \"Repair\" "
195 "or \"Reboot\" then a value at the corresponding "
196 "index of InstallOptionValues shall be NULL." ),
197 ArrayType ( "Indexed" ),
198 ModelCorrespondence {
199 "CIM_SoftwareInstallationService.InstallOptions[]" }]
200 string InstallOptionsValues[],
201 [IN, Description (
202 "Reference to the source of the install." )]
203 CIM_SoftwareIdentity REF Source,
204 [IN, Description (
205 "The installation target. If NULL then the "
206 "SOftwareIdentity will be added to Collection only. "
207 "The underlying implementation is expected to be "
208 "able to obtain any necessary metadata from the "
209 "Software Identity." )]
210 CIM_ManagedElement REF Target,
211 karl 1.1.2.2 [IN, Description (
212 "Reference to the Collection to which the Software "
213 "Identity SHALL be added. If NULL then the SOftware "
214 "Identity will not be added to a Collection." )]
215 CIM_Collection REF Collection);
216
217 [Description (
218 "Start a job to install software from a specific URI in a "
219 "ManagedElement. \n"
220 "Note that this method is provided to support existing, "
221 "alternative download mechanisms (such as used for "
222 "firmware download). The \'normal\' mechanism will be to "
223 "use the InstallFromSoftwareIdentity method.\n"
224 "If 0 is returned, the function completed successfully "
225 "and no ConcreteJob instance was required. If 4096/0x1000 "
226 "is returned, a ConcreteJob will be started to to perform "
227 "the install. The Job\'s reference will be returned in "
228 "the output parameter Job." ),
229 ValueMap { "0", "1", "2", "3", "4", "5", "6", "..", "4096",
230 "4097", "4098", "4099", "4100", "4101", "4102", "4103",
231 "4104", "4105", "4106", "4107", "4108..32767",
232 karl 1.1.2.2 "32768..65535" },
233 Values { "Job Completed with No Error", "Not Supported",
234 "Unspecified Error", "Timeout", "Failed",
235 "Invalid Parameter", "Target In Use", "DMTF Reserved",
236 "Method Parameters Checked - Job Started",
237 "Unsupported TargetType",
238 "Unattended/silent installation not supported",
239 "Downgrade/reinstall not supported", "Not enough memory",
240 "Not enough swap-space", "Unsupported version transition",
241 "Not enough disk space",
242 "Software and target operating system mismatch",
243 "Missing dependencies", "Not applicable to target",
244 "URI not accessible", "Method Reserved", "Vendor Specific" }]
245 uint32 InstallFromURI(
246 [IN ( false ), OUT, Description (
247 "Reference to the job (may be null if job completed)."
248 )]
249 CIM_ConcreteJob REF Job,
250 [IN, Description (
251 "A URI for the software based on RFC 2079." )]
252 string URI,
253 karl 1.1.2.2 [IN, Description ( "The installation target." )]
254 CIM_ManagedElement REF Target,
255 [IN, Description (
256 "Options to control the install process. \n"
257 "See the InstallOptions parameter of the "
258 "SoftwareInstallationService.InstallFromSoftwareIdentity "
259 "method for the description of these values." ),
260 ValueMap { "2", "3", "4", "5", "6", "7", "8", "9",
261 "10", "11", "12", "13", "..", "32768..65535" },
262 Values { "Defer target/system reset",
263 "Force installation", "Install", "Update", "Repair",
264 "Reboot", "Password", "Uninstall", "Log",
265 "SilentMode", "AdministrativeMode",
266 "ScheduleInstallAt", "DMTF Reserved",
267 "Vendor Specific" },
268 ArrayType ( "Indexed" ),
269 ModelCorrespondence {
270 "CIM_SoftwareInstallationService.InstallFromURI.InstallOptionsValues[]",
271 "CIM_SoftwareInstallationServiceCapabilities.SupportedInstallOptions[]" }]
272 uint16 InstallOptions[],
273 [IN, Description (
274 karl 1.1.2.2 "InstallOptionsValues is an array of strings "
275 "providing additionalinformation to InstallOptions "
276 "for the method to install the software. Each entry "
277 "of this array is related to the entry in "
278 "InstallOptions that is located at the same index "
279 "providing additional information for "
280 "InstallOptions. \n"
281 "For further information on the use of "
282 "InstallOptionsValues parameter, see the "
283 "description of the InstallOptionsValues parameter "
284 "of the "
285 "SoftwareInstallationService.InstallFromSoftwareIdentity "
286 "method." ),
287 ArrayType ( "Indexed" ),
288 ModelCorrespondence {
289 "CIM_SoftwareInstallationService.InstallFromByteStream.InstallOptions[]" }]
290 string InstallOptionsValues[]);
291
292 };
|
Return to
CIM_SoftwareInstallationService.mof
CVS log
Up to [Pegasus] / pegasus / Schemas / CIM231 / DMTF / Core