1 marek 1.1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html><head>
3
4
5
6
7
8
9
10
11
12
13 <meta http-equiv="Content-Language" content="en-us">
14
15
16
17 <meta name="GENERATOR" content="Microsoft FrontPage 6.0">
18
19
20
21 <meta name="ProgId" content="FrontPage.Editor.Document">
22 marek 1.1
23
24
25 <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
26
27
28
29 <title>PEP</title>
30
31
32
33 <link rel="stylesheet" href="PEP351_RuntimePackaging2.10.0-Dateien/info1.htm">
34
35
36 </head><body>
37
38 <hr>
39
40 <p align="center"><b><font size="4">OpenPegasus Packaging Definition for Selected Platforms</font></b></p><b>Table of Contents</b>
41
42
43 marek 1.1
44
45 <dl>
46
47
48 <dd><a href="#SecAbstract">Abstract</a></dd>
49 <dd><a href="#SecProblemDefinition">Definition of the Problem</a></dd>
50 <dd><a href="#SecProposedSolution">Proposed Solution</a></dd>
51 <dl>
52 <dd><a href="#SecDirectoryStructure">OpenPegasus Directory Structure</a></dd>
53 <dd><a href="#SecPackagedFiles">OpenPegasus Packaged Files</a></dd>
54 <dl>
55 <dd><a href="#SecLibraries">Library Files</a></dd>
56 <dl>
57 <dd><a href="#SecLibraryVersioning">Library-level Versioning Strategy</a></dd>
58 <dd><a href="#SecSharedLibraries">OpenPegasus Libraries</a></dd>
59 <dd><a href="#SecProviderManagers">OpenPegasus Provider Managers</a></dd>
60 <dd><a href="#SecProviderLibraries">OpenPegasus Provider Libraries</a></dd>
61 </dl>
62 <dd><a href="#SecExecutables">Executables Files</a></dd>
63 <dl>
64 marek 1.1 <dd><a href="#SecAdminCommands">OpenPegasus Administrative Commands</a></dd>
65 <dd><a href="#SecAdminScripts">OpenPegasus Administrative Scripts</a></dd>
66 <dd><a href="#SecUserCommands">OpenPegasus User Commands</a></dd>
67 </dl>
68 <dd><a href="#SecDocumentation">Documentation Files</a></dd>
69 <dl>
70 <dd><a href="#SecManPages">Unix Style Man Pages</a></dd>
71 </dl>
72 <dd><a href="#SecDataFiles">Data Files</a></dd>
73 <dl>
74 <dd><a href="#SecStaticDataFiles">Static Data Files</a></dd>
75 <dd><a href="#SecVariableDataFiles">Variable Data Files</a></dd>
76 <dd><a href="#SecConfigFiles">OpenPegasus Configuration Files</a></dd>
77 <dd><a href="#SecPAMConfigFiles">PAM Configuration Files</a></dd>
78 </dl>
79 </dl>
80 <dd><a href="#SecBuild">OpenPegasus Build and Install Steps</a><dl>
81 <dd><a href="#SecMkDir">Step 1: Create OpenPegasus Directory Structure</a></dd>
82 <dd><a href="#SecCopyFiles">Step 2: Copy OpenPegasus Files</a></dd>
83 <dd><a href="#SecConfigure">Step 3: Create OpenPegasus Host-Specific Files</a></dd>
84 <dd><a href="#SecRepository">Step 4: Create OpenPegasus Repository</a></dd>
85 marek 1.1 <dd><a href="#SecRepository">Step 5: Update System Files</a></dd>
86 </dl>
87 </dd>
88 </dl>
89
90 <hr>
91 <p><b><a name="SecAbstract"></a>Abstract: </b>This document defines
92 the recommended set of files for inclusion in this release of OpenPegasus.
93 In this version of the document, platform-specific options have been documented for
94 the following platforms: Linux, HP-UX and Open VMS.</p>
95 <p><b>Note 1: </b>The recommendations defined in this document
96 are not intended to document the feature set included in any vendor's
97 OpenPegasus-based product. Rather, the purpose of this document is to provide
98 input to vendors when making product decisions.<br></p>
99 <hr>The purpose of this document is to provide
100 vendors with a recommended set of configuration files, libraries, programs and
101 documentation files for inclusion in an OpenPegasus Release. Please refer
102 to
103 <a href="http://www.openpegasus.org/pp/uploads/40/6930/PEP204_RPMBuildProcess.htm">
104 PEP 204</a> for instructions on creating OpenPegasus Linux binary and source
105 RPMS.<h3><a name="SecEnvironmentVariables"></a>OpenPegasus Configure</h3>
106 marek 1.1
107 <p>Please consult the "Recommended OpenPegasus Build and Configuration
108 Options for Selected Platforms" document, BuildAndReleaseOptions.html ,
109 in the pegasus/doc directory in CVS for the recommended environment and
110 configuration settings for building OpenPegasus. </p>
111
112
113
114 <h3><a name="SecDirectoryStructure"></a>OpenPegasus Directory Structure</h3>
115
116 <p>This section describes the recommended OpenPegasus runtime directory
117 structure. In addition, it describes the recommended directory
118 permissions. </p>
119
120 <p>There are three classes of OpenPegasus runtime directories:</p>
121
122 <ol>
123 <li><b>FIXED LOCATION. </b>Directory locations that are used by the CIM Server
124 and fixed at build time. A rebuild is required to change a FIXED
125 LOCATION directory. The runtime directory structure MUST be consistent
126 with the build time definition of FIXED LOCATION directories. Refer to
127 marek 1.1 PEP 308 for recommended default values.</li>
128 <li><b>CONFIGURABLE LOCATION.</b> Directory locations that are used by the CIM Server
129 and configurable using the cimconfig command. All CONFIGURABLE LOCATION
130 directories are assigned a default value for the directory location. The
131 runtime directory structure WILL assume the default value. Refer to PEP 308 for recommended default values.</li>
132 <li><b>INSTALLATION DEFINED LOCATION. </b>Directory locations that are NOT used by the CIM Server but exist
133 as part of the CIM Server runtime environment. A default location will be
134 defined and used for the directory location.</li>
135 </ol>
136
137 <p> The following default installation directories will change if the PEGASUS_FLAVOR option is set. See <a href="http://www.openpegasus.org/pp/uploads/40/21277/PEP350_MultiCIMOM.htm">PEP#350</a> for more details. <br>
138 </p>
139
140 <ul>
141
142 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="563" height="190">
143 <tbody><tr>
144 <th bgcolor="#cae6ca" width="207" height="37">Document Designation</th>
145 <th bgcolor="#cae6ca" width="118" height="37">Type</th>
146 <th bgcolor="#cae6ca" width="239" height="37">Build Configuration Option</th>
147 </tr>
148 marek 1.1
149 <tr>
150 <td align="center" width="207" height="38">$(PEGASUS_PROD_DIR)</td>
151 <td align="center" width="118" height="38">INSTALLATION</td>
152 <td width="239" height="38"> </td>
153 </tr>
154 <tr align="center">
155 <td width="207" height="29">$(PEGASUS_DEST_LIB_DIR)</td>
156 <td width="118" height="29">INSTALLATION</td>
157 <td width="239" height="29">
158 <p align="left">Link option (e.g., -Wl,+b/opt/wbem/lib:/usr/lib)</p></td>
159 </tr>
160 <tr>
161 <td align="center" width="207" height="27">$(PEGASUS_SBIN_DIR)</td>
162 <td align="center" width="118" height="27">INSTALLATION</td>
163 <td width="239" height="27"> </td>
164 </tr>
165 <tr>
166 <td align="center" width="207" height="33">$(PEGASUS_BIN_DIR)</td>
167 <td align="center" width="118" height="33">INSTALLATION</td>
168 <td width="239" height="33"> </td>
169 marek 1.1 </tr>
170 <tr>
171 <td align="center" width="207" height="33">
172 <p align="center">$(PEGASUS_MAN_DIR)</p></td>
173 <td align="center" width="118" height="33">
174 INSTALLATION</td>
175 <td width="239" height="33">
176 <p align="left">
177 </p></td>
178 </tr>
179 <tr>
180 <td align="center" width="207" height="31">
181 $(PEGASUS_VARDATA_DIR)</td>
182 <td align="center" width="118" height="31">
183 INSTALLATION</td>
184 <td width="239" height="31">
185 </td>
186 </tr>
187 </tbody></table>
188 </ul>
189
190 marek 1.1
191 <p> </p>
192
193
194 <ul>
195
196 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="995" height="411">
197 <tbody><tr>
198 <th rowspan="2" bgcolor="#cae6ca" width="274" height="37">Document
199 Designation<br>
200 Configuration Option</th>
201 <th rowspan="2" bgcolor="#cae6ca" width="75" height="37">Operating System</th>
202 <th rowspan="2" bgcolor="#cae6ca" width="275" height="37">Location</th>
203 <th colspan="3" bgcolor="#cae6ca" width="348" height="16">Directory</th>
204 </tr>
205 <tr>
206 <th bgcolor="#cae6ca" width="89" height="16">Owner<br>
207 Group</th>
208 <th bgcolor="#cae6ca" width="138" height="16">Permissions</th>
209 <th bgcolor="#cae6ca" width="111" height="16">Package<br>
210 Owner</th>
211 marek 1.1 </tr>
212 <tr>
213 <td rowspan="3" align="left" width="274" height="41">$(PEGASUS_BIN_DIR)</td>
214 <td align="center" width="75" height="3">Linux</td>
215 <td align="left" width="275" height="3">/usr/bin</td>
216 <td align="center" width="89" height="3">root/root</td>
217 <td align="center" width="138" height="3">drwxr-xr-x</td>
218 <td align="center" width="111" height="3">System</td>
219 </tr>
220 <tr>
221 <td align="center" width="75" height="14">HP-UX</td>
222 <td align="left" width="275" height="14">/opt/wbem/bin</td>
223 <td align="center" width="89" height="14">bin/bin</td>
224 <td align="center" width="138" height="14">dr-xr-xr-x</td>
225 <td align="center" width="111" height="14">OpenPegasus</td>
226 </tr>
227 <tr>
228 <td align="center" width="75" height="14">OpenVMS</td>
229 <td align="left" width="275" height="14">/opt/wbem/bin</td>
230 <td align="center" width="89" height="14">system</td>
231 <td align="center" width="138" height="14">S:wred,O:re,G:re,W:e</td>
232 marek 1.1 <td align="center" width="111" height="14">OpenPegasus</td>
233 </tr>
234 <tr>
235 <td rowspan="3" align="left" width="274" height="41">$(PEGASUS_CONFIG_DIR)</td>
236 <td align="center" width="75" height="3">Linux</td>
237 <td align="left" width="275" height="3">/etc/Pegasus</td>
238 <td align="center" width="89" height="3">root/pegasus</td>
239 <td align="center" width="138" height="3">drwxr-xr-x</td>
240 <td align="center" width="111" height="3">OpenPegasus</td>
241 </tr>
242 <tr>
243 <td align="center" width="75" height="14">HP-UX</td>
244 <td align="left" width="275" height="14">/etc/opt/wbem</td>
245 <td align="center" width="89" height="14">bin/bin</td>
246 <td align="center" width="138" height="14">dr-xr-xr-x</td>
247 <td align="center" width="111" height="14">OpenPegasus</td>
248 </tr>
249 <tr>
250 <td align="center" width="75" height="14">OpenVMS</td>
251 <td align="left" width="275" height="14">/etc/opt/wbem</td>
252 <td align="center" width="89" height="14">system</td>
253 marek 1.1 <td align="center" width="138" height="14">S:wred,O:re,G:re,W:e</td>
254 <td align="center" width="111" height="14">OpenPegasus</td>
255 </tr>
256
257 <tr align="center">
258 <td rowspan="3" align="left" width="274" height="50">$(PEGASUS_DEST_LIB_DIR)</td>
259 <td width="75" height="13">Linux</td>
260 <td align="left" width="275" height="14">/usr/%{_lib}</td>
261 <td width="89" height="13">root/root</td>
262 <td width="138" height="13">drwxr-xr-x</td>
263 <td width="111" height="13">System</td>
264 </tr>
265 <tr align="center">
266 <td width="75" height="14">HP-UX</td>
267 <td align="left" width="275" height="14">/opt/wbem/lib</td>
268 <td width="89" height="14">bin/bin</td>
269 <td width="138" height="14">dr-xr-xr-x</td>
270 <td width="111" height="14">OpenPegasus</td>
271 </tr>
272 <tr align="center">
273 <td width="75" height="13">OpenVMS</td>
274 marek 1.1 <td align="left" width="275" height="12">/opt/wbem/lib</td>
275 <td width="89" height="13">system</td>
276 <td width="138" height="13">S:wred,O:re,G:re,W:e</td>
277 <td width="111" height="13">OpenPegasus</td>
278 </tr>
279 <tr>
280 <td rowspan="3" align="left" width="274" height="50">$(PEGASUS_MAN_DIR)</td>
281 <td align="center" width="75" height="12">Linux</td>
282 <td align="left" width="275" height="12">/usr/share/man</td>
283 <td align="center" width="89" height="12">root/root</td>
284 <td align="center" width="138" height="12">drwxr-xr-x</td>
285 <td align="center" width="111" height="12">System</td>
286 </tr>
287 <tr>
288 <td align="center" width="75" height="14">HP-UX</td>
289 <td align="left" width="275" height="14">/opt/wbem/share/man</td>
290 <td align="center" width="89" height="14">bin/bin</td>
291 <td align="center" width="138" height="14">dr-xr-xr-x</td>
292 <td align="center" width="111" height="14">OpenPegasus</td>
293 </tr>
294 <tr>
295 marek 1.1 <td align="center" width="75" height="14">OpenVMS</td>
296 <td align="left" width="275" height="14">/opt/wbem/share/man</td>
297 <td align="center" width="89" height="14">system</td>
298 <td align="center" width="138" height="14">S:wred,O:re,G:re,W:e</td>
299 <td align="center" width="111" height="14">OpenPegasus</td>
300 </tr>
301 <tr>
302 <td rowspan="3" align="left" width="274" height="39">$(PEGASUS_PEM_DIR)</td>
303 <td align="center" width="75" height="1">Linux</td>
304 <td align="left" width="275" height="1">/etc/Pegasus</td>
305 <td align="center" width="89" height="1">root/pegasus</td>
306 <td align="center" width="138" height="1">drwxr-xr-x</td>
307 <td align="center" width="111" height="1">OpenPegasus</td>
308 </tr>
309 <tr>
310 <td align="center" width="75" height="14">HP-UX</td>
311 <td align="left" width="275" height="14">/etc/opt/hp/sslshare</td>
312 <td align="center" width="89" height="14">bin/bin</td>
313 <td align="center" width="138" height="14">dr-xr-xr-x</td>
314 <td align="center" width="111" height="14">OpenPegasus</td>
315 </tr>
316 marek 1.1 <tr>
317 <td align="center" width="75" height="15">OpenVMS</td>
318 <td align="left" width="275" height="15"> </td>
319 <td width="89" height="15">
320 <p align="center">system</p></td>
321 <td width="138" height="15">S:wred,O:re,G:re,W:e</td>
322 <td width="111" height="15"><br>
323 </td>
324 </tr>
325 <tr>
326 <td rowspan="3" align="left" width="274" height="38">$(PEGASUS_PROD_DIR)</td>
327 <td align="center" width="75" height="1">Linux</td>
328 <td align="left" width="275" height="1">/usr</td>
329 <td align="center" width="89" height="1">root/root</td>
330 <td align="center" width="138" height="1">drwxr-xr-x</td>
331 <td align="center" width="111" height="1">System</td>
332 </tr>
333 <tr>
334 <td align="center" width="75" height="14">HP-UX</td>
335 <td align="left" width="275" height="14">/opt/wbem</td>
336 <td align="center" width="89" height="14">bin/bin</td>
337 marek 1.1 <td align="center" width="138" height="14">dr-xr-xr-x</td>
338 <td align="center" width="111" height="14">OpenPegasus</td>
339 </tr>
340 <tr>
341 <td align="center" width="75" height="14">OpenVMS</td>
342 <td align="left" width="275" height="14">/opt/wbem</td>
343 <td width="89" height="14">
344 <p align="center">system</p></td>
345 <td width="138" height="14">S:wred,O:re,G:re,W:e</td>
346 <td width="111" height="14">
347 <p align="center">OpenPegasus</p></td>
348 </tr>
349 <tr>
350 <td rowspan="3" align="left" width="274" height="52">$(PEGASUS_PROVIDER_LIB_DIR)</td>
351 <td align="center" width="75" height="14">Linux</td>
352 <td align="left" width="275" height="14">/usr/%{_lib}/Pegasus/providers</td>
353 <td align="center" width="89" height="14">root/pegasus</td>
354 <td align="center" width="138" height="14">drwxr-xr-x</td>
355 <td align="center" width="111" height="14">OpenPegasus</td>
356 </tr>
357 <tr>
358 marek 1.1 <td align="center" width="75" height="14">HP-UX</td>
359 <td align="left" width="275" height="14">/opt/wbem/providers/lib</td>
360 <td align="center" width="89" height="14">bin/bin</td>
361 <td align="center" width="138" height="14">dr-xr-xr-x</td>
362 <td align="center" width="111" height="14">OpenPegasus</td>
363 </tr>
364 <tr>
365 <td width="75" height="14">OpenVMS</td>
366 <td align="left" width="275" height="13">/opt/wbem/providers/lib</td>
367 <td align="center" width="89" height="14">system</td>
368 <td align="center" width="138" height="14">S:wred,O:re,G:re,W:e</td>
369 <td align="center" width="111" height="14">OpenPegasus</td>
370 </tr>
371 <tr>
372 <td rowspan="3" align="left" width="274" height="52">$(PEGASUS_PROVIDER_MANAGER_LIB_DIR)</td>
373 <td align="center" width="75" height="14">Linux</td>
374 <td align="left" width="275" height="14">/usr/%{_lib}/Pegasus/providerManagers</td>
375 <td align="center" width="89" height="14">root/pegasus</td>
376 <td align="center" width="138" height="14">drwxr-xr-x</td>
377 <td align="center" width="111" height="14">OpenPegasus</td>
378 </tr>
379 marek 1.1 <tr>
380 <td align="center" width="75" height="14">HP-UX</td>
381 <td align="left" width="275" height="14"> </td>
382 <td align="center" width="89" height="14"> </td>
383 <td align="center" width="138" height="14"> </td>
384 <td align="center" width="111" height="14">OpenPegasus</td>
385 </tr>
386 <tr>
387 <td width="75" height="14">OpenVMS</td>
388 <td align="left" width="275" height="13"> </td>
389 <td align="center" width="89" height="14"> </td>
390 <td align="center" width="138" height="14"> </td>
391 <td align="center" width="111" height="14">OpenPegasus</td>
392 </tr>
393
394 <tr>
395 <td rowspan="3" align="left" width="274" height="52">
396 <p>$(PEGASUS_REPOSITORY_DIR)</p></td>
397 <td align="center" width="75" height="14">Linux</td>
398 <td align="left" width="275" height="14">/var/lib/Pegasus/repository<p>/var/lib/Pegasus/repository(PS)</p></td>
399 <td align="center" width="89" height="14">root/pegasus<p>cimsvr/cimsvr</p></td>
400 marek 1.1 <td align="center" width="138" height="14">drwx------<p>drwx------</p></td>
401 <td align="center" width="111" height="14">OpenPegasus<br>
402 OpenPegasus</td>
403 </tr>
404 <tr>
405 <td align="center" width="75" height="14">HP-UX</td>
406 <td align="left" width="275" height="14">/var/opt/wbem/repository</td>
407 <td align="center" width="89" height="14">root/root</td>
408 <td align="center" width="138" height="14">dr-xr-xr-x</td>
409 <td align="center" width="111" height="14">OpenPegasus</td>
410 </tr>
411 <tr>
412 <td align="center" width="75" height="14">OpenVMS</td>
413 <td align="left" width="275" height="14">/var/opt/wbem/repository</td>
414 <td align="center" width="89" height="14">system</td>
415 <td align="center" width="138" height="14">S:wred,O:re,G:re,W:e</td>
416 <td align="center" width="111" height="14">OpenPegasus</td>
417 </tr>
418 <tr>
419 <td rowspan="3" align="left" width="274" height="52">$(PEGASUS_SBIN_DIR)</td>
420 <td align="center" width="75" height="14">Linux</td>
421 marek 1.1 <td align="left" width="275" height="14">/usr/sbin</td>
422 <td align="center" width="89" height="14">root/root</td>
423 <td align="center" width="138" height="14">drwxr-xr-x</td>
424 <td align="center" width="111" height="14">System</td>
425 </tr>
426 <tr>
427 <td align="center" width="75" height="14">HP-UX</td>
428 <td align="left" width="275" height="14">/opt/wbem/sbin</td>
429 <td align="center" width="89" height="14">bin/bin</td>
430 <td align="center" width="138" height="14">dr-xr-xr-x</td>
431 <td align="center" width="111" height="14">OpenPegasus</td>
432 </tr>
433 <tr>
434 <td align="center" width="75" height="14">OpenVMS</td>
435 <td align="left" width="275" height="14">/opt/wbem/sbin</td>
436 <td align="center" width="89" height="14">system</td>
437 <td align="center" width="138" height="14">S:wred,O:re,G:re,W:e</td>
438 <td align="center" width="111" height="14">OpenPegasus</td>
439 </tr>
440 <tr>
441 <td rowspan="3" align="left" width="274" height="52">$(PEGASUS_SCRIPTS_DIR)</td>
442 marek 1.1 <td align="center" width="75" height="14">Linux</td>
443 <td align="left" width="275" height="14">/usr/share/Pegasus/scripts</td>
444 <td align="center" width="89" height="14">root/pegasus</td>
445 <td align="center" width="138" height="14">drwxr-xr-x </td>
446 <td align="center" width="111" height="14"> OpenPegasus</td>
447 </tr>
448 <tr>
449 <td align="center" width="75" height="14">HP-UX</td>
450 <td align="left" width="275" height="14"> </td>
451 <td align="center" width="89" height="14"> </td>
452 <td align="center" width="138" height="14"> </td>
453 <td align="center" width="111" height="14"> </td>
454 </tr>
455 <tr>
456 <td align="center" width="75" height="14">OpenVMS</td>
457 <td align="left" width="275" height="14"> </td>
458 <td align="center" width="89" height="14"> </td>
459 <td align="center" width="138" height="14"> </td>
460 <td align="center" width="111" height="14"> </td>
461 </tr>
462 <tr>
463 marek 1.1 <td rowspan="3" align="left" width="274" height="52">$(PEGASUS_VARDATA_DIR)</td>
464 <td align="center" width="75" height="14">Linux</td>
465 <td align="left" width="275" height="14">/var/lib/Pegasus</td>
466 <td align="center" width="89" height="14">root/pegasus</td>
467 <td align="center" width="138" height="14">drwxr-xr-x</td>
468 <td align="center" width="111" height="14">OpenPegasus</td>
469 </tr>
470 <tr>
471 <td align="center" width="75" height="14">HP-UX</td>
472 <td align="left" width="275" height="14">/var/opt/wbem</td>
473 <td align="center" width="89" height="14">bin/bin</td>
474 <td align="center" width="138" height="14">dr-xr-xr-x</td>
475 <td align="center" width="111" height="14">OpenPegasus</td>
476 </tr>
477 <tr>
478 <td align="center" width="75" height="14">OpenVMS</td>
479 <td align="left" width="275" height="14">/var/opt/wbem</td>
480 <td align="center" width="89" height="14">system</td>
481 <td align="center" width="138" height="14">S:wred,O:re,G:re,W:e</td>
482 <td align="center" width="111" height="14">OpenPegasus</td>
483 </tr>
484 marek 1.1 <tr>
485 <td rowspan="3" align="left" width="274" height="52">$(PEGASUS_DOC_DIR)</td>
486 <td align="center" width="75" height="14">Linux</td>
487 <td align="left" width="275" height="14">/usr/share/doc/tog-pegasus-2.11</td>
488 <td align="center" width="89" height="14">root/pegasus</td>
489 <td align="center" width="138" height="14">drwxr-xr-x</td>
490 <td align="center" width="111" height="14">OpenPegasus</td>
491 </tr>
492 <tr>
493 <td align="center" width="75" height="14">HP-UX</td>
494 <td align="left" width="275" height="14">/opt/wbem/doc</td>
495 <td align="center" width="89" height="14"> </td>
496 <td align="center" width="138" height="14"> </td>
497 <td align="center" width="111" height="14">OpenPegasus</td>
498 </tr>
499 <tr>
500 <td align="center" width="75" height="14">OpenVMS</td>
501 <td align="left" width="275" height="14"> </td>
502 <td align="center" width="89" height="14"> </td>
503 <td align="center" width="138" height="14"> </td>
504 <td align="center" width="111" height="14"> </td>
505 marek 1.1 </tr>
506 <tr>
507 <td rowspan="3" align="left" width="274" height="52">$(PAM_CONFIG_DIR)</td>
508 <td align="center" width="75" height="14">Linux</td>
509 <td align="left" width="275" height="14">/etc/pam.d</td>
510 <td align="center" width="89" height="14">root/root</td>
511 <td align="center" width="138" height="14">drwxr-xr-x</td>
512 <td align="center" width="111" height="14">System</td>
513 </tr>
514 <tr>
515 <td align="center" width="75" height="14">HP-UX</td>
516 <td align="left" width="275" height="14"> </td>
517 <td align="center" width="89" height="14"> </td>
518 <td align="center" width="138" height="14"> </td>
519 <td align="center" width="111" height="14"> </td>
520 </tr>
521 <tr>
522 <td align="center" width="75" height="14">OpenVMS</td>
523 <td align="left" width="275" height="14"> </td>
524 <td align="center" width="89" height="14"> </td>
525 <td align="center" width="138" height="14"> </td>
526 marek 1.1 <td align="center" width="111" height="14"> </td>
527 </tr>
528 </tbody></table>
529
530 </ul>
531
532
533 <p> </p>
534
535
536 <p>Although not included in this release, the following directories
537 are planned for future release.<br>
538 </p>
539
540 <ul>
541
542 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="663" height="146">
543 <tbody><tr>
544 <th rowspan="2" bgcolor="#cae6ca" width="214" height="10">Document <br>
545 Designation</th>
546 <th rowspan="2" bgcolor="#cae6ca" width="151" height="10">Operating System</th>
547 marek 1.1 <th rowspan="2" bgcolor="#cae6ca" width="696" height="10">Location</th>
548 <th colspan="2" bgcolor="#cae6ca" width="276" height="16">Directory</th>
549 </tr>
550 <tr>
551 <th bgcolor="#cae6ca" width="55" height="10">Owner<br>
552 Group</th>
553 <th bgcolor="#cae6ca" width="221" height="10">Permissions</th>
554 </tr>
555 <tr>
556 <td rowspan="3" align="left" width="214" height="26">$(PEGASUS_MSG_DIR)</td>
557 <td align="center" width="151" height="5">Linux</td>
558 <td align="left" width="559" height="5">/usr/share/locale</td>
559 <td align="center" width="93" height="5">root/root</td>
560 <td align="center" width="221" height="5">drwxr-xr-x</td>
561 </tr>
562 <tr>
563 <td align="center" width="151" height="10">HP-UX</td>
564 <td align="left" width="559" height="10"> </td>
565 <td align="center" width="93" height="10"> </td>
566 <td align="center" width="221" height="10"> </td>
567 </tr>
568 marek 1.1 <tr>
569 <td align="center" width="151" height="26">OpenVMS</td>
570 <td align="left" width="559" height="26"> </td>
571 <td width="55" height="26"> </td>
572 <td width="221" height="26"> </td>
573 </tr>
574 </tbody></table>
575
576 </ul>
577
578 <p> </p>
579
580
581 <h3> <a name="SecPackagedFiles"></a>OpenPegasus Packaged Files</h3>
582
583 <h4><a name="SecLibraries"></a>Library Files</h4>
584
585 <h5><a name="SecLibraryVersioning"></a>Library-level Versioning Strategy</h5>
586
587 <p>Support for forward-compatibility is a fundamental design principle
588 for the OpenPegasus project. Our expectation is that well-behaved
589 marek 1.1 OpenPegasus Providers or Clients will continue to work with a minor
590 version upgrade of OpenPegasus. However, in the future, we do
591 anticipate that there will be a need to release changes that do not
592 support forward-compatibility. This would happen in situations
593 where the cost (i.e., development effort, performance, resource
594 utilization) of supporting compatibility has become prohibitive. To
595 minimize the impact of major version upgrades, OpenPegasus has been
596 designed to allow multiple versions of a library to coexist in the same
597 runtime environment. This way, new programs will be allowed to take
598 advantage of the new features and old programs will continue to run.</p>
599
600 <p>To allow multiple versions of a library, OpenPegasus recommends the use
601 of library-level versioning strategy. With this strategy, a library file is
602 created with a version suffix, $(VER_SUFFIX) (e.g., .1). This version
603 suffix is changed only when the new version of the library will not support CIM
604 Providers and/or CIM Clients developed using early versions of the library
605 (i.e., SDK).
606 It is important to note that the library version suffix is NOT the same as the
607 product version. </p>
608
609 <p>In addition to the library file, a
610 marek 1.1 symbolic link, that points to the latest version of the library, is created
611 using the standard library suffix for the target operating system, $(LIB_SUFFIX) (e.g., .so).
612 CIM Client and Provider developers would use this link to ensure that they are linking with the
613 most recent version of the library. When building a CIM Client or CIM
614 Provider, developers should use include the appropriate link option (e.g., -h on Linux)
615 to ensure that the specific version of the library used to build the product
616 will be loaded during runtime.</p>
617
618 <p>The following table describes the OpenPegasus library versions and
619 suffixes.</p>
620
621 <ul>
622 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="436">
623 <tbody><tr>
624 <th bgcolor="#cae6ca" width="168">Operating System</th>
625 <th bgcolor="#cae6ca" width="255">$(VER_SUFFIX)</th>
626 <th bgcolor="#cae6ca" width="255">$(LIB_SUFFIX)</th>
627 </tr>
628 <tr align="center">
629 <td width="168">Linux</td>
630 <td width="255">.1</td>
631 marek 1.1 <td width="255">.so</td>
632 </tr>
633 <tr align="center">
634 <td width="168">HP-UX (PA)</td>
635 <td width="255">.1</td>
636 <td width="255">.sl</td>
637 </tr>
638 <tr align="center">
639 <td width="168">HP-UX (IA)</td>
640 <td width="255">.1</td>
641 <td width="255">.so</td>
642 </tr>
643 <tr align="center">
644 <td width="168">OpenVMS</td>
645 <td width="255"> </td>
646 <td width="255">.olb</td>
647 </tr>
648 </tbody></table>
649 </ul>
650
651 <h5><a name="SecSharedLibraries"></a>OpenPegasus Libraries</h5>
652 marek 1.1
653 <p>This section documents the recommended set of library files to be included
654 with this release of OpenPegasus. Files in this section are
655 expected to be rooted in a single directory $(PEGASUS_DEST_LIB_DIR).</p>
656
657 <p><b>Source Location: </b>$(PEGASUS_HOME)/lib</p>
658
659 <p>The following table describes the permissions that should be assigned to the
660 files in the $(PEGASUS_DEST_LIB_DIR) directory.</p>
661
662 <ul>
663
664 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
665 <tbody><tr>
666 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
667 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
668 </tr>
669 <tr>
670 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
671 <th bgcolor="#cae6ca" width="199">Permissions</th>
672 </tr>
673 marek 1.1 <tr align="center">
674 <td width="203">Linux</td>
675 <td width="194">root/pegasus</td>
676 <td width="199">-rwxr-xr-x</td>
677 </tr>
678 <tr align="center">
679 <td width="203">HP-UX</td>
680 <td width="194">bin/bin</td>
681 <td width="199">-r-xr-xr-x</td>
682 </tr>
683 <tr align="center">
684 <td width="203">OpenVMS</td>
685 <td width="194">system</td>
686 <td width="199">S:wred,O:re,G:re,W:e</td>
687 </tr>
688 </tbody></table>
689
690 </ul>
691
692 <p> </p>
693
694 marek 1.1 <p>The following files should be included in the $(PEGASUS_DEST_LIB_DIR) directory.</p>
695
696 <ul>
697 <p>libCIMxmlIndicationHandler.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
|
699 marek 1.1 libCertificateProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
700 libConfigSettingProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
701 libDefaultProviderManager.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
702 libNamespaceProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
703 libProviderRegistrationProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
704 libUserAuthProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
705 libcmpiCppImpl.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
706 libpegauthentication.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
707 libpegclient.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
708 libpegcliutils.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
709 libpegcommon.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
710 libpegcompiler.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
711 libpegconfig.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
712 libpegexportclient.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
713 libpegexportserver.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
714 libpeggeneral.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
715
716 libpeggetoopt.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
717 libpeghandlerservice.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
718 libpegindicationservice.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
719 libpeglistener.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
720 marek 1.1 libpegpmservice.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
721 libpegprm.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
722 libpegprovider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
723 libpegprovidermanager.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
724 libpegquerycommon.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
725 libpegqueryexpression.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
726 libpegrepository.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
727 libpegserver.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
728 libpegservice.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
729 libpeguser.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
730 libpegwql.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
731 libsnmpIndicationHandler.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
732 </p>
733
734 </ul>
735
736 <p>In addition, the following links should be included in the $(PEGASUS_DEST_LIB_DIR)
737 directory.<br>
738 <br>
739
740 libCIMxmlIndicationHandler.$(LIB_SUFFIX) -> libCIMxmlIndicationHandler.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
741 marek 1.1
742 libDefaultProviderManager.$(LIB_SUFFIX) -> libDefaultProviderManager.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
743
744 libpegclient.$(LIB_SUFFIX) -> libpegclient.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
745
746 libpegcommon.$(LIB_SUFFIX) -> libpegcommon.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
747
748 libpegprovider.$(LIB_SUFFIX) -> libpegprovider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
749
750 libsnmpIndicationHandler.$(LIB_SUFFIX) -> libsnmpIndicationHandler.$(LIB_SUFFIX).$(VER_SUFFIX)
751
752 </p><p> </p><p>The following table describes the recommended install, upgrade and remove
753 behavior for the OpenPegasus libraries and links.</p>
754 <ul>
755 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="565">
756 <tbody><tr>
757 <th bgcolor="#cae6ca" width="168"> </th>
758 <th bgcolor="#cae6ca" width="255">install</th>
759 <th bgcolor="#cae6ca" width="359">upgrade</th>
760 <th bgcolor="#cae6ca" width="280">remove</th>
761 </tr>
762 marek 1.1 <tr align="center">
763 <td width="168">*.$(VER_SUFFIX)</td>
764 <td width="255">new libraries installed</td>
765 <td width="359">existing libraries replaced with new libraries</td>
766 <td width="280">existing libraries removed</td>
767 </tr>
768 <tr align="center">
769 <td width="168">*.$(LIB_SUFFIX)</td>
770 <td width="255">new links installed</td>
771 <td width="359">existing links replaced with new links</td>
772 <td width="280">existing links removed</td>
773 </tr>
774 </tbody></table>
775 </ul>
776
777 <h5><a name="SecProviderManagers"></a>OpenPegasus Provider Managers</h5>
778
779 <p>This section documents the dynamically loaded provider managers
780 packaged with OpenPegasus. Files in this section are expected to
781 be rooted in a single directory $(PEGASUS_PROVIDER_MANAGER_LIB_DIR).</p>
782
783 marek 1.1 <p><b>Source Location: </b>$(PEGASUS_HOME)/lib</p>
784
785 <p>The following table describes the permissions that should be assigned to the
786 files in the $(PEGASUS_PROVIDER_MANAGER_LIB_DIR) directory.</p>
787
788 <ul>
789
790 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" id="table1" border="1" cellspacing="1" width="438">
791 <tbody><tr>
792 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
793 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
794 </tr>
795 <tr>
796 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
797 <th bgcolor="#cae6ca" width="199">Permissions</th>
798 </tr>
799 <tr align="center">
800 <td width="203">Linux</td>
801 <td width="194">root/pegasus</td>
802 <td width="199">-rwxr-xr-x</td>
803 </tr>
804 marek 1.1 <tr align="center">
805 <td width="203">HP-UX</td>
806 <td width="194">bin/bin</td>
807 <td width="199">-r-xr-xr-x</td>
808 </tr>
809 <tr align="center">
810 <td width="203">OpenVMS</td>
811 <td width="194">system</td>
812 <td width="199">S:wred,O:re,G:re,W:e</td>
813 </tr>
814 </tbody></table>
815
816 </ul>
817
818 <p> </p>
819
820 <p>The following files should be included in the $(PEGASUS_PROVIDER_MANAGER_LIB_DIR) directory.</p>
821
822 <ul>
823 <p>libCMPIProviderManager.$(LIB_SUFFIX).$(VER_SUFFIX)</p>
824 </ul>
825 marek 1.1
826 <p>In addition, the following links should be included in the $(PEGASUS_DEST_LIB_DIR)
827 directory.<br>
828 <br>
829
830 libCMPIProviderManager.$(LIB_SUFFIX) -> libCMPIProviderManager.$(LIB_SUFFIX).$(VER_SUFFIX)</p>
831
832
833 <h5><a name="SecProviderLibraries"></a>OpenPegasus Provider Libraries</h5>
834
835 <p>This section documents the Providers packaged with OpenPegasus.
836 Files in this section are expected to be rooted in a single
837 directory $(PEGASUS_PROVIDER_LIB_DIR). Note that the $(PEGASUS_PROVIDER_LIB_DIR)
838 directory MUST be included as one of the values of the <b>providerDir</b>
839 configuration parameter. Note that this directory may contain
840 symbolic links to the actual files, there is no requirement for the actual library file to be placed in
841 this directory.</p>
842
843 <p><b>Packaged Providers</b></p>
844
845
846 marek 1.1 <dl>
847 <dd>Operating System Provider<br>
848
849 Computer System Provider</dd><dd>
850 Process Provider</dd>
851 <dd>IP Provider<br>
852
853 </dd>
854 </dl>
855 </dl>
856
857 <dl>
858
859 <dl>
860 <dt>Additionally on HP-UX, following are the packaged Providers</dt>
861
862 <dd>DNS Provider</dd>
863 <dd>NTP Provider</dd>
864 <dd>NIS Provider<br>
865
866 </dd>
867 marek 1.1
868 <dt> </dt>
869 </dl>
870
871
872 <dd>The following table describes the permissions that should be assigned to the
873 links or files in the $(PEGASUS_PROVIDER_LIB_DIR) directory.<br><br>
874
875 <ul>
876
877 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
878 <tbody><tr>
879 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
880 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
881 </tr>
882 <tr>
883 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
884 <th bgcolor="#cae6ca" width="199">Permissions</th>
885 </tr>
886 <tr align="center">
887 <td width="203">Linux</td>
888 marek 1.1 <td width="194">root/pegasus</td>
889 <td width="199">-rwxr-xr-x</td>
890 </tr>
891 <tr align="center">
892 <td width="203">HP-UX</td>
893 <td width="194">bin/bin</td>
894 <td width="199">-r-xr-xr-x</td>
895 </tr>
896 <tr align="center">
897 <td width="203">OpenVMS</td>
898 <td width="194">system</td>
899 <td width="199">S:wred,O:re,G:re,W:e</td>
900 </tr>
901 </tbody></table>
902
903 </ul>
904
905
906 <dl>
907 <dt> </dt>
908 </dl>
909 marek 1.1
910 <p>The following files should be included in the $(PEGASUS_PROVIDER_LIB_DIR) directory.</p><dl>
911 <dd> </dd>
912 <dd>libComputerSystemProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
913 libOSProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
914 libProcessProvider.$(LIB_SUFFIX).(VER_SUFFIX)<p><b><br>
915 </b>
916 </p></dd></dl>
917
918 <p><b>Provider Library Versioning</b></p>
919
920 <p>The CIM Server will use the $(LIB_SUFFIX) when attempting to
921 dynamically load a Provider. This allows Provider developers to
922 use a resource-specific library versioning
923 strategy. Providers are not required to use this same version
924 suffix as the OpenPegasus libraries. </p>
925
926 <p>The following links should be included in the $(PEGASUS_PROVIDER_LIB_DIR)
927 directory.</p>
928
929 <ul>
930 marek 1.1 libComputerSystemProvider.$(LIB_SUFFIX) -> <br>
931 $(PEGASUS_PROVIDER_LIB_DIR)/libComputerSystemProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
932 libOSProvider.$(LIB_SUFFIX) ->
933 <p> $(PEGASUS_PROVIDER_LIB_DIR)/libOSProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
934 libProcessProvider.$(LIB_SUFFIX) -> <br>
935 $(PEGASUS_PROVIDER_LIB_DIR)/libProcessProvider.$(LIB_SUFFIX).$(VER_SUFFIX)</p>
936 </ul>
937
938 <p>The following table describes the recommended install, upgrade and remove
939 behavior for the packaged Provider libraries and links.</p>
940 <ul>
941 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="565">
942 <tbody><tr>
943 <th bgcolor="#cae6ca" width="168"> </th>
944 <th bgcolor="#cae6ca" width="255">install</th>
945 <th bgcolor="#cae6ca" width="359">upgrade</th>
946 <th bgcolor="#cae6ca" width="280">remove</th>
947 </tr>
948 <tr align="center">
949 <td width="168">*.$(VER_SUFFIX)</td>
950 <td width="255">new libraries installed</td>
951 marek 1.1 <td width="359">existing libraries replaced with new libraries</td>
952 <td width="280">existing libraries removed</td>
953 </tr>
954 <tr align="center">
955 <td width="168">*.$(LIB_SUFFIX)</td>
956 <td width="255">new links installed</td>
957 <td width="359">existing links replaced with new links</td>
958 <td width="280">existing links removed</td>
959 </tr>
960 </tbody></table>
961 </ul>
962
963 <h4><a name="SecExecutables"></a>Executable Files</h4>
964
965 <p>The following table describes the OpenPegasus executable suffixes.</p>
966
967 <ul>
968 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="322">
969 <tbody><tr>
970 <th bgcolor="#cae6ca" width="168">Operating System</th>
971 <th bgcolor="#cae6ca" width="141">$(EXE_SUFFIX)</th>
972 marek 1.1 </tr>
973 <tr align="center">
974 <td width="168">Linux</td>
975 <td width="141">NA</td>
976 </tr>
977 <tr align="center">
978 <td width="168">HP-UX (PA)</td>
979 <td width="141">NA</td>
980 </tr>
981 <tr align="center">
982 <td width="168">HP-UX (IA)</td>
983 <td width="141">NA</td>
984 </tr>
985 <tr align="center">
986 <td width="168">OpenVMS</td>
987 <td width="141">.exe</td>
988 </tr>
989 </tbody></table>
990 </ul>
991
992 <h5><a name="SecAdminCommands"></a>OpenPegasus Administrative Commands</h5>
993 marek 1.1
994 <p>This section documents <span class="normalfont">the maintenance or
995 administrative commands</span> included
996 with this release of OpenPegasus. Files in this section are
997 expected to be rooted in a single directory $(PEGASUS_SBIN_DIR).</p>
998
999 <p><b>Source Location: </b>$(PEGASUS_HOME)/sbin</p>
1000
1001 <p>The following table describes the permissions that should be assigned to the
1002 files in the $(PEGASUS_SBIN_DIR) directory.</p>
1003
1004 <ul>
1005
1006 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
1007 <tbody><tr>
1008 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
1009 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
1010 </tr>
1011 <tr>
1012 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
1013 <th bgcolor="#cae6ca" width="199">Permissions</th>
1014 marek 1.1 </tr>
1015 <tr align="center">
1016 <td width="203">Linux</td>
1017 <td width="194">root/pegasus</td>
1018 <td width="199">-rwxr-xr-x</td>
1019 </tr>
1020 <tr align="center">
1021 <td width="203">HP-UX</td>
1022 <td width="194">bin/bin</td>
1023 <td width="199">-r-xr--r--</td>
1024 </tr>
1025 <tr align="center">
1026 <td width="203">OpenVMS</td>
1027 <td width="194">system</td>
1028 <td width="199">S:wred,O:re,G:re,W:e</td>
1029 </tr>
1030 </tbody></table>
1031
1032 </ul>
1033
1034 <p> </p>
1035 marek 1.1
1036 <p>The following files should be included in the $(PEGASUS_SBIN_DIR) directory.</p>
1037
1038 <ul>
1039 cimauth<br>
1040 cimconfig<br>
1041 cimprovagt<p><font face="Helvetica,Arial" size="-1">cimreparchive</font><br>
1042 cimserver<br>
1043 cimservera<br>
1044 cimservermain<br>
1045 cimshutdown<br>
1046 cimtrust<br>
1047 repupgrade<br>
1048 </p>
1049 </ul>
1050
1051 <p>The following table describes the recommended install, upgrade and remove
1052 behavior for the OpenPegasus commands.</p>
1053 <ul>
1054 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="565">
1055 <tbody><tr>
1056 marek 1.1 <th bgcolor="#cae6ca" width="255">install</th>
1057 <th bgcolor="#cae6ca" width="359">upgrade</th>
1058 <th bgcolor="#cae6ca" width="280">remove</th>
1059 </tr>
1060 <tr align="center">
1061 <td width="255">new executables installed</td>
1062 <td width="359">existing executables replaced with new executables</td>
1063 <td width="280">existing executables removed</td>
1064 </tr>
1065 </tbody></table>
1066 </ul>
1067
1068 <h5><a name="SecAdminScripts"></a>OpenPegasus Administrative Scripts</h5>
1069
1070 <p>This section documents <span class="normalfont">the scripts</span> included
1071 with this release of OpenPegasus. Files in this section are
1072 expected to be rooted in a single directory $(PEGASUS_SCRIPTS_DIR).</p>
1073
1074 <p><b>Source Location: </b>pegasus/rpm/tog-specfiles</p>
1075
1076 <p>The following table describes the permissions that should be assigned to the
1077 marek 1.1 files in the $(PEGASUS_SCRIPTS_DIR) directory.</p>
1078
1079 <ul>
1080
1081 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
1082 <tbody><tr>
1083 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
1084 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
1085 </tr>
1086 <tr>
1087 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
1088 <th bgcolor="#cae6ca" width="199">Permissions</th>
1089 </tr>
1090 <tr align="center">
1091 <td width="203">Linux</td>
1092 <td width="194">root/pegasus</td>
1093 <td width="199">-rwxr-x---</td>
1094 </tr>
1095 <tr align="center">
1096 <td width="203">HP-UX</td>
1097 <td width="194"> </td>
1098 marek 1.1 <td width="199"> </td>
1099 </tr>
1100 <tr align="center">
1101 <td width="203">OpenVMS</td>
1102 <td width="194"> </td>
1103 <td width="199"> </td>
1104 </tr>
1105 </tbody></table>
1106
1107 </ul>
1108
1109 <p> </p>
1110
1111 <p>The following files should be included in the $(PEGASUS_SCRIPTS_DIR) directory.</p>
1112
1113 <ul>
1114 <p>genOpenPegasusSSLCerts<br>
1115 </p>
1116 </ul>
1117
1118 <p>The following table describes the recommended install, upgrade and remove
1119 marek 1.1 behavior for the OpenPegasus commands.</p>
1120 <ul>
1121 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="565">
1122 <tbody><tr>
1123 <th bgcolor="#cae6ca" width="255">install</th>
1124 <th bgcolor="#cae6ca" width="359">upgrade</th>
1125 <th bgcolor="#cae6ca" width="280">remove</th>
1126 </tr>
1127 <tr align="center">
1128 <td width="255">new scripts installed</td>
1129 <td width="359">existing scripts replaced with new scripts</td>
1130 <td width="280">existing scripts removed</td>
1131 </tr>
1132 </tbody></table>
1133 </ul>
1134
1135
1136 <h5><a name="SecUserCommands"></a>OpenPegasus User Commands</h5>
1137
1138 <p>This section documents <span class="normalfont">the user commands</span> included
1139 with this release of OpenPegasus. Files in this section are
1140 marek 1.1 expected to be rooted in a single directory $(PEGASUS_BIN_DIR).</p>
1141
1142 <p><b>Source Location: </b>$(PEGASUS_HOME)/bin</p>
1143
1144 <p>The following table describes the permissions that should be assigned to the
1145 files in the $(PEGASUS_BIN_DIR) directory.</p>
1146
1147 <ul>
1148
1149 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
1150 <tbody><tr>
1151 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
1152 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
1153 </tr>
1154 <tr>
1155 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
1156 <th bgcolor="#cae6ca" width="199">Permissions</th>
1157 </tr>
1158 <tr align="center">
1159 <td width="203">Linux</td>
1160 <td width="194">root/pegasus</td>
1161 marek 1.1 <td width="199">-rwxr-xr-x</td>
1162 </tr>
1163 <tr align="center">
1164 <td width="203">HP-UX</td>
1165 <td width="194">bin/bin</td>
1166 <td width="199">-r-xr-xr-x</td>
1167 </tr>
1168 <tr align="center">
1169 <td width="203">OpenVMS</td>
1170 <td width="194">system</td>
1171 <td width="199">S:wred,O:re,G:re,W:e</td>
1172 </tr>
1173 </tbody></table>
1174
1175 </ul>
1176
1177 <p> </p>
1178
1179 <p>The following files should be included in the $(PEGASUS_BIN_DIR) directory.</p>
1180
1181 <ul>
1182 marek 1.1 <p>cimmof</p><p>cimmofl<br>
1183 cimprovider<br>
1184 cimsub<br>
1185 osinfo<br>
1186 wbemexec<br>
1187 </p></ul>
1188
1189 <p> </p><p>The following table describes the recommended install, upgrade and remove
1190 behavior for the OpenPegasus commands.</p>
1191 <ul>
1192 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="565">
1193 <tbody><tr>
1194 <th bgcolor="#cae6ca" width="255">install</th>
1195 <th bgcolor="#cae6ca" width="359">upgrade</th>
1196 <th bgcolor="#cae6ca" width="280">remove</th>
1197 </tr>
1198 <tr align="center">
1199 <td width="255">new executables installed</td>
1200 <td width="359">existing executables replaced with new executables</td>
1201 <td width="280">existing executables removed</td>
1202 </tr>
1203 marek 1.1 </tbody></table>
1204 </ul>
1205
1206 <p><br>
1207
1208
1209 </p><h4><a name="SecDocumentation"></a>Documentation Files</h4>
1210
1211 <h5><a name="SecManPages"></a>Unix Style Man Pages</h5>
1212
1213 <p>This section describes the packaging for Operating Systems that support Unix
1214 style man pages. Files in this section are expected to be rooted in a single
1215 directory $(PEGASUS_MAN_DIR).</p>
1216
1217 <p><b>Source Location: </b>$(ROOT)/rpm/manLinux/man1.Z/<br>
1218 $(ROOT)/rpm/manLinux/man8.Z</p>
1219
1220 <p>The following table describes the permissions that should be assigned to the
1221 files in the $(PEGASUS_MAN_DIR) subdirectories.</p>
1222
1223 <ul>
1224 marek 1.1
1225 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
1226 <tbody><tr>
1227 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
1228 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
1229 </tr>
1230 <tr>
1231 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
1232 <th bgcolor="#cae6ca" width="199">Permissions</th>
1233 </tr>
1234 <tr align="center">
1235 <td width="203">Linux</td>
1236 <td width="194">root/pegasus</td>
1237 <td width="199">-rw-r--r--</td>
1238 </tr>
1239 <tr align="center">
1240 <td width="203">HP-UX</td>
1241 <td width="194">bin/bin</td>
1242 <td width="199">-r--r--r--</td>
1243 </tr>
1244 <tr align="center">
1245 marek 1.1 <td width="203">OpenVMS</td>
1246 <td width="194">system</td>
1247 <td width="199">S:wred,O:r,G:r,W:r</td>
1248 </tr>
1249 </tbody></table>
1250 </ul>
1251
1252 <p> </p>
1253
1254 <p>The following man pages should be included in the $(PEGASUS_MAN_DIR)/man1 directory.</p>
1255
1256 <ul>
1257 cimmof.1(.gz)<br>
1258 cimprovider.1(.gz)<br>
1259 cimsub.1(.gz)<br>
1260 osinfo.1(.gz)<br>
1261 wbemexec.1(.gz)<br>
1262 </ul>
1263
1264
1265 <p> </p>
1266 marek 1.1
1267
1268 <p>The following man pages should be included in the $(PEGASUS_MAN_DIR)/man8 directory.</p>
1269
1270
1271 <ul>
1272 cimauth.8(.gz)<br>
1273 cimconfig.8(.gz)<br>
1274 <font face="Helvetica,Arial" size="-1">cimreparchive.8(.gz)</font><p>
1275 <font face="Helvetica,Arial" size="-1">cimtrust.8(.gz)</font><br>
1276 cimserver.8(.gz)</p>
1277 <p> </p>
1278 </ul>
1279
1280 <p>The following table describes the recommended install, upgrade and remove
1281 behavior for the OpenPegasus man pages.</p>
1282 <ul>
1283 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="506">
1284 <tbody><tr>
1285 <th bgcolor="#cae6ca" width="255">install</th>
1286 <th bgcolor="#cae6ca" width="307">upgrade</th>
1287 marek 1.1 <th bgcolor="#cae6ca" width="273">remove</th>
1288 </tr>
1289 <tr align="center">
1290 <td width="255">new man pages installed</td>
1291 <td width="307">existing man pages replaced with new man pages</td>
1292 <td width="273">existing man pages removed</td>
1293 </tr>
1294 </tbody></table>
1295 </ul>
1296
1297 <h5><a name="UserDocumentation"></a>User Documentation</h5>
1298
1299 <p>Files in this section are expected to be rooted in a single directory $(PEGASUS_DOC_DIR).</p>
1300
1301 <p>The following table describes the permissions that should be assigned to the
1302 files in the $(PEGASUS_DOC_DIR) directory.</p>
1303
1304 <ul>
1305
1306 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
1307 <tbody><tr>
1308 marek 1.1 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
1309 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
1310 </tr>
1311 <tr>
1312 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
1313 <th bgcolor="#cae6ca" width="199">Permissions</th>
1314 </tr>
1315 <tr align="center">
1316 <td width="203">Linux</td>
1317 <td width="194">root/pegasus</td>
1318 <td width="199">-r--r--r--</td>
1319 </tr>
1320 <tr align="center">
1321 <td width="203">HP-UX</td>
1322 <td width="194">bin/bin</td>
1323 <td width="199"> </td>
1324 </tr>
1325 <tr align="center">
1326 <td width="203">OpenVMS</td>
1327 <td width="194">system</td>
1328 <td width="199"> </td>
1329 marek 1.1 </tr>
1330 </tbody></table>
1331
1332 </ul>
1333
1334 <p><br>
1335 <br>
1336 The following documents are included with OpenPegasus. </p>
1337
1338 <p><b>Staging Location: </b>$(PEGASUS_HOME)/$(PEGASUS_STAGING_DIR)/$(PEGASUS_DOC_DIR)</p>
1339
1340 <p><b>Target Location: </b>$(PEGASUS_DOC_DIR)</p>
1341
1342 <ul>
1343 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="476">
1344 <tbody><tr>
1345 <th bgcolor="#cae6ca" width="282">File Name</th>
1346 <th bgcolor="#cae6ca" width="181">Source Location</th>
1347 </tr>
1348 <tr>
1349 <td width="282">Admin_Guide_Release.pdf</td>
1350 marek 1.1 <td width="181">pegasus/doc</td>
1351 </tr>
1352 <tr>
1353 <td width="282">PegasusSSLGuidelines.htm</td>
1354 <td width="181">pegasus/doc</td>
1355 </tr>
1356 <tr>
1357 <td width="282">license.txt</td>
1358 <td width="181">pegasus/doc</td>
1359 </tr>
1360 <tr>
1361 <td width="282">OpenPegasusNOTICE.txt</td>
1362 <td width="181">pegasus</td>
1363 </tr>
1364 </tbody></table>
1365 </ul>
1366
1367 <br>
1368
1369 <p>The following table describes the recommended install, upgrade and remove
1370 behavior for the OpenPegasus documentation files.</p>
1371 marek 1.1 <ul>
1372 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="506">
1373 <tbody><tr>
1374 <th bgcolor="#cae6ca" width="255">install</th>
1375 <th bgcolor="#cae6ca" width="307">upgrade</th>
1376 <th bgcolor="#cae6ca" width="273">remove</th>
1377 </tr>
1378 <tr align="center">
1379 <td width="255">New documents installed.</td>
1380 <td width="307">Existing documents removed and new documents installed.</td>
1381 <td width="273">Existing documents removed.</td>
1382 </tr>
1383 </tbody></table>
1384 </ul>
1385
1386 <p>
1387 <br>
1388
1389
1390
1391 </p>
1392 marek 1.1
1393
1394
1395 <h4><a name="SecDataFiles"></a>Data Files</h4>
1396
1397 <p>This section describes the OpenPegasus data files. </p>
1398
1399 <p>There are three classes of OpenPegasus data files:</p>
1400
1401 <ol>
1402 <li><b>FIXED LOCATION. </b>Absolute names that are used by the CIM Server and
1403 fixed at build time. A rebuild is required to change the file name.
1404 The runtime file structure MUST be consistent with the build time definition
1405 of the FIXED LOCATION files. Refer to PEP 308 for recommended default values.</li>
1406 <li><b>CONFIGURABLE LOCATION.</b> Absolute file names that are used by the CIM Server and
1407 configurable using the cimconfig command. All CONFIGURABLE LOCATION
1408 files are assigned a default value for the absolute file name. The runtime
1409 file structure WILL assume the default value. Refer to PEP 308 for recommended default values.</li>
1410 <li><b>INSTALLATION DEFINED LOCATION. </b>Files that are NOT used by the CIM Server but exist as
1411 part of the CIM Server runtime environment. Default absolute file names
1412 will be defined for these directories.</li>
1413 marek 1.1 </ol>
1414
1415 <p> </p>
1416
1417
1418 <ul>
1419
1420 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="626" height="88">
1421 <tbody><tr>
1422 <th bgcolor="#cae6ca" width="282" height="1">Document Designation</th>
1423 <th bgcolor="#cae6ca" width="76" height="1">Type</th>
1424 <th bgcolor="#cae6ca" width="264" height="1">Build Configuration Option</th>
1425 </tr>
1426
1427 <tr>
1428 <td align="left" width="282" height="1">
1429 <p align="left">$(PEGASUS_LOCAL_AUTH_DIR)</p></td>
1430 <td align="center" width="76" height="1">FIXED</td>
1431 <td width="264" height="1">
1432 <p align="left">PEGASUS_LOCAL_AUTH_DIR</p></td>
1433 </tr>
1434 marek 1.1 <tr>
1435 <td align="left" width="282" height="1">
1436 $(PEGASUS_MOF_DIR)</td>
1437 <td align="center" width="76" height="1">INSTALL</td>
1438 <td width="264" height="1">
1439 <br>
1440 </td>
1441 </tr>
1442 <tr>
1443 <td align="left" width="282" height="1">
1444 <p align="left">$(PEGASUS_LOCAL_DOMAIN_SOCKET_DIR)</p></td>
1445 <td align="center" width="76" height="1">FIXED</td>
1446 <td width="264" height="1">
1447 <p align="left">PEGASUS_LOCAL_DOMAIN_SOCKET_PATH</p></td>
1448 </tr>
1449 <tr>
1450 <td align="left" width="282" height="1">
1451 $(PEGASUS_CURRENT_CONFIG_FILE)</td>
1452 <td align="center" width="76" height="1">FIXED</td>
1453 <td width="264" height="1">
1454 CURRENT_CONFIG_FILE []</td>
1455 marek 1.1 </tr>
1456 <tr>
1457 <td align="left" width="282" height="1">
1458 $(PEGASUS_PLANNED_CONFIG_FILE)</td>
1459 <td align="center" width="76" height="1">FIXED</td>
1460 <td width="264" height="1">
1461 PLANNED_CONFIG_FILE []</td>
1462 </tr>
1463 <tr>
1464 <td align="left" width="282" height="1">
1465 $(PEGASUS_PID_FILE)</td>
1466 <td align="center" width="76" height="1">FIXED</td>
1467 <td width="264" height="1">
1468 CIMSERVER_START_FILE [] </td>
1469 </tr>
1470 <tr>
1471 <td align="left" width="282" height="1">
1472 $(PEGASUS_CIMSERVER_RANDOMFILE)</td>
1473 <td align="center" width="76" height="1">FIXED</td>
1474 <td width="264" height="1">
1475 PEGASUS_SSLSERVER_RANDOMFILE</td>
1476 marek 1.1 </tr>
1477 </tbody></table>
1478 </ul>
1479
1480
1481
1482 <h5><a name="SecStaticDataFiles"></a>Static Data Files</h5>
1483
1484 <p>This section describes OpenPegasus data files that do not change during
1485 normal operation. </p>
1486
1487
1488 <h6>Schema Files</h6>
1489
1490
1491 <p>The following table describes the permissions that should be assigned to the $(PEGASUS_MOF_DIR)
1492 directory.</p>
1493
1494
1495
1496 <blockquote>
1497 marek 1.1
1498 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="634" height="155">
1499 <tbody><tr>
1500 <th rowspan="2" bgcolor="#cae6ca" width="153" height="1">Document
1501 Designation<br>
1502 Configuration Option</th>
1503 <th rowspan="2" bgcolor="#cae6ca" width="83" height="1">Operating System</th>
1504 <th rowspan="2" bgcolor="#cae6ca" width="153" height="1">Location</th>
1505 <th colspan="2" bgcolor="#cae6ca" width="242" height="16">Directory</th>
1506 </tr>
1507 <tr>
1508 <th bgcolor="#cae6ca" width="90" height="1">Owner<br>
1509 Group</th>
1510 <th bgcolor="#cae6ca" width="147" height="1">Permissions</th>
1511 </tr>
1512 <tr>
1513 <td rowspan="3" align="left" width="153" height="13">$(PEGASUS_MOF_DIR)<br>
1514 </td>
1515 <td align="center" width="83" height="1">Linux</td>
1516 <td align="left" width="153" height="1">/usr/share/Pegasus/mof</td>
1517 <td align="center" width="90" height="1">root/pegasus</td>
1518 marek 1.1 <td align="center" width="147" height="1">drwxr-xr-x</td>
1519 </tr>
1520 <tr>
1521 <td align="center" width="83" height="1">HP-UX</td>
1522 <td align="left" width="153" height="1">/opt/wbem/mof</td>
1523 <td align="center" width="90" height="1">bin/bin</td>
1524 <td align="center" width="147" height="1">dr-xr-xr-x</td>
1525 </tr>
1526 <tr>
1527 <td align="center" width="83" height="15">OpenVMS</td>
1528 <td align="left" width="153" height="15">/opt/wbem/mof</td>
1529 <td align="center" width="90" height="15">system</td>
1530 <td align="center" width="147" height="15">S:wred,O:re,G:re,W:e</td>
1531 </tr>
1532 </tbody></table>
1533
1534 </blockquote>
1535
1536 <p>The following table describes the permissions that should be assigned to the
1537 files in the $(PEGASUS_MOF_DIR) subdirectories.</p>
1538
1539 marek 1.1
1540
1541 <dl>
1542 <dd> <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="541" height="89">
1543 <tbody><tr>
1544 <th rowspan="2" bgcolor="#cae6ca" width="104" height="1">Operating System</th>
1545 <th rowspan="2" bgcolor="#cae6ca" width="145" height="1">Packaged or Generated?</th>
1546 <th colspan="2" bgcolor="#cae6ca" width="274" height="16">File</th>
1547 </tr>
1548 <tr>
1549 <th bgcolor="#cae6ca" width="153" height="1">Owner/Group</th>
1550 <th bgcolor="#cae6ca" width="116" height="1">Permissions</th>
1551 </tr>
1552 <tr align="center">
1553 <td width="104" height="14">Linux</td>
1554 <td width="145" height="14">Packaged</td>
1555 <td width="153" height="3">root/pegasus</td>
1556 <td width="116" height="3">-rw-r--r--</td>
1557 </tr>
1558 <tr>
1559 <td align="center" width="104" height="17">HP-UX</td>
1560 marek 1.1 <td align="center" width="145" height="12">Packaged</td>
1561 <td align="center" width="153" height="14">bin/bin</td>
1562 <td align="center" width="116" height="14">-r--r--r--</td>
1563 </tr>
1564 <tr>
1565 <td align="center" width="104" height="17">OpenVMS</td>
1566 <td align="center" width="145" height="12">Packaged</td>
1567 <td align="center" width="153" height="14">system</td>
1568 <td align="center" width="116" height="14">S:wred,O:r,G:r,W:r</td>
1569 </tr>
1570 </tbody></table>
1571
1572 </dd>
1573 </dl>
1574
1575 <p> </p>
1576
1577 <p>The following OpenPegasus specific mof files
1578 are packaged in the directory $(PEGASUS_MOF_DIR)/Pegasus.
1579 <font color="#ff0000">Note: </font>The class definitions defined in the
1580 pegasus/Schemas/Pegasus/Internal/VER20 mof files are for internal use
1581 marek 1.1 only and subject to change. Please consult the OpenPegasus
1582 External Interface Definition document, ExternalInterface.html, in the
1583 pegasus/doc directory in CVS for a list of the mof files included in
1584 the OpenPegasus external definition.</p>
1585
1586
1587 <dl>
1588 <dd><b>Source Location: </b>pegasus/Schemas/Pegasus/Internal/VER20<ul>
1589 PG_Authorization20.mof<br>
1590 PG_ConfigSetting20.mof<br>
1591 PG_InternalSchema20.mof<br>
1592 PG_ShutdownService20.mof<p>PG_SSLCertificate20.mof<br>
1593 PG_SSLCertificateRevocationList20.mof<br>
1594 PG_User20.mof<br>
1595 <br>
1596 </p>
1597 </ul>
1598
1599 </dd>
1600 <dd><b>Source Location: </b>pegasus/Schemas/Pegasus/InterOp/VER20<ul>
1601 PG_Events20.mof<br>
1602 marek 1.1 PG_InterOpSchema20.mof<br>
1603 PG_ProviderModule20.mof<p>
1604 <br>
1605 </p>
1606 </ul>
1607
1608
1609 </dd>
1610 <dd><b>Source Location: </b>pegasus/Schemas/Pegasus/ManagedSystem/VER20<ul>
1611 <p>PG_ComputerSystem20.mof<br>
1612 PG_ComputerSystem20R.mof<br>
1613 PG_ManagedSystemSchema20.mof<br>
1614 PG_ManagedSystemSchema20R.mof<br>
1615 PG_OperatingSystem20.mof<br>
1616 PG_OperatingSystem20R.mof<br>
1617 PG_UnixProcess20.mof<br>
1618 PG_UnixProcess20R.mof</p>
1619 </ul>
1620 </dd>
1621 </dl>
1622
1623 marek 1.1 <br>
1624 <br>
1625
1626 <p>The following table describes the recommended install, upgrade and remove
1627 behavior for the OpenPegasus mof files.</p>
1628 <ul>
1629 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="685">
1630 <tbody><tr>
1631 <th bgcolor="#cae6ca" width="182">install</th>
1632 <th bgcolor="#cae6ca" width="285">upgrade</th>
1633 <th bgcolor="#cae6ca" width="200">remove</th>
1634 </tr>
1635 <tr align="center">
1636 <td align="left" width="182">New $(PEGASUS_MOF_DIR) containing packaged mof files
1637 created.</td>
1638 <td align="left" width="285">Existing $(PEGASUS_MOF_DIR) removed and new $(PEGASUS_MOF_DIR)
1639 containing packaged mof files created.</td>
1640 <td align="left" width="200">Existing $(PEGASUS_MOF_DIR) removed.</td>
1641 </tr>
1642 </tbody></table>
1643 </ul>
1644 marek 1.1
1645 <p>
1646 <br>
1647
1648
1649
1650 </p>
1651
1652
1653
1654 <h5><a name="SecVariableDataFiles"></a>Variable Data Files</h5>
1655
1656 <p>This section describes OpenPegasus data files that change during normal operation.
1657 Files in this section are expected to be rooted in a single directory $(PEGASUS_VARDATA_DIR).</p>
1658
1659 <p>The following table describes the permissions that should be assigned to the
1660 files in the $(PEGASUS_VARDATA_DIR) directory.</p>
1661
1662 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="980" height="167">
1663 <tbody><tr>
1664 <th rowspan="2" bgcolor="#cae6ca" width="291" height="1">Document
1665 marek 1.1 Designation<br>
1666 Configuration Option</th>
1667 <th rowspan="2" bgcolor="#cae6ca" width="75" height="1">Packaged or Generated?</th>
1668 <th rowspan="2" bgcolor="#cae6ca" width="131" height="1">Operating System</th>
1669 <th rowspan="2" bgcolor="#cae6ca" width="178" height="1">Location</th>
1670 <th colspan="2" bgcolor="#cae6ca" width="285" height="16">Directory</th>
1671 </tr>
1672 <tr>
1673 <th bgcolor="#cae6ca" width="132" height="1">Owner<br>
1674 Group</th>
1675 <th bgcolor="#cae6ca" width="150" height="1">Permissions</th>
1676 </tr>
1677 <tr>
1678 <td rowspan="3" align="left" width="291" height="21">$(PEGASUS_CIMSERVER_START_LOCK_FILE)</td>
1679 <td rowspan="3" align="left" width="75" height="21">Generated</td>
1680 <td align="center" width="131" height="6">Linux</td>
1681 <td align="left" width="178" height="5">/var/run/tog-pegasus/<br>
1682 cimserver_start.lock</td>
1683 <td align="center" width="132" height="6">root/root<p> cimsvr cimsvr
1684 (PS)</p></td>
1685 <td align="center" width="150" height="6">-rw------- </td>
1686 marek 1.1 </tr>
1687 <tr>
1688 <td align="center" width="131" height="1">HP-UX</td>
1689 <td align="left" width="178" height="2"><br>
1690 </td>
1691 <td align="center" width="132" height="1"><br>
1692 </td>
1693 <td align="center" width="150" height="1"><br>
1694 </td>
1695 </tr>
1696 <tr>
1697 <td align="center" width="131" height="11">OpenVMS</td>
1698 <td align="left" width="178" height="11"><br>
1699 </td>
1700 <td align="center" width="132" height="11"><br>
1701 </td>
1702 <td align="center" width="150" height="11"><br>
1703 </td>
1704 </tr>
1705 <tr>
1706 <td rowspan="3" align="left" width="291" height="21">$(PEGASUS_CURRENT<br>
1707 marek 1.1 _CONFIG_FILE)</td>
1708 <td rowspan="3" align="left" width="75" height="21">Generated</td>
1709 <td align="center" width="131" height="6">Linux</td>
1710 <td align="left" width="178" height="5">$(PEGASUS_VARDATA_DIR)/<br>
1711 cimserver_current.conf</td>
1712 <td align="center" width="132" height="6">root/root</td>
1713 <td align="center" width="150" height="6">-rw-r--r-- </td>
1714 </tr>
1715 <tr>
1716 <td align="center" width="131" height="1">HP-UX</td>
1717 <td align="left" width="178" height="2">/var/opt/wbem/pegasus/<br>
1718 cimserver_current.conf</td>
1719 <td align="center" width="132" height="1">root/root</td>
1720 <td align="center" width="150" height="1">rw-r--r--</td>
1721 </tr>
1722 <tr>
1723 <td align="center" width="131" height="11">OpenVMS</td>
1724 <td align="left" width="178" height="11">/var/opt/wbem/pegasus/<br>
1725 cimserver_current.conf</td>
1726 <td align="center" width="132" height="11">system</td>
1727 <td align="center" width="150" height="11">S:wred,O:wr,G:r,W:r</td>
1728 marek 1.1 </tr>
1729 <tr>
1730 <td rowspan="3" align="left" width="291" height="21">$(PEGASUS_PLANNED<br>
1731 _CONFIG_FILE)<br>
1732 </td>
1733 <td rowspan="3" align="left" width="75" height="21">Packaged</td>
1734 <td align="center" width="131" height="6">Linux</td>
1735 <td align="left" width="178" height="5">$(PEGASUS_VARDATA_DIR)/<p>
1736 cimserver_planned.conf</p></td>
1737 <td align="center" width="132" height="6">root/root</td>
1738 <td align="center" width="150" height="6">-rw-r--r-- </td>
1739 </tr>
1740 <tr>
1741 <td align="center" width="131" height="1">HP-UX</td>
1742 <td align="left" width="178" height="2">/var/opt/wbem/<p>
1743 cimserver_planned.conf</p>
1744 </td>
1745 <td align="center" width="132" height="1">root/root</td>
1746 <td align="center" width="150" height="1">rw-r--r--</td>
1747 </tr>
1748 <tr>
1749 marek 1.1 <td align="center" width="131" height="11">OpenVMS</td>
1750 <td align="left" width="178" height="11">/var/opt/wbem/<p>
1751 cimserver_planned.conf</p>
1752 </td>
1753 <td align="center" width="132" height="11">system</td>
1754 <td align="center" width="150" height="11">S:wred,O:wr,G:r,W:r</td>
1755 </tr>
1756 <tr>
1757 <td rowspan="3" align="left" width="291" height="19">$(PEGASUS_PID_FILE)</td>
1758 <td rowspan="3" align="left" width="75" height="19">Generated</td>
1759 <td align="center" width="131" height="6">Linux</td>
1760 <td align="left" width="178" height="5">/var/run/tog-pegasus/cimserver.pid</td>
1761 <td align="center" width="132" height="6">root/root<p>cimsvr/cimsvr (PS)</p></td>
1762 <td align="center" width="150" height="6">-rw-------</td>
1763 </tr>
1764 <tr>
1765 <td align="center" width="131" height="1">HP-UX</td>
1766 <td align="left" width="178" height="2">/etc/opt/wbem/<br>
1767 cimserver_start.conf</td>
1768 <td align="center" width="132" height="1">root/root</td>
1769 <td align="center" width="150" height="1">rw-r--r--</td>
1770 marek 1.1 </tr>
1771 <tr>
1772 <td align="center" width="131" height="9">OpenVMS</td>
1773 <td align="left" width="178" height="9">/var/opt/wbem/<br>
1774 cimserver_start.conf</td>
1775 <td align="center" width="132" height="9">system</td>
1776 <td align="center" width="150" height="9">S:wred,O:wr,G:r,W:r</td>
1777 </tr>
1778 <tr>
1779 <td rowspan="3" align="left" width="291" height="21">$(PEGASUS_LOCAL_AUTH_DIR)</td>
1780 <td rowspan="3" align="left" width="75" height="21">Generated</td>
1781 <td align="center" width="131" height="1">Linux</td>
1782 <td align="left" width="178" height="1">/$(PEGASUS_VARDATA_DIR)/cache/localauth</td>
1783 <td align="center" width="132" height="1">root/pegasus</td>
1784 <td align="center" width="150" height="1">drwxr-xr-x</td>
1785 </tr>
1786 <tr>
1787 <td align="center" width="131" height="1">HP-UX</td>
1788 <td align="left" width="178" height="1">/var/opt/wbem/localauth</td>
1789 <td align="center" width="132" height="1">bin/bin</td>
1790 <td align="center" width="150" height="1">dr-xr-xr-x</td>
1791 marek 1.1 </tr>
1792 <tr>
1793 <td align="center" width="131" height="20">OpenVMS</td>
1794 <td align="left" width="178" height="20">/var/opt/wbem/localauth</td>
1795 <td align="center" width="132" height="20">system</td>
1796 <td align="center" width="150" height="20">S:wred,O:re,G:re,W:e</td>
1797 </tr>
1798 <tr>
1799 <td rowspan="3" align="left" width="291" height="30">$(PEGASUS_LOCAL_DOMAIN<br>
1800 _SOCKET_DIR)</td>
1801 <td rowspan="3" align="left" width="75" height="30">Generated</td>
1802 <td align="center" width="131" height="6">Linux</td>
1803 <td align="left" width="178" height="5">/var/run/tog-pegasus/socket</td>
1804 <td align="center" width="132" height="6">root/pegasus<p>cimsvr/cimsvr (PS)</p></td>
1805 <td align="center" width="150" height="6">drwxr-xr-t</td>
1806 </tr>
1807 <tr>
1808 <td align="center" width="131" height="1">HP-UX</td>
1809 <td align="left" width="178" height="2">/var/opt/wbem/socket/</td>
1810 <td align="center" width="132" height="1">bin/bin</td>
1811 <td align="center" width="150" height="1">dr-xr-xr-t</td>
1812 marek 1.1 </tr>
1813 <tr>
1814 <td align="center" width="131" height="20"> </td>
1815 <td align="left" width="178" height="20"> </td>
1816 <td align="center" width="132" height="20"> </td>
1817 <td align="center" width="150" height="20"> </td>
1818 </tr>
1819 <tr>
1820 <td rowspan="3" align="left" width="291" height="21">$(PEGASUS_CIMSERVER<br>
1821 _RANDOMFILE)<br>
1822 <br>
1823 Note: This file is only required on platforms that do not support /dev/(u)random.</td>
1824 <td rowspan="3" align="left" width="75" height="21">Generated</td>
1825 <td align="center" width="131" height="6">Linux</td>
1826 <td align="left" width="178" height="5">N/A</td>
1827 <td align="center" width="132" height="6">N/A</td>
1828 <td align="center" width="150" height="6">N/A</td>
1829 </tr>
1830 <tr>
1831 <td align="center" width="131" height="1">HP-UX</td>
1832 <td align="left" width="178" height="2"> </td>
1833 marek 1.1 <td align="center" width="132" height="1"> </td>
1834 <td align="center" width="150" height="1"> </td>
1835 </tr>
1836 <tr>
1837 <td align="center" width="131" height="11">OpenVMS</td>
1838 <td align="left" width="178" height="11">/var/opt/wbem/ssl.rnd</td>
1839 <td align="center" width="132" height="11">system</td>
1840 <td align="center" width="150" height="11">S:wred,O:r,G:r,W:</td>
1841 </tr>
1842 <tr>
1843 <td rowspan="3" align="left" width="291" height="63">$(PEGASUS_TRACE_DIR)</td>
1844 <td align="left" width="75" height="21">Generated</td>
1845 <td align="center" width="131" height="6">Linux</td>
1846 <td align="left" width="178" height="11">$(PEGASUS_VARDATA_DIR)/cache/trace</td>
1847 <td align="center" width="132" height="6">root/pegasus</td>
1848 <td align="center" width="150" height="6">drwxrwxrwt</td>
1849 </tr>
1850 <tr>
1851 <td align="left" width="75" height="21"> </td>
1852 <td align="center" width="131" height="1">HP-UX</td>
1853 <td align="left" width="178" height="11">/var/opt/wbem/trace<br>
1854 marek 1.1 </td>
1855 <td align="center" width="132" height="6">cimsrvr/cimsrvr<br>
1856 </td>
1857 <td align="center" width="150" height="6">drwxrwxrwt<br>
1858 </td>
1859 </tr>
1860 <tr>
1861 <td align="left" width="75" height="21"> </td>
1862 <td align="center" width="131" height="11">OpenVMS</td>
1863 <td align="left" width="178" height="11"> </td>
1864 <td align="center" width="132" height="11"> </td>
1865 <td align="center" width="150" height="11"><br>
1866 </td>
1867 </tr>
1868 <tr>
1869 <td rowspan="3" align="left" width="291" height="63">$(PEGASUS_CORE_DIR)</td>
1870 <td align="left" width="75" height="21">Generated</td>
1871 <td align="center" width="131" height="6">Linux</td>
1872 <td align="left" width="178" height="11">$(PEGASUS_VARDATA_DIR)/cache/trace</td>
1873 <td align="center" width="132" height="6">root/pegasus</td>
1874 <td align="center" width="150" height="6">drwxrwxrwt</td>
1875 marek 1.1 </tr>
1876 <tr>
1877 <td align="left" width="75" height="21"> </td>
1878 <td align="center" width="131" height="1">HP-UX</td>
1879 <td align="left" width="178" height="11"><br>
1880 </td>
1881 <td align="center" width="132" height="6"><br>
1882 </td>
1883 <td align="center" width="150" height="6"><br>
1884 </td>
1885 </tr>
1886 <tr>
1887 <td align="left" width="75" height="21"> </td>
1888 <td align="center" width="131" height="11">OpenVMS</td>
1889 <td align="left" width="178" height="11"> </td>
1890 <td align="center" width="132" height="11"> </td>
1891 <td align="center" width="150" height="11"><br>
1892 </td>
1893 </tr>
1894 </tbody></table>
1895
1896 marek 1.1 <p> </p>
1897
1898 <h5>$(PEGASUS_PLANNED_CONFIG_FILE)</h5>
1899
1900 <p>The $(PEGASUS_PLANNED_CONFIG_FILE) file is not intended to be user editable. The
1901 cimconfig utility should be used to modify this file. Default settings for
1902 configuration options are defined in the source and can vary by vendor,
1903 Operating System and release. In order to differentiate between "customer-defined"
1904 values and "default-settings", default-settings are not stored in this file.
1905 With the exception of the following comment, initial version of the $(PEGASUS_PLANNED_CONFIG_FILE)
1906 file is empty.
1907 </p><ul>
1908 <pre>########################################################################<br>## ##<br>## CIM Server Configuration File ##<br>## ##<br>########################################################################<br><br>########################################################################<br># #<br># This file contains CIM Server configuration data. The format of #<br># this file is subject to change. It is strongly recommended that #<br># users do not edit this file. Instead, the cimconfig command should #<br># be used to view or to request changes to the CIM Server #<br># configuration settings. Please refer to the cimconfig documentation #<br># for additional details. #<br># #<br>########################################################################</pre>
1909
1910 </ul>
1911
1912 <p>The following table describes the upgrade strategy for the
1913 PEGASUS_PLANNED_CONFIG_FILE.</p>
1914
1915 <ul>
1916
1917 marek 1.1 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="688" height="119">
1918 <tbody><tr>
1919 <th bgcolor="#cae6ca" width="175">File Name</th>
1920 <th bgcolor="#cae6ca" width="96">Operating System</th>
1921 <th bgcolor="#cae6ca" width="261">Description</th>
1922 <th bgcolor="#cae6ca" width="133">Install Option</th>
1923 </tr>
1924 <tr align="center">
1925 <td rowspan="4" width="175">$(PEGASUS_PLANNED_CONFIG_FILE) </td>
1926 </tr>
1927 <tr align="center">
1928 <td width="96">Linux</td>
1929 <td width="261">
1930 <p align="left"><b>Upgrade: </b>If the file has not been modified on disk, the rpm command will
1931 overwrite the file. If the file has been modified on disk, the rpm
1932 command will copy the new file with an extra file-name extension of .rpmnew.</p><p align="left">
1933 <b>Erase: </b>If the file has not been modified on disk, the file will
1934 be removed. If the file has been modified, the rpm command will save the
1935 file with an extra file-name extension of .rpmsave.</p></td>
1936 <td width="133">%config(noreplace)</td>
1937 </tr>
1938 marek 1.1 <tr align="center">
1939 <td width="96">HP-UX</td>
1940 <td width="261"> </td>
1941 <td width="133"> </td>
1942 </tr>
1943 <tr align="center">
1944 <td width="96">OpenVMS</td>
1945 <td width="261"> </td>
1946 <td width="133"> </td>
1947 </tr>
1948 </tbody></table>
1949 </ul>
1950
1951 <br>The following generated data files and directories are removed on upgrade
1952 and erase: $(PEGASUS_PLANNED_CONFIG_FILE), $(PEGASUS_PID_FILE), $(PEGASUS_LOCAL_AUTH_DIR), $(PEGASUS_LOCAL_DOMAIN_SOCKET_DIR)
1953 and $(PEGASUS_TRACE_DIR).<h5><a name="SecConfigFiles"></a>OpenPegasus Configuration Files</h5>
1954
1955 <p>This section describes OpenPegasus configuration files. Files in this section
1956 are expected to be rooted in a single directory $(PEGASUS_CONFIG_DIR).</p>
1957
1958
1959 marek 1.1 <ul>
1960
1961 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="604" height="119">
1962 <tbody><tr>
1963 <th rowspan="2" bgcolor="#cae6ca" width="206" height="1">File Name</th>
1964 <th rowspan="2" bgcolor="#cae6ca" width="220" height="1">Packaged or
1965 Generated?</th>
1966 <th rowspan="2" bgcolor="#cae6ca" width="205" height="1">Operating System</th>
1967 <th colspan="2" bgcolor="#cae6ca" width="486" height="16">File</th>
1968 </tr>
1969 <tr>
1970 <th bgcolor="#cae6ca" width="290" height="1">Owner/Group</th>
1971 <th bgcolor="#cae6ca" width="196" height="1">Permissions</th>
1972 </tr>
1973 <tr align="center">
1974 <td rowspan="3" width="206" height="52">ssl.cnf</td>
1975 <td rowspan="3" align="left" width="220" height="52">Generated</td>
1976 <td width="205" height="14">Linux</td>
1977 <td width="290" height="14">root/root</td>
1978 <td width="196" height="14">-r--------</td>
1979 </tr>
1980 marek 1.1 <tr>
1981 <td align="center" width="205" height="14">HP-UX</td>
1982 <td align="center" width="290" height="14">bin/bin</td>
1983 <td align="center" width="196" height="14">-r--------</td>
1984 </tr>
1985 <tr align="center">
1986 <td align="center" width="205" height="14">OpenVMS</td>
1987 <td align="center" width="290" height="14">system</td>
1988 <td align="center" width="196" height="14">S:wred,O:r,G:,W:</td>
1989 </tr>
1990 </tbody></table>
1991 </ul>
1992
1993 <br>
1994
1995 <p>The following table describes the recommended install, upgrade and remove
1996 behavior for the OpenPegasus ssl.cnf file.</p>
1997
1998 <ul>
1999 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="470">
2000 <tbody><tr>
2001 marek 1.1 <th bgcolor="#cae6ca" width="99">Install Type</th>
2002 <th bgcolor="#cae6ca" width="358">Actions</th>
2003 </tr>
2004 <tr align="center">
2005 <td width="99">Install</td>
2006 <td align="left" width="358">
2007 <li>The OpenPegasus ssl.cnf file is not created by default. The genOpenPegasusSSLCerts
2008 script can be used to a default ssl.cnf file.</li>
2009 </td>
2010 </tr>
2011 <tr align="center">
2012 <td width="99">Upgrade</td>
2013 <td align="left" width="358">
2014 <li>The ssl.cnf file is not updated.</li>
2015 </td>
2016 </tr>
2017 <tr align="center">
2018 <td width="99">Remove</td>
2019 <td align="left" width="358">
2020 <li>The ssl.cnf file is not removed.</li>
2021 </td>
2022 marek 1.1 </tr>
2023 </tbody></table>
2024
2025 </ul>
2026
2027 <h5><a name="SecPEMFiles"></a>OpenSSL PEM Files</h5>
2028
2029 <p>This section describes the OpenSSL PEM files.
2030 Files in this section are expected to be rooted in a single directory $(PEGASUS_PEM_DIR).</p>
2031
2032
2033 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="711" height="302">
2034 <tbody><tr>
2035 <th rowspan="2" bgcolor="#cae6ca" width="208" height="37">File Name<p>see
2036 PEP 308</p></th>
2037 <th rowspan="2" bgcolor="#cae6ca" width="105" height="37">Packaged or Generated?</th>
2038 <th rowspan="2" bgcolor="#cae6ca" width="73" height="37">File Name</th>
2039 <th rowspan="2" bgcolor="#cae6ca" width="81" height="37">Operating System</th>
2040 <th colspan="2" bgcolor="#cae6ca" width="215" height="16">File</th>
2041 </tr>
2042 <tr>
2043 marek 1.1 <th bgcolor="#cae6ca" width="91" height="16">Owner/Group</th>
2044 <th bgcolor="#cae6ca" width="120" height="16">Permissions</th>
2045 </tr>
2046 <tr align="center">
2047 <td rowspan="3" width="208" height="52">sslKeyFilePath<br>
2048 $(PEGASUS_SSL_KEY_FILE)</td>
2049 <td rowspan="3" align="left" width="105" height="52">
2050 <p align="center">Generated</p></td>
2051 <td width="73" height="14">file.pem</td>
2052 <td width="81" height="14">Linux</td>
2053 <td width="91" height="14">root/root</td>
2054 <td width="120" height="14">-r--------</td>
2055 </tr>
2056 <tr>
2057 <td align="center" width="73" height="14"> </td>
2058 <td align="center" width="81" height="14">HP-UX</td>
2059 <td align="center" width="91" height="14">bin/bin</td>
2060 <td align="center" width="120" height="14">-r--------</td>
2061 </tr>
2062 <tr align="center">
2063 <td align="center" width="73" height="14"> </td>
2064 marek 1.1 <td align="center" width="81" height="14">OpenVMS</td>
2065 <td align="center" width="91" height="14">system</td>
2066 <td align="center" width="120" height="14">S:wred,O:r,G:,W</td>
2067 </tr>
2068 <tr>
2069 <td rowspan="3" align="center" width="208" height="65">sslTrustStore<br>
2070 $(PEGASUS_SSL_TRUSTSTORE)</td>
2071 <td rowspan="3" align="center" width="105" height="65">Empty File</td>
2072 <td align="center" width="73" height="14">client.pem</td>
2073 <td align="center" width="81" height="14">Linux</td>
2074 <td align="center" width="91" height="14">root/root</td>
2075 <td align="center" width="120" height="14">-r--r--r--</td>
2076 </tr>
2077 <tr>
2078 <td align="center" width="73" height="14"> </td>
2079 <td align="center" width="81" height="14">HP-UX</td>
2080 <td align="center" width="91" height="14">root/sys</td>
2081 <td align="center" width="120" height="14">-r--------</td>
2082 </tr>
2083 <tr>
2084 <td align="center" width="73" height="8"> </td>
2085 marek 1.1 <td align="center" width="81" height="8">OpenVMS</td>
2086 <td align="center" width="91" height="8">system</td>
2087 <td align="center" width="120" height="8">S:wred,O:r,G:,W:</td>
2088 </tr>
2089 <tr>
2090 <td rowspan="4" align="center" width="208" height="52">
2091 sslCertificateFilePath<p>$(PEGASUS_SSL_CERT_FILE)</p></td>
2092 <td rowspan="3" align="left" width="105" height="52">
2093 <p align="center">Generated</p></td>
2094 <td align="center" width="73" height="14">server.pem</td>
2095 <td align="center" width="81" height="14">Linux</td>
2096 <td align="center" width="91" height="14">root/root</td>
2097 <td align="center" width="120" height="14">-r--r--r--</td>
2098 </tr>
2099 <tr>
2100 <td align="center" width="73" height="14"> </td>
2101 <td align="center" width="81" height="14">HP-UX</td>
2102 <td align="center" width="91" height="14">root/sys</td>
2103 <td align="center" width="120" height="14">-r--------</td>
2104 </tr>
2105 <tr>
2106 marek 1.1 <td align="center" width="73" height="14"> </td>
2107 <td align="center" width="81" height="14">OpenVMS</td>
2108 <td align="center" width="91" height="14">system</td>
2109 <td align="center" width="120" height="14">S:wred,O:r,G:,W:</td>
2110 </tr>
2111 </tbody></table>
2112
2113 <br>
2114
2115 <p>The following table describes the recommended install, upgrade and remove
2116 behavior for the OpenPegasus *.pem files.</p>
2117
2118 </dd>
2119
2120 </dl>
2121
2122
2123
2124
2125 <ul>
2126
2127 marek 1.1
2128 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="470">
2129 <tbody><tr>
2130 <th bgcolor="#cae6ca" width="99">Install Type</th>
2131 <th bgcolor="#cae6ca" width="358">Actions</th>
2132 </tr>
2133 <tr align="center">
2134 <td width="99">Install</td>
2135 <td align="left" width="358">
2136 <li>The *.pem files are not created by default. The genOpenPegasusSSLCerts
2137 script can be used to create self-signed *.pem files.</li>
2138 </td>
2139 </tr>
2140 <tr align="center">
2141 <td width="99">Upgrade</td>
2142 <td align="left" width="358">
2143 <li>The *.pem files are not updated.</li>
2144 </td>
2145 </tr>
2146 <tr align="center">
2147 <td width="99">Remove</td>
2148 marek 1.1 <td align="left" width="358">
2149 <li>The *.pem files are not removed.</li>
2150 </td>
2151 </tr>
2152 </tbody></table>
2153
2154 </ul>
2155
2156
2157
2158 <h5><a name="SecPAMConfigFiles"></a>PAM Configuration Files</h5>
2159
2160
2161
2162 <p>This section describes OpenPegasus configuration files. </p>
2163
2164
2165
2166 <ul>
2167
2168
2169 marek 1.1
2170 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="714" height="119">
2171 <tbody><tr>
2172 <th rowspan="2" bgcolor="#cae6ca" width="206" height="1">File Name</th>
2173 <th rowspan="2" bgcolor="#cae6ca" width="207" height="1">Packaged or
2174 Generated?</th>
2175 <th rowspan="2" bgcolor="#cae6ca" width="112" height="1">Operating System</th>
2176 <th colspan="2" bgcolor="#cae6ca" width="178" height="16">File</th>
2177 </tr>
2178 <tr>
2179 <th bgcolor="#cae6ca" width="85" height="1">Owner/Group</th>
2180 <th bgcolor="#cae6ca" width="99" height="1">Permissions</th>
2181 </tr>
2182 <tr align="center">
2183 <td rowspan="4" width="206" height="52">$(PAM_CONFIG_DIR)/wbem</td>
2184 </tr>
2185 <tr align="center">
2186 <td rowspan="3" width="207" height="52">
2187 Packaged</td>
2188 <td width="112" height="14">Linux</td>
2189 <td width="85" height="14">root/pegasus</td>
2190 marek 1.1 <td width="99" height="14">-rw-------</td>
2191 </tr>
2192 <tr>
2193 <td align="center" width="112" height="14">HP-UX</td>
2194 <td align="center" width="85" height="14"> </td>
2195 <td align="center" width="99" height="14"> </td>
2196 </tr>
2197 <tr align="center">
2198 <td align="center" width="112" height="14">OpenVMS</td>
2199 <td align="center" width="85" height="14"> </td>
2200 <td align="center" width="99" height="14"> </td>
2201 </tr>
2202 <tr>
2203 <td rowspan="4" align="center" width="206" height="52">$(PEGASUS_CONFIG_DIR)/access.conf</td>
2204 </tr>
2205 <tr align="center">
2206 <td rowspan="3" width="207" height="52">
2207 Packaged</td>
2208 <td width="112" height="14">Linux</td>
2209 <td width="85" height="14">root/pegasus</td>
2210 <td width="99" height="14">-rw-------</td>
2211 marek 1.1 </tr>
2212 <tr>
2213 <td align="center" width="112" height="14">HP-UX</td>
2214 <td align="center" width="85" height="14"> </td>
2215 <td align="center" width="99" height="14"> </td>
2216 </tr>
2217 <tr align="center">
2218 <td align="center" width="112" height="14">OpenVMS</td>
2219 <td align="center" width="85" height="14"> </td>
2220 <td align="center" width="99" height="14"> </td>
2221 </tr>
2222 </tbody></table>
2223 </ul>
2224
2225
2226
2227 <p>
2228
2229 <br>
2230
2231 </p>
2232 marek 1.1
2233
2234
2235 <p>The following table describes the upgrade strategy for the PAM configuration
2236 files.</p>
2237
2238
2239
2240 <ul>
2241
2242
2243
2244 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="688" height="119">
2245 <tbody><tr>
2246 <th bgcolor="#cae6ca" width="175">File Name</th>
2247 <th bgcolor="#cae6ca" width="96">Operating System</th>
2248 <th bgcolor="#cae6ca" width="264">Description</th>
2249 <th bgcolor="#cae6ca" width="130">Install Option</th>
2250 </tr>
2251 <tr align="center">
2252 <td rowspan="4" width="175">$(PAM_CONFIG_DIR)/wbem</td>
2253 marek 1.1 </tr>
2254 <tr align="center">
2255 <td width="96">Linux</td>
2256 <td width="264">
2257 <p align="left"><b>Upgrade: </b>If the file has not been modified on disk, the rpm command will
2258 overwrite the file. If the file has been modified on disk, the rpm
2259 command will copy the new file with an extra file-name extension of .rpmnew.</p><p align="left">
2260 <b>Erase: </b>If the file has not been modified on disk, the file will
2261 be removed. If the file has been modified, the rpm command will save the
2262 file with an extra file-name extension of .rpmsave.</p></td>
2263 <td width="130">%config(noreplace)</td>
2264 </tr>
2265 <tr align="center">
2266 <td width="96">HP-UX</td>
2267 <td width="264"> </td>
2268 <td width="130"> </td>
2269 </tr>
2270 <tr align="center">
2271 <td width="96">OpenVMS</td>
2272 <td width="264"> </td>
2273 <td width="130"> </td>
2274 marek 1.1 </tr>
2275 <tr>
2276 <td rowspan="4" width="175">$(PEGASUS_CONFIG_DIR)/<br>
2277 access.conf</td>
2278 </tr>
2279 <tr align="center">
2280 <td width="96">Linux</td>
2281 <td width="264">
2282 <p align="left"><b>Upgrade: </b>If the file has not been modified on disk, the rpm command will
2283 overwrite the file. If the file has been modified on disk, the rpm
2284 command will copy the new file with an extra file-name extension of .rpmnew.</p><p align="left">
2285 <b>Erase: </b>If the file has not been modified on disk, the file will
2286 be removed. If the file has been modified, the rpm command will save the
2287 file with an extra file-name extension of .rpmsave.</p></td>
2288 <td width="130">%config(noreplace)</td>
2289 </tr>
2290 <tr align="center">
2291 <td width="96">HP-UX</td>
2292 <td width="264"> </td>
2293 <td width="130"> </td>
2294 </tr>
2295 marek 1.1 <tr align="center">
2296 <td width="96">OpenVMS</td>
2297 <td width="264"> </td>
2298 <td width="130"> </td>
2299 </tr>
2300 </tbody></table>
2301 </ul>
2302
2303
2304
2305 <h5><a name="SecRepositoryDataFiles"></a>Repository Data Files</h5>
2306
2307
2308
2309 <p>This section describes the installation of the Repository Data Files.
2310 Files in this section are expected to be rooted in a single
2311 directory $(PEGASUS_REPOSITORY_DIR).</p>
2312
2313
2314
2315 <p>The following table describes the recommended install, upgrade and remove
2316 marek 1.1 behavior for the OpenPegasus Repository data files.</p>
2317
2318
2319
2320 <ul>
2321
2322
2323 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="712">
2324 <tbody><tr>
2325 <th bgcolor="#cae6ca" width="99">Install Type</th>
2326 <th bgcolor="#cae6ca" width="600">Actions</th>
2327 </tr>
2328 <tr align="center">
2329 <td width="99">Install</td>
2330 <td align="left" width="600">
2331 <li>The packaged Repository data files are installed in $(PEGASUS_REPOSITORY_DIR).</li>
2332 </td>
2333 </tr>
2334 <tr align="center">
2335 <td width="99">Upgrade</td>
2336 <td align="left" width="600">
2337 marek 1.1 <li>If $(PEGASUS_REPOSITORY_DIR) exists ... </li>
2338 <ul>
2339 <li>$(PEGASUS_PREV_REPOSITORY_DIR) is saved as an archive file.</li>
2340 <li>$(PEGASUS_REPOSITORY_DIR) renamed to $(PEGASUS_PREV_REPOSITORY_DIR).</li>
2341 </ul>
2342 <li>The packaged Repository data files are installed in $(PEGASUS_REPOSITORY_DIR).</li>
2343 <li>If $(PEGASUS_PREV_REPOSITORY_DIR) exists, the repupgrade utility
2344 is used to merge changes from $(PEGASUS_PREV_REPOSITORY_DIR) to $(PEGASUS_REPOSITORY_DIR).
2345 Once the upgrade is complete, $(PEGASUS_PREV_REPOSITORY_DIR) is saved
2346 as an archive file.</li>
2347 </td>
2348 </tr>
2349 <tr align="center">
2350 <td width="99">Remove</td>
2351 <td align="left" width="600">
2352 <li>If it exists, $(PEGASUS_PREV_REPOSITORY_DIR) is saved as an
2353 archive file.</li>
2354 <li>If it exists, $(PEGASUS_REPOSITORY_DIR) is saved as an archive.</li>
2355 </td>
2356 </tr>
2357 </tbody></table>
2358 marek 1.1
2359 </ul>
2360
2361
2362
2363 <h3><font color="#800080"><a name="SecBuild"></a></font>OpenPegasus Build
2364 & Installs Steps</h3>
2365
2366
2367
2368
2369 <p>For supported Operating Systems, pegasus/Makefile.Release can be used to perform the steps
2370 necessary to build and place the necessary OpenPegasus release files in a
2371 staging directory, PEGASUS_STAGING_DIR. </p>
2372
2373
2374
2375 <ul>
2376
2377
2378 <p>$(MAKE) -f pegasus/Makefile.Release rebuild</p>
2379 marek 1.1 </ul>
2380
2381
2382
2383 <p>For successful operation, Makefile.Release is dependent on the existence of
2384 an operating system dependent file that defines the setting of key
2385 environment variables. Two sample files have been placed in the pegasus
2386 directory: env_var_HPUX.status and env_var_Linux.status.</p>
2387
2388
2389
2390 <p>Use of this utility has been tested on the following platforms.</p>
2391
2392
2393
2394 <ul>
2395
2396
2397 <li>Linux</li>
2398 <li>HP-UX</li>
2399 </ul>
2400 marek 1.1
2401
2402
2403 <h2><font color="#000000">References</font></h2>
2404
2405
2406 <p>Note: Starting with the OpenPegasus 2.9.0 release, the OpenPegasus Build and
2407 Configuration Options document is available in OpenPegasus CVS Repository,
2408 pegasus/doc/BuildAndReleaseOptions.html.</p>
2409
2410
2411 <ol>
2412
2413
2414 <li>
2415 <a href="http://www.openpegasus.org/pp/uploads/40/6160/PEP174_RecommendedReleaseOptions.htm">
2416 PEP#174 - Recommended OpenPegasus 2.4 Build and Configuration Options</a>
2417 </li>
2418 <li> <a href="http://www.openpegasus.org/pp/uploads/40/8502/PEP200_RecommendedReleaseOptions.htm">
2419 PEP#200 - Recommended OpenPegasus 2.5 Build and Configuration Options</a>
2420 </li>
2421 marek 1.1 <li>
2422 <a href="http://www.openpegasus.org/pp/uploads/40/10083/PEP237_RecommendedReleaseOptions.htm">
2423 PEP#237 - Recommended OpenPegasus 2.5.1 Build and Configuration Options</a></li>
2424 <li>
2425 <a href="http://www.openpegasus.org/pp/protected/upreviews/20/2096/PEP277_RecommendedReleaseOptions.htm">
2426 PEP#277 - Recommended OpenPegasus 2.6.0 Build and Configuration Options for
2427 Selected Platforms</a></li>
2428 <li>
2429 <a href="http://www.openpegasus.org/pp/uploads/40/14873/PEP292_RecommendedReleaseOptions.htm">
2430 PEP#292 - Recommended OpenPegasus 2.7.0 Build and Configuration Options for
2431 Selected Platforms</a></li>
2432 <li>
2433 <a href="http://www.openpegasus.org/pp/uploads/40/16781/PEP308_RecommendedReleaseOptions.htm">
2434 PEP#308 - Recommended OpenPegasus 2.8.0 Build and Configuration Options for
2435 Selected Platforms</a></li>
2436
2437 </ol>
2438
2439
2440
2441
2442 marek 1.1
2443
2444 <h2><font color="#000000">Rationale</font></h2>
2445
2446
2447
2448 <h2><font color="#000000">Schedule</font></h2>
2449
2450
2451
2452 <h2><font color="#000000">Discussion</font></h2>
2453
2454
2455
2456 <hr>
2457
2458 <p>Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;<br>
2459 EMC Corporation; Symantec Corporation; The Open Group.<br>
2460 <br>
2461 Permission is hereby granted, free of charge, to any person obtaining a copy<br>
2462 of this software and associated documentation files (the "Software"), to<br>
2463 marek 1.1 deal in the Software without restriction, including without limitation the<br>
2464 rights to use, copy, modify, merge, publish, distribute, sublicense, and/or<br>
2465 sell copies of the Software, and to permit persons to whom the Software is<br>
2466 furnished to do so, subject to the following conditions:<br>
2467 <br>
2468 THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN<br>
2469 ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED<br>
2470 "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT<br>
2471 LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR<br>
2472 PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT<br>
2473 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN<br>
2474 ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION<br>
2475 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p>
2476
2477
2478 <hr>
2479 <p>Template last modified: <b>March 26th 2006</b> by <b>Martin Kirk<br>
2480 </b>Template version: <b>1.11</b></p>
2481
2482
2483
|