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>
|
718 marek 1.1
719 libpeggetoopt.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
720 libpeghandlerservice.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
721 libpegindicationservice.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
722 libpeglistener.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
723 libpegpmservice.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
724 libpegprm.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
725 libpegprovider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
726 libpegprovidermanager.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
727 libpegquerycommon.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
728 libpegqueryexpression.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
729 libpegrepository.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
730 libpegserver.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
731 libpegservice.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
732 libpeguser.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
733 libpegwql.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
734 libsnmpIndicationHandler.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
735 </p>
736
737 </ul>
738
739 marek 1.1 <p>In addition, the following links should be included in the $(PEGASUS_DEST_LIB_DIR)
740 directory.<br>
741 <br>
742
743 libCIMxmlIndicationHandler.$(LIB_SUFFIX) -> libCIMxmlIndicationHandler.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
744
745 libDefaultProviderManager.$(LIB_SUFFIX) -> libDefaultProviderManager.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
746
747 libpegclient.$(LIB_SUFFIX) -> libpegclient.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
748
749 libpegcommon.$(LIB_SUFFIX) -> libpegcommon.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
750
751 libpegprovider.$(LIB_SUFFIX) -> libpegprovider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
752
753 libsnmpIndicationHandler.$(LIB_SUFFIX) -> libsnmpIndicationHandler.$(LIB_SUFFIX).$(VER_SUFFIX)
754
755 </p><p> </p><p>The following table describes the recommended install, upgrade and remove
756 behavior for the OpenPegasus libraries and links.</p>
757 <ul>
758 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="565">
759 <tbody><tr>
760 marek 1.1 <th bgcolor="#cae6ca" width="168"> </th>
761 <th bgcolor="#cae6ca" width="255">install</th>
762 <th bgcolor="#cae6ca" width="359">upgrade</th>
763 <th bgcolor="#cae6ca" width="280">remove</th>
764 </tr>
765 <tr align="center">
766 <td width="168">*.$(VER_SUFFIX)</td>
767 <td width="255">new libraries installed</td>
768 <td width="359">existing libraries replaced with new libraries</td>
769 <td width="280">existing libraries removed</td>
770 </tr>
771 <tr align="center">
772 <td width="168">*.$(LIB_SUFFIX)</td>
773 <td width="255">new links installed</td>
774 <td width="359">existing links replaced with new links</td>
775 <td width="280">existing links removed</td>
776 </tr>
777 </tbody></table>
778 </ul>
779
780 <h5><a name="SecProviderManagers"></a>OpenPegasus Provider Managers</h5>
781 marek 1.1
782 <p>This section documents the dynamically loaded provider managers
783 packaged with OpenPegasus. Files in this section are expected to
784 be rooted in a single directory $(PEGASUS_PROVIDER_MANAGER_LIB_DIR).</p>
785
786 <p><b>Source Location: </b>$(PEGASUS_HOME)/lib</p>
787
788 <p>The following table describes the permissions that should be assigned to the
789 files in the $(PEGASUS_PROVIDER_MANAGER_LIB_DIR) directory.</p>
790
791 <ul>
792
793 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" id="table1" border="1" cellspacing="1" width="438">
794 <tbody><tr>
795 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
796 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
797 </tr>
798 <tr>
799 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
800 <th bgcolor="#cae6ca" width="199">Permissions</th>
801 </tr>
802 marek 1.1 <tr align="center">
803 <td width="203">Linux</td>
804 <td width="194">root/pegasus</td>
805 <td width="199">-rwxr-xr-x</td>
806 </tr>
807 <tr align="center">
808 <td width="203">HP-UX</td>
809 <td width="194">bin/bin</td>
810 <td width="199">-r-xr-xr-x</td>
811 </tr>
812 <tr align="center">
813 <td width="203">OpenVMS</td>
814 <td width="194">system</td>
815 <td width="199">S:wred,O:re,G:re,W:e</td>
816 </tr>
817 </tbody></table>
818
819 </ul>
820
821 <p> </p>
822
823 marek 1.1 <p>The following files should be included in the $(PEGASUS_PROVIDER_MANAGER_LIB_DIR) directory.</p>
824
825 <ul>
826 <p>libCMPIProviderManager.$(LIB_SUFFIX).$(VER_SUFFIX)</p>
827 </ul>
828
829 <p>In addition, the following links should be included in the $(PEGASUS_DEST_LIB_DIR)
830 directory.<br>
831 <br>
832
833 libCMPIProviderManager.$(LIB_SUFFIX) -> libCMPIProviderManager.$(LIB_SUFFIX).$(VER_SUFFIX)</p>
834
835
836 <h5><a name="SecProviderLibraries"></a>OpenPegasus Provider Libraries</h5>
837
838 <p>This section documents the Providers packaged with OpenPegasus.
839 Files in this section are expected to be rooted in a single
840 directory $(PEGASUS_PROVIDER_LIB_DIR). Note that the $(PEGASUS_PROVIDER_LIB_DIR)
841 directory MUST be included as one of the values of the <b>providerDir</b>
842 configuration parameter. Note that this directory may contain
843 symbolic links to the actual files, there is no requirement for the actual library file to be placed in
844 marek 1.1 this directory.</p>
845
846 <p><b>Packaged Providers</b></p>
847
848
849 <dl>
850 <dd>Operating System Provider<br>
851
852 Computer System Provider</dd><dd>
853 Process Provider</dd>
854 <dd>IP Provider<br>
855
856 </dd>
857 </dl>
858 </dl>
859
860 <dl>
861
862 <dl>
863 <dt>Additionally on HP-UX, following are the packaged Providers</dt>
864
865 marek 1.1 <dd>DNS Provider</dd>
866 <dd>NTP Provider</dd>
867 <dd>NIS Provider<br>
868
869 </dd>
870
871 <dt> </dt>
872 </dl>
873
874
875 <dd>The following table describes the permissions that should be assigned to the
876 links or files in the $(PEGASUS_PROVIDER_LIB_DIR) directory.<br><br>
877
878 <ul>
879
880 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
881 <tbody><tr>
882 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
883 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
884 </tr>
885 <tr>
886 marek 1.1 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
887 <th bgcolor="#cae6ca" width="199">Permissions</th>
888 </tr>
889 <tr align="center">
890 <td width="203">Linux</td>
891 <td width="194">root/pegasus</td>
892 <td width="199">-rwxr-xr-x</td>
893 </tr>
894 <tr align="center">
895 <td width="203">HP-UX</td>
896 <td width="194">bin/bin</td>
897 <td width="199">-r-xr-xr-x</td>
898 </tr>
899 <tr align="center">
900 <td width="203">OpenVMS</td>
901 <td width="194">system</td>
902 <td width="199">S:wred,O:re,G:re,W:e</td>
903 </tr>
904 </tbody></table>
905
906 </ul>
907 marek 1.1
908
909 <dl>
910 <dt> </dt>
911 </dl>
912
913 <p>The following files should be included in the $(PEGASUS_PROVIDER_LIB_DIR) directory.</p><dl>
914 <dd> </dd>
915 <dd>libComputerSystemProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
916 libOSProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
917 libProcessProvider.$(LIB_SUFFIX).(VER_SUFFIX)<p><b><br>
918 </b>
919 </p></dd></dl>
920
921 <p><b>Provider Library Versioning</b></p>
922
923 <p>The CIM Server will use the $(LIB_SUFFIX) when attempting to
924 dynamically load a Provider. This allows Provider developers to
925 use a resource-specific library versioning
926 strategy. Providers are not required to use this same version
927 suffix as the OpenPegasus libraries. </p>
928 marek 1.1
929 <p>The following links should be included in the $(PEGASUS_PROVIDER_LIB_DIR)
930 directory.</p>
931
932 <ul>
933 libComputerSystemProvider.$(LIB_SUFFIX) -> <br>
934 $(PEGASUS_PROVIDER_LIB_DIR)/libComputerSystemProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
935 libOSProvider.$(LIB_SUFFIX) ->
936 <p> $(PEGASUS_PROVIDER_LIB_DIR)/libOSProvider.$(LIB_SUFFIX).$(VER_SUFFIX)<br>
937 libProcessProvider.$(LIB_SUFFIX) -> <br>
938 $(PEGASUS_PROVIDER_LIB_DIR)/libProcessProvider.$(LIB_SUFFIX).$(VER_SUFFIX)</p>
939 </ul>
940
941 <p>The following table describes the recommended install, upgrade and remove
942 behavior for the packaged Provider libraries and links.</p>
943 <ul>
944 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="565">
945 <tbody><tr>
946 <th bgcolor="#cae6ca" width="168"> </th>
947 <th bgcolor="#cae6ca" width="255">install</th>
948 <th bgcolor="#cae6ca" width="359">upgrade</th>
949 marek 1.1 <th bgcolor="#cae6ca" width="280">remove</th>
950 </tr>
951 <tr align="center">
952 <td width="168">*.$(VER_SUFFIX)</td>
953 <td width="255">new libraries installed</td>
954 <td width="359">existing libraries replaced with new libraries</td>
955 <td width="280">existing libraries removed</td>
956 </tr>
957 <tr align="center">
958 <td width="168">*.$(LIB_SUFFIX)</td>
959 <td width="255">new links installed</td>
960 <td width="359">existing links replaced with new links</td>
961 <td width="280">existing links removed</td>
962 </tr>
963 </tbody></table>
964 </ul>
965
966 <h4><a name="SecExecutables"></a>Executable Files</h4>
967
968 <p>The following table describes the OpenPegasus executable suffixes.</p>
969
970 marek 1.1 <ul>
971 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="322">
972 <tbody><tr>
973 <th bgcolor="#cae6ca" width="168">Operating System</th>
974 <th bgcolor="#cae6ca" width="141">$(EXE_SUFFIX)</th>
975 </tr>
976 <tr align="center">
977 <td width="168">Linux</td>
978 <td width="141">NA</td>
979 </tr>
980 <tr align="center">
981 <td width="168">HP-UX (PA)</td>
982 <td width="141">NA</td>
983 </tr>
984 <tr align="center">
985 <td width="168">HP-UX (IA)</td>
986 <td width="141">NA</td>
987 </tr>
988 <tr align="center">
989 <td width="168">OpenVMS</td>
990 <td width="141">.exe</td>
991 marek 1.1 </tr>
992 </tbody></table>
993 </ul>
994
995 <h5><a name="SecAdminCommands"></a>OpenPegasus Administrative Commands</h5>
996
997 <p>This section documents <span class="normalfont">the maintenance or
998 administrative commands</span> included
999 with this release of OpenPegasus. Files in this section are
1000 expected to be rooted in a single directory $(PEGASUS_SBIN_DIR).</p>
1001
1002 <p><b>Source Location: </b>$(PEGASUS_HOME)/sbin</p>
1003
1004 <p>The following table describes the permissions that should be assigned to the
1005 files in the $(PEGASUS_SBIN_DIR) directory.</p>
1006
1007 <ul>
1008
1009 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
1010 <tbody><tr>
1011 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
1012 marek 1.1 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
1013 </tr>
1014 <tr>
1015 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
1016 <th bgcolor="#cae6ca" width="199">Permissions</th>
1017 </tr>
1018 <tr align="center">
1019 <td width="203">Linux</td>
1020 <td width="194">root/pegasus</td>
1021 <td width="199">-rwxr-xr-x</td>
1022 </tr>
1023 <tr align="center">
1024 <td width="203">HP-UX</td>
1025 <td width="194">bin/bin</td>
1026 <td width="199">-r-xr--r--</td>
1027 </tr>
1028 <tr align="center">
1029 <td width="203">OpenVMS</td>
1030 <td width="194">system</td>
1031 <td width="199">S:wred,O:re,G:re,W:e</td>
1032 </tr>
1033 marek 1.1 </tbody></table>
1034
1035 </ul>
1036
1037 <p> </p>
1038
1039 <p>The following files should be included in the $(PEGASUS_SBIN_DIR) directory.</p>
1040
1041 <ul>
1042 cimauth<br>
1043 cimconfig<br>
1044 cimprovagt<p><font face="Helvetica,Arial" size="-1">cimreparchive</font><br>
1045 cimserver<br>
1046 cimservera<br>
1047 cimservermain<br>
1048 cimshutdown<br>
1049 cimtrust<br>
1050 repupgrade<br>
1051 </p>
1052 </ul>
1053
1054 marek 1.1 <p>The following table describes the recommended install, upgrade and remove
1055 behavior for the OpenPegasus commands.</p>
1056 <ul>
1057 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="565">
1058 <tbody><tr>
1059 <th bgcolor="#cae6ca" width="255">install</th>
1060 <th bgcolor="#cae6ca" width="359">upgrade</th>
1061 <th bgcolor="#cae6ca" width="280">remove</th>
1062 </tr>
1063 <tr align="center">
1064 <td width="255">new executables installed</td>
1065 <td width="359">existing executables replaced with new executables</td>
1066 <td width="280">existing executables removed</td>
1067 </tr>
1068 </tbody></table>
1069 </ul>
1070
1071 <h5><a name="SecAdminScripts"></a>OpenPegasus Administrative Scripts</h5>
1072
1073 <p>This section documents <span class="normalfont">the scripts</span> included
1074 with this release of OpenPegasus. Files in this section are
1075 marek 1.1 expected to be rooted in a single directory $(PEGASUS_SCRIPTS_DIR).</p>
1076
1077 <p><b>Source Location: </b>pegasus/rpm/tog-specfiles</p>
1078
1079 <p>The following table describes the permissions that should be assigned to the
1080 files in the $(PEGASUS_SCRIPTS_DIR) directory.</p>
1081
1082 <ul>
1083
1084 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
1085 <tbody><tr>
1086 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
1087 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
1088 </tr>
1089 <tr>
1090 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
1091 <th bgcolor="#cae6ca" width="199">Permissions</th>
1092 </tr>
1093 <tr align="center">
1094 <td width="203">Linux</td>
1095 <td width="194">root/pegasus</td>
1096 marek 1.1 <td width="199">-rwxr-x---</td>
1097 </tr>
1098 <tr align="center">
1099 <td width="203">HP-UX</td>
1100 <td width="194"> </td>
1101 <td width="199"> </td>
1102 </tr>
1103 <tr align="center">
1104 <td width="203">OpenVMS</td>
1105 <td width="194"> </td>
1106 <td width="199"> </td>
1107 </tr>
1108 </tbody></table>
1109
1110 </ul>
1111
1112 <p> </p>
1113
1114 <p>The following files should be included in the $(PEGASUS_SCRIPTS_DIR) directory.</p>
1115
1116 <ul>
1117 marek 1.1 <p>genOpenPegasusSSLCerts<br>
1118 </p>
1119 </ul>
1120
1121 <p>The following table describes the recommended install, upgrade and remove
1122 behavior for the OpenPegasus commands.</p>
1123 <ul>
1124 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="565">
1125 <tbody><tr>
1126 <th bgcolor="#cae6ca" width="255">install</th>
1127 <th bgcolor="#cae6ca" width="359">upgrade</th>
1128 <th bgcolor="#cae6ca" width="280">remove</th>
1129 </tr>
1130 <tr align="center">
1131 <td width="255">new scripts installed</td>
1132 <td width="359">existing scripts replaced with new scripts</td>
1133 <td width="280">existing scripts removed</td>
1134 </tr>
1135 </tbody></table>
1136 </ul>
1137
1138 marek 1.1
1139 <h5><a name="SecUserCommands"></a>OpenPegasus User Commands</h5>
1140
1141 <p>This section documents <span class="normalfont">the user commands</span> included
1142 with this release of OpenPegasus. Files in this section are
1143 expected to be rooted in a single directory $(PEGASUS_BIN_DIR).</p>
1144
1145 <p><b>Source Location: </b>$(PEGASUS_HOME)/bin</p>
1146
1147 <p>The following table describes the permissions that should be assigned to the
1148 files in the $(PEGASUS_BIN_DIR) directory.</p>
1149
1150 <ul>
1151
1152 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
1153 <tbody><tr>
1154 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
1155 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
1156 </tr>
1157 <tr>
1158 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
1159 marek 1.1 <th bgcolor="#cae6ca" width="199">Permissions</th>
1160 </tr>
1161 <tr align="center">
1162 <td width="203">Linux</td>
1163 <td width="194">root/pegasus</td>
1164 <td width="199">-rwxr-xr-x</td>
1165 </tr>
1166 <tr align="center">
1167 <td width="203">HP-UX</td>
1168 <td width="194">bin/bin</td>
1169 <td width="199">-r-xr-xr-x</td>
1170 </tr>
1171 <tr align="center">
1172 <td width="203">OpenVMS</td>
1173 <td width="194">system</td>
1174 <td width="199">S:wred,O:re,G:re,W:e</td>
1175 </tr>
1176 </tbody></table>
1177
1178 </ul>
1179
1180 marek 1.1 <p> </p>
1181
1182 <p>The following files should be included in the $(PEGASUS_BIN_DIR) directory.</p>
1183
1184 <ul>
1185 <p>cimmof</p><p>cimmofl<br>
1186 cimprovider<br>
1187 cimsub<br>
1188 osinfo<br>
1189 wbemexec<br>
1190 </p></ul>
1191
1192 <p> </p><p>The following table describes the recommended install, upgrade and remove
1193 behavior for the OpenPegasus commands.</p>
1194 <ul>
1195 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="565">
1196 <tbody><tr>
1197 <th bgcolor="#cae6ca" width="255">install</th>
1198 <th bgcolor="#cae6ca" width="359">upgrade</th>
1199 <th bgcolor="#cae6ca" width="280">remove</th>
1200 </tr>
1201 marek 1.1 <tr align="center">
1202 <td width="255">new executables installed</td>
1203 <td width="359">existing executables replaced with new executables</td>
1204 <td width="280">existing executables removed</td>
1205 </tr>
1206 </tbody></table>
1207 </ul>
1208
1209 <p><br>
1210
1211
1212 </p><h4><a name="SecDocumentation"></a>Documentation Files</h4>
1213
1214 <h5><a name="SecManPages"></a>Unix Style Man Pages</h5>
1215
1216 <p>This section describes the packaging for Operating Systems that support Unix
1217 style man pages. Files in this section are expected to be rooted in a single
1218 directory $(PEGASUS_MAN_DIR).</p>
1219
1220 <p><b>Source Location: </b>$(ROOT)/rpm/manLinux/man1.Z/<br>
1221 $(ROOT)/rpm/manLinux/man8.Z</p>
1222 marek 1.1
1223 <p>The following table describes the permissions that should be assigned to the
1224 files in the $(PEGASUS_MAN_DIR) subdirectories.</p>
1225
1226 <ul>
1227
1228 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
1229 <tbody><tr>
1230 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
1231 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
1232 </tr>
1233 <tr>
1234 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
1235 <th bgcolor="#cae6ca" width="199">Permissions</th>
1236 </tr>
1237 <tr align="center">
1238 <td width="203">Linux</td>
1239 <td width="194">root/pegasus</td>
1240 <td width="199">-rw-r--r--</td>
1241 </tr>
1242 <tr align="center">
1243 marek 1.1 <td width="203">HP-UX</td>
1244 <td width="194">bin/bin</td>
1245 <td width="199">-r--r--r--</td>
1246 </tr>
1247 <tr align="center">
1248 <td width="203">OpenVMS</td>
1249 <td width="194">system</td>
1250 <td width="199">S:wred,O:r,G:r,W:r</td>
1251 </tr>
1252 </tbody></table>
1253 </ul>
1254
1255 <p> </p>
1256
1257 <p>The following man pages should be included in the $(PEGASUS_MAN_DIR)/man1 directory.</p>
1258
1259 <ul>
1260 cimmof.1(.gz)<br>
1261 cimprovider.1(.gz)<br>
1262 cimsub.1(.gz)<br>
1263 osinfo.1(.gz)<br>
1264 marek 1.1 wbemexec.1(.gz)<br>
1265 </ul>
1266
1267
1268 <p> </p>
1269
1270
1271 <p>The following man pages should be included in the $(PEGASUS_MAN_DIR)/man8 directory.</p>
1272
1273
1274 <ul>
1275 cimauth.8(.gz)<br>
1276 cimconfig.8(.gz)<br>
1277 <font face="Helvetica,Arial" size="-1">cimreparchive.8(.gz)</font><p>
1278 <font face="Helvetica,Arial" size="-1">cimtrust.8(.gz)</font><br>
1279 cimserver.8(.gz)</p>
1280 <p> </p>
1281 </ul>
1282
1283 <p>The following table describes the recommended install, upgrade and remove
1284 behavior for the OpenPegasus man pages.</p>
1285 marek 1.1 <ul>
1286 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="506">
1287 <tbody><tr>
1288 <th bgcolor="#cae6ca" width="255">install</th>
1289 <th bgcolor="#cae6ca" width="307">upgrade</th>
1290 <th bgcolor="#cae6ca" width="273">remove</th>
1291 </tr>
1292 <tr align="center">
1293 <td width="255">new man pages installed</td>
1294 <td width="307">existing man pages replaced with new man pages</td>
1295 <td width="273">existing man pages removed</td>
1296 </tr>
1297 </tbody></table>
1298 </ul>
1299
1300 <h5><a name="UserDocumentation"></a>User Documentation</h5>
1301
1302 <p>Files in this section are expected to be rooted in a single directory $(PEGASUS_DOC_DIR).</p>
1303
1304 <p>The following table describes the permissions that should be assigned to the
1305 files in the $(PEGASUS_DOC_DIR) directory.</p>
1306 marek 1.1
1307 <ul>
1308
1309 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="438">
1310 <tbody><tr>
1311 <th rowspan="2" bgcolor="#cae6ca" width="203">Operating System</th>
1312 <th colspan="2" bgcolor="#cae6ca" width="393">File</th>
1313 </tr>
1314 <tr>
1315 <th bgcolor="#cae6ca" width="194">Owner/Group</th>
1316 <th bgcolor="#cae6ca" width="199">Permissions</th>
1317 </tr>
1318 <tr align="center">
1319 <td width="203">Linux</td>
1320 <td width="194">root/pegasus</td>
1321 <td width="199">-r--r--r--</td>
1322 </tr>
1323 <tr align="center">
1324 <td width="203">HP-UX</td>
1325 <td width="194">bin/bin</td>
1326 <td width="199"> </td>
1327 marek 1.1 </tr>
1328 <tr align="center">
1329 <td width="203">OpenVMS</td>
1330 <td width="194">system</td>
1331 <td width="199"> </td>
1332 </tr>
1333 </tbody></table>
1334
1335 </ul>
1336
1337 <p><br>
1338 <br>
1339 The following documents are included with OpenPegasus. </p>
1340
1341 <p><b>Staging Location: </b>$(PEGASUS_HOME)/$(PEGASUS_STAGING_DIR)/$(PEGASUS_DOC_DIR)</p>
1342
1343 <p><b>Target Location: </b>$(PEGASUS_DOC_DIR)</p>
1344
1345 <ul>
1346 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="476">
1347 <tbody><tr>
1348 marek 1.1 <th bgcolor="#cae6ca" width="282">File Name</th>
1349 <th bgcolor="#cae6ca" width="181">Source Location</th>
1350 </tr>
1351 <tr>
1352 <td width="282">Admin_Guide_Release.pdf</td>
1353 <td width="181">pegasus/doc</td>
1354 </tr>
1355 <tr>
1356 <td width="282">PegasusSSLGuidelines.htm</td>
1357 <td width="181">pegasus/doc</td>
1358 </tr>
1359 <tr>
1360 <td width="282">license.txt</td>
1361 <td width="181">pegasus/doc</td>
1362 </tr>
1363 <tr>
1364 <td width="282">OpenPegasusNOTICE.txt</td>
1365 <td width="181">pegasus</td>
1366 </tr>
1367 </tbody></table>
1368 </ul>
1369 marek 1.1
1370 <br>
1371
1372 <p>The following table describes the recommended install, upgrade and remove
1373 behavior for the OpenPegasus documentation files.</p>
1374 <ul>
1375 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="506">
1376 <tbody><tr>
1377 <th bgcolor="#cae6ca" width="255">install</th>
1378 <th bgcolor="#cae6ca" width="307">upgrade</th>
1379 <th bgcolor="#cae6ca" width="273">remove</th>
1380 </tr>
1381 <tr align="center">
1382 <td width="255">New documents installed.</td>
1383 <td width="307">Existing documents removed and new documents installed.</td>
1384 <td width="273">Existing documents removed.</td>
1385 </tr>
1386 </tbody></table>
1387 </ul>
1388
1389 <p>
1390 marek 1.1 <br>
1391
1392
1393
1394 </p>
1395
1396
1397
1398 <h4><a name="SecDataFiles"></a>Data Files</h4>
1399
1400 <p>This section describes the OpenPegasus data files. </p>
1401
1402 <p>There are three classes of OpenPegasus data files:</p>
1403
1404 <ol>
1405 <li><b>FIXED LOCATION. </b>Absolute names that are used by the CIM Server and
1406 fixed at build time. A rebuild is required to change the file name.
1407 The runtime file structure MUST be consistent with the build time definition
1408 of the FIXED LOCATION files. Refer to PEP 308 for recommended default values.</li>
1409 <li><b>CONFIGURABLE LOCATION.</b> Absolute file names that are used by the CIM Server and
1410 configurable using the cimconfig command. All CONFIGURABLE LOCATION
1411 marek 1.1 files are assigned a default value for the absolute file name. The runtime
1412 file structure WILL assume the default value. Refer to PEP 308 for recommended default values.</li>
1413 <li><b>INSTALLATION DEFINED LOCATION. </b>Files that are NOT used by the CIM Server but exist as
1414 part of the CIM Server runtime environment. Default absolute file names
1415 will be defined for these directories.</li>
1416 </ol>
1417
1418 <p> </p>
1419
1420
1421 <ul>
1422
1423 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="626" height="88">
1424 <tbody><tr>
1425 <th bgcolor="#cae6ca" width="282" height="1">Document Designation</th>
1426 <th bgcolor="#cae6ca" width="76" height="1">Type</th>
1427 <th bgcolor="#cae6ca" width="264" height="1">Build Configuration Option</th>
1428 </tr>
1429
1430 <tr>
1431 <td align="left" width="282" height="1">
1432 marek 1.1 <p align="left">$(PEGASUS_LOCAL_AUTH_DIR)</p></td>
1433 <td align="center" width="76" height="1">FIXED</td>
1434 <td width="264" height="1">
1435 <p align="left">PEGASUS_LOCAL_AUTH_DIR</p></td>
1436 </tr>
1437 <tr>
1438 <td align="left" width="282" height="1">
1439 $(PEGASUS_MOF_DIR)</td>
1440 <td align="center" width="76" height="1">INSTALL</td>
1441 <td width="264" height="1">
1442 <br>
1443 </td>
1444 </tr>
1445 <tr>
1446 <td align="left" width="282" height="1">
1447 <p align="left">$(PEGASUS_LOCAL_DOMAIN_SOCKET_DIR)</p></td>
1448 <td align="center" width="76" height="1">FIXED</td>
1449 <td width="264" height="1">
1450 <p align="left">PEGASUS_LOCAL_DOMAIN_SOCKET_PATH</p></td>
1451 </tr>
1452 <tr>
1453 marek 1.1 <td align="left" width="282" height="1">
1454 $(PEGASUS_CURRENT_CONFIG_FILE)</td>
1455 <td align="center" width="76" height="1">FIXED</td>
1456 <td width="264" height="1">
1457 CURRENT_CONFIG_FILE []</td>
1458 </tr>
1459 <tr>
1460 <td align="left" width="282" height="1">
1461 $(PEGASUS_PLANNED_CONFIG_FILE)</td>
1462 <td align="center" width="76" height="1">FIXED</td>
1463 <td width="264" height="1">
1464 PLANNED_CONFIG_FILE []</td>
1465 </tr>
1466 <tr>
1467 <td align="left" width="282" height="1">
1468 $(PEGASUS_PID_FILE)</td>
1469 <td align="center" width="76" height="1">FIXED</td>
1470 <td width="264" height="1">
1471 CIMSERVER_START_FILE [] </td>
1472 </tr>
1473 <tr>
1474 marek 1.1 <td align="left" width="282" height="1">
1475 $(PEGASUS_CIMSERVER_RANDOMFILE)</td>
1476 <td align="center" width="76" height="1">FIXED</td>
1477 <td width="264" height="1">
1478 PEGASUS_SSLSERVER_RANDOMFILE</td>
1479 </tr>
1480 </tbody></table>
1481 </ul>
1482
1483
1484
1485 <h5><a name="SecStaticDataFiles"></a>Static Data Files</h5>
1486
1487 <p>This section describes OpenPegasus data files that do not change during
1488 normal operation. </p>
1489
1490
1491 <h6>Schema Files</h6>
1492
1493
1494 <p>The following table describes the permissions that should be assigned to the $(PEGASUS_MOF_DIR)
1495 marek 1.1 directory.</p>
1496
1497
1498
1499 <blockquote>
1500
1501 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="634" height="155">
1502 <tbody><tr>
1503 <th rowspan="2" bgcolor="#cae6ca" width="153" height="1">Document
1504 Designation<br>
1505 Configuration Option</th>
1506 <th rowspan="2" bgcolor="#cae6ca" width="83" height="1">Operating System</th>
1507 <th rowspan="2" bgcolor="#cae6ca" width="153" height="1">Location</th>
1508 <th colspan="2" bgcolor="#cae6ca" width="242" height="16">Directory</th>
1509 </tr>
1510 <tr>
1511 <th bgcolor="#cae6ca" width="90" height="1">Owner<br>
1512 Group</th>
1513 <th bgcolor="#cae6ca" width="147" height="1">Permissions</th>
1514 </tr>
1515 <tr>
1516 marek 1.1 <td rowspan="3" align="left" width="153" height="13">$(PEGASUS_MOF_DIR)<br>
1517 </td>
1518 <td align="center" width="83" height="1">Linux</td>
1519 <td align="left" width="153" height="1">/usr/share/Pegasus/mof</td>
1520 <td align="center" width="90" height="1">root/pegasus</td>
1521 <td align="center" width="147" height="1">drwxr-xr-x</td>
1522 </tr>
1523 <tr>
1524 <td align="center" width="83" height="1">HP-UX</td>
1525 <td align="left" width="153" height="1">/opt/wbem/mof</td>
1526 <td align="center" width="90" height="1">bin/bin</td>
1527 <td align="center" width="147" height="1">dr-xr-xr-x</td>
1528 </tr>
1529 <tr>
1530 <td align="center" width="83" height="15">OpenVMS</td>
1531 <td align="left" width="153" height="15">/opt/wbem/mof</td>
1532 <td align="center" width="90" height="15">system</td>
1533 <td align="center" width="147" height="15">S:wred,O:re,G:re,W:e</td>
1534 </tr>
1535 </tbody></table>
1536
1537 marek 1.1 </blockquote>
1538
1539 <p>The following table describes the permissions that should be assigned to the
1540 files in the $(PEGASUS_MOF_DIR) subdirectories.</p>
1541
1542
1543
1544 <dl>
1545 <dd> <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="541" height="89">
1546 <tbody><tr>
1547 <th rowspan="2" bgcolor="#cae6ca" width="104" height="1">Operating System</th>
1548 <th rowspan="2" bgcolor="#cae6ca" width="145" height="1">Packaged or Generated?</th>
1549 <th colspan="2" bgcolor="#cae6ca" width="274" height="16">File</th>
1550 </tr>
1551 <tr>
1552 <th bgcolor="#cae6ca" width="153" height="1">Owner/Group</th>
1553 <th bgcolor="#cae6ca" width="116" height="1">Permissions</th>
1554 </tr>
1555 <tr align="center">
1556 <td width="104" height="14">Linux</td>
1557 <td width="145" height="14">Packaged</td>
1558 marek 1.1 <td width="153" height="3">root/pegasus</td>
1559 <td width="116" height="3">-rw-r--r--</td>
1560 </tr>
1561 <tr>
1562 <td align="center" width="104" height="17">HP-UX</td>
1563 <td align="center" width="145" height="12">Packaged</td>
1564 <td align="center" width="153" height="14">bin/bin</td>
1565 <td align="center" width="116" height="14">-r--r--r--</td>
1566 </tr>
1567 <tr>
1568 <td align="center" width="104" height="17">OpenVMS</td>
1569 <td align="center" width="145" height="12">Packaged</td>
1570 <td align="center" width="153" height="14">system</td>
1571 <td align="center" width="116" height="14">S:wred,O:r,G:r,W:r</td>
1572 </tr>
1573 </tbody></table>
1574
1575 </dd>
1576 </dl>
1577
1578 <p> </p>
1579 marek 1.1
1580 <p>The following OpenPegasus specific mof files
1581 are packaged in the directory $(PEGASUS_MOF_DIR)/Pegasus.
1582 <font color="#ff0000">Note: </font>The class definitions defined in the
1583 pegasus/Schemas/Pegasus/Internal/VER20 mof files are for internal use
1584 only and subject to change. Please consult the OpenPegasus
1585 External Interface Definition document, ExternalInterface.html, in the
1586 pegasus/doc directory in CVS for a list of the mof files included in
1587 the OpenPegasus external definition.</p>
1588
1589
1590 <dl>
1591 <dd><b>Source Location: </b>pegasus/Schemas/Pegasus/Internal/VER20<ul>
1592 PG_Authorization20.mof<br>
1593 PG_ConfigSetting20.mof<br>
1594 PG_InternalSchema20.mof<br>
1595 PG_ShutdownService20.mof<p>PG_SSLCertificate20.mof<br>
1596 PG_SSLCertificateRevocationList20.mof<br>
1597 PG_User20.mof<br>
1598 <br>
1599 </p>
1600 marek 1.1 </ul>
1601
1602 </dd>
1603 <dd><b>Source Location: </b>pegasus/Schemas/Pegasus/InterOp/VER20<ul>
1604 PG_Events20.mof<br>
1605 PG_InterOpSchema20.mof<br>
1606 PG_ProviderModule20.mof<p>
1607 <br>
1608 </p>
1609 </ul>
1610
1611
1612 </dd>
1613 <dd><b>Source Location: </b>pegasus/Schemas/Pegasus/ManagedSystem/VER20<ul>
1614 <p>PG_ComputerSystem20.mof<br>
1615 PG_ComputerSystem20R.mof<br>
1616 PG_ManagedSystemSchema20.mof<br>
1617 PG_ManagedSystemSchema20R.mof<br>
1618 PG_OperatingSystem20.mof<br>
1619 PG_OperatingSystem20R.mof<br>
1620 PG_UnixProcess20.mof<br>
1621 marek 1.1 PG_UnixProcess20R.mof</p>
1622 </ul>
1623 </dd>
1624 </dl>
1625
1626 <br>
1627 <br>
1628
1629 <p>The following table describes the recommended install, upgrade and remove
1630 behavior for the OpenPegasus mof files.</p>
1631 <ul>
1632 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="685">
1633 <tbody><tr>
1634 <th bgcolor="#cae6ca" width="182">install</th>
1635 <th bgcolor="#cae6ca" width="285">upgrade</th>
1636 <th bgcolor="#cae6ca" width="200">remove</th>
1637 </tr>
1638 <tr align="center">
1639 <td align="left" width="182">New $(PEGASUS_MOF_DIR) containing packaged mof files
1640 created.</td>
1641 <td align="left" width="285">Existing $(PEGASUS_MOF_DIR) removed and new $(PEGASUS_MOF_DIR)
1642 marek 1.1 containing packaged mof files created.</td>
1643 <td align="left" width="200">Existing $(PEGASUS_MOF_DIR) removed.</td>
1644 </tr>
1645 </tbody></table>
1646 </ul>
1647
1648 <p>
1649 <br>
1650
1651
1652
1653 </p>
1654
1655
1656
1657 <h5><a name="SecVariableDataFiles"></a>Variable Data Files</h5>
1658
1659 <p>This section describes OpenPegasus data files that change during normal operation.
1660 Files in this section are expected to be rooted in a single directory $(PEGASUS_VARDATA_DIR).</p>
1661
1662 <p>The following table describes the permissions that should be assigned to the
1663 marek 1.1 files in the $(PEGASUS_VARDATA_DIR) directory.</p>
1664
1665 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="980" height="167">
1666 <tbody><tr>
1667 <th rowspan="2" bgcolor="#cae6ca" width="291" height="1">Document
1668 Designation<br>
1669 Configuration Option</th>
1670 <th rowspan="2" bgcolor="#cae6ca" width="75" height="1">Packaged or Generated?</th>
1671 <th rowspan="2" bgcolor="#cae6ca" width="131" height="1">Operating System</th>
1672 <th rowspan="2" bgcolor="#cae6ca" width="178" height="1">Location</th>
1673 <th colspan="2" bgcolor="#cae6ca" width="285" height="16">Directory</th>
1674 </tr>
1675 <tr>
1676 <th bgcolor="#cae6ca" width="132" height="1">Owner<br>
1677 Group</th>
1678 <th bgcolor="#cae6ca" width="150" height="1">Permissions</th>
1679 </tr>
1680 <tr>
1681 <td rowspan="3" align="left" width="291" height="21">$(PEGASUS_CIMSERVER_START_LOCK_FILE)</td>
1682 <td rowspan="3" align="left" width="75" height="21">Generated</td>
1683 <td align="center" width="131" height="6">Linux</td>
1684 marek 1.1 <td align="left" width="178" height="5">/var/run/tog-pegasus/<br>
1685 cimserver_start.lock</td>
1686 <td align="center" width="132" height="6">root/root<p> cimsvr cimsvr
1687 (PS)</p></td>
1688 <td align="center" width="150" height="6">-rw------- </td>
1689 </tr>
1690 <tr>
1691 <td align="center" width="131" height="1">HP-UX</td>
1692 <td align="left" width="178" height="2"><br>
1693 </td>
1694 <td align="center" width="132" height="1"><br>
1695 </td>
1696 <td align="center" width="150" height="1"><br>
1697 </td>
1698 </tr>
1699 <tr>
1700 <td align="center" width="131" height="11">OpenVMS</td>
1701 <td align="left" width="178" height="11"><br>
1702 </td>
1703 <td align="center" width="132" height="11"><br>
1704 </td>
1705 marek 1.1 <td align="center" width="150" height="11"><br>
1706 </td>
1707 </tr>
1708 <tr>
1709 <td rowspan="3" align="left" width="291" height="21">$(PEGASUS_CURRENT<br>
1710 _CONFIG_FILE)</td>
1711 <td rowspan="3" align="left" width="75" height="21">Generated</td>
1712 <td align="center" width="131" height="6">Linux</td>
1713 <td align="left" width="178" height="5">$(PEGASUS_VARDATA_DIR)/<br>
1714 cimserver_current.conf</td>
1715 <td align="center" width="132" height="6">root/root</td>
1716 <td align="center" width="150" height="6">-rw-r--r-- </td>
1717 </tr>
1718 <tr>
1719 <td align="center" width="131" height="1">HP-UX</td>
1720 <td align="left" width="178" height="2">/var/opt/wbem/pegasus/<br>
1721 cimserver_current.conf</td>
1722 <td align="center" width="132" height="1">root/root</td>
1723 <td align="center" width="150" height="1">rw-r--r--</td>
1724 </tr>
1725 <tr>
1726 marek 1.1 <td align="center" width="131" height="11">OpenVMS</td>
1727 <td align="left" width="178" height="11">/var/opt/wbem/pegasus/<br>
1728 cimserver_current.conf</td>
1729 <td align="center" width="132" height="11">system</td>
1730 <td align="center" width="150" height="11">S:wred,O:wr,G:r,W:r</td>
1731 </tr>
1732 <tr>
1733 <td rowspan="3" align="left" width="291" height="21">$(PEGASUS_PLANNED<br>
1734 _CONFIG_FILE)<br>
1735 </td>
1736 <td rowspan="3" align="left" width="75" height="21">Packaged</td>
1737 <td align="center" width="131" height="6">Linux</td>
1738 <td align="left" width="178" height="5">$(PEGASUS_VARDATA_DIR)/<p>
1739 cimserver_planned.conf</p></td>
1740 <td align="center" width="132" height="6">root/root</td>
1741 <td align="center" width="150" height="6">-rw-r--r-- </td>
1742 </tr>
1743 <tr>
1744 <td align="center" width="131" height="1">HP-UX</td>
1745 <td align="left" width="178" height="2">/var/opt/wbem/<p>
1746 cimserver_planned.conf</p>
1747 marek 1.1 </td>
1748 <td align="center" width="132" height="1">root/root</td>
1749 <td align="center" width="150" height="1">rw-r--r--</td>
1750 </tr>
1751 <tr>
1752 <td align="center" width="131" height="11">OpenVMS</td>
1753 <td align="left" width="178" height="11">/var/opt/wbem/<p>
1754 cimserver_planned.conf</p>
1755 </td>
1756 <td align="center" width="132" height="11">system</td>
1757 <td align="center" width="150" height="11">S:wred,O:wr,G:r,W:r</td>
1758 </tr>
1759 <tr>
1760 <td rowspan="3" align="left" width="291" height="19">$(PEGASUS_PID_FILE)</td>
1761 <td rowspan="3" align="left" width="75" height="19">Generated</td>
1762 <td align="center" width="131" height="6">Linux</td>
1763 <td align="left" width="178" height="5">/var/run/tog-pegasus/cimserver.pid</td>
1764 <td align="center" width="132" height="6">root/root<p>cimsvr/cimsvr (PS)</p></td>
1765 <td align="center" width="150" height="6">-rw-------</td>
1766 </tr>
1767 <tr>
1768 marek 1.1 <td align="center" width="131" height="1">HP-UX</td>
1769 <td align="left" width="178" height="2">/etc/opt/wbem/<br>
1770 cimserver_start.conf</td>
1771 <td align="center" width="132" height="1">root/root</td>
1772 <td align="center" width="150" height="1">rw-r--r--</td>
1773 </tr>
1774 <tr>
1775 <td align="center" width="131" height="9">OpenVMS</td>
1776 <td align="left" width="178" height="9">/var/opt/wbem/<br>
1777 cimserver_start.conf</td>
1778 <td align="center" width="132" height="9">system</td>
1779 <td align="center" width="150" height="9">S:wred,O:wr,G:r,W:r</td>
1780 </tr>
1781 <tr>
1782 <td rowspan="3" align="left" width="291" height="21">$(PEGASUS_LOCAL_AUTH_DIR)</td>
1783 <td rowspan="3" align="left" width="75" height="21">Generated</td>
1784 <td align="center" width="131" height="1">Linux</td>
1785 <td align="left" width="178" height="1">/$(PEGASUS_VARDATA_DIR)/cache/localauth</td>
1786 <td align="center" width="132" height="1">root/pegasus</td>
1787 <td align="center" width="150" height="1">drwxr-xr-x</td>
1788 </tr>
1789 marek 1.1 <tr>
1790 <td align="center" width="131" height="1">HP-UX</td>
1791 <td align="left" width="178" height="1">/var/opt/wbem/localauth</td>
1792 <td align="center" width="132" height="1">bin/bin</td>
1793 <td align="center" width="150" height="1">dr-xr-xr-x</td>
1794 </tr>
1795 <tr>
1796 <td align="center" width="131" height="20">OpenVMS</td>
1797 <td align="left" width="178" height="20">/var/opt/wbem/localauth</td>
1798 <td align="center" width="132" height="20">system</td>
1799 <td align="center" width="150" height="20">S:wred,O:re,G:re,W:e</td>
1800 </tr>
1801 <tr>
1802 <td rowspan="3" align="left" width="291" height="30">$(PEGASUS_LOCAL_DOMAIN<br>
1803 _SOCKET_DIR)</td>
1804 <td rowspan="3" align="left" width="75" height="30">Generated</td>
1805 <td align="center" width="131" height="6">Linux</td>
1806 <td align="left" width="178" height="5">/var/run/tog-pegasus/socket</td>
1807 <td align="center" width="132" height="6">root/pegasus<p>cimsvr/cimsvr (PS)</p></td>
1808 <td align="center" width="150" height="6">drwxr-xr-t</td>
1809 </tr>
1810 marek 1.1 <tr>
1811 <td align="center" width="131" height="1">HP-UX</td>
1812 <td align="left" width="178" height="2">/var/opt/wbem/socket/</td>
1813 <td align="center" width="132" height="1">bin/bin</td>
1814 <td align="center" width="150" height="1">dr-xr-xr-t</td>
1815 </tr>
1816 <tr>
1817 <td align="center" width="131" height="20"> </td>
1818 <td align="left" width="178" height="20"> </td>
1819 <td align="center" width="132" height="20"> </td>
1820 <td align="center" width="150" height="20"> </td>
1821 </tr>
1822 <tr>
1823 <td rowspan="3" align="left" width="291" height="21">$(PEGASUS_CIMSERVER<br>
1824 _RANDOMFILE)<br>
1825 <br>
1826 Note: This file is only required on platforms that do not support /dev/(u)random.</td>
1827 <td rowspan="3" align="left" width="75" height="21">Generated</td>
1828 <td align="center" width="131" height="6">Linux</td>
1829 <td align="left" width="178" height="5">N/A</td>
1830 <td align="center" width="132" height="6">N/A</td>
1831 marek 1.1 <td align="center" width="150" height="6">N/A</td>
1832 </tr>
1833 <tr>
1834 <td align="center" width="131" height="1">HP-UX</td>
1835 <td align="left" width="178" height="2"> </td>
1836 <td align="center" width="132" height="1"> </td>
1837 <td align="center" width="150" height="1"> </td>
1838 </tr>
1839 <tr>
1840 <td align="center" width="131" height="11">OpenVMS</td>
1841 <td align="left" width="178" height="11">/var/opt/wbem/ssl.rnd</td>
1842 <td align="center" width="132" height="11">system</td>
1843 <td align="center" width="150" height="11">S:wred,O:r,G:r,W:</td>
1844 </tr>
1845 <tr>
1846 <td rowspan="3" align="left" width="291" height="63">$(PEGASUS_TRACE_DIR)</td>
1847 <td align="left" width="75" height="21">Generated</td>
1848 <td align="center" width="131" height="6">Linux</td>
1849 <td align="left" width="178" height="11">$(PEGASUS_VARDATA_DIR)/cache/trace</td>
1850 <td align="center" width="132" height="6">root/pegasus</td>
1851 <td align="center" width="150" height="6">drwxrwxrwt</td>
1852 marek 1.1 </tr>
1853 <tr>
1854 <td align="left" width="75" height="21"> </td>
1855 <td align="center" width="131" height="1">HP-UX</td>
1856 <td align="left" width="178" height="11">/var/opt/wbem/trace<br>
1857 </td>
1858 <td align="center" width="132" height="6">cimsrvr/cimsrvr<br>
1859 </td>
1860 <td align="center" width="150" height="6">drwxrwxrwt<br>
1861 </td>
1862 </tr>
1863 <tr>
1864 <td align="left" width="75" height="21"> </td>
1865 <td align="center" width="131" height="11">OpenVMS</td>
1866 <td align="left" width="178" height="11"> </td>
1867 <td align="center" width="132" height="11"> </td>
1868 <td align="center" width="150" height="11"><br>
1869 </td>
1870 </tr>
1871 <tr>
1872 <td rowspan="3" align="left" width="291" height="63">$(PEGASUS_CORE_DIR)</td>
1873 marek 1.1 <td align="left" width="75" height="21">Generated</td>
1874 <td align="center" width="131" height="6">Linux</td>
1875 <td align="left" width="178" height="11">$(PEGASUS_VARDATA_DIR)/cache/trace</td>
1876 <td align="center" width="132" height="6">root/pegasus</td>
1877 <td align="center" width="150" height="6">drwxrwxrwt</td>
1878 </tr>
1879 <tr>
1880 <td align="left" width="75" height="21"> </td>
1881 <td align="center" width="131" height="1">HP-UX</td>
1882 <td align="left" width="178" height="11"><br>
1883 </td>
1884 <td align="center" width="132" height="6"><br>
1885 </td>
1886 <td align="center" width="150" height="6"><br>
1887 </td>
1888 </tr>
1889 <tr>
1890 <td align="left" width="75" height="21"> </td>
1891 <td align="center" width="131" height="11">OpenVMS</td>
1892 <td align="left" width="178" height="11"> </td>
1893 <td align="center" width="132" height="11"> </td>
1894 marek 1.1 <td align="center" width="150" height="11"><br>
1895 </td>
1896 </tr>
1897 </tbody></table>
1898
1899 <p> </p>
1900
1901 <h5>$(PEGASUS_PLANNED_CONFIG_FILE)</h5>
1902
1903 <p>The $(PEGASUS_PLANNED_CONFIG_FILE) file is not intended to be user editable. The
1904 cimconfig utility should be used to modify this file. Default settings for
1905 configuration options are defined in the source and can vary by vendor,
1906 Operating System and release. In order to differentiate between "customer-defined"
1907 values and "default-settings", default-settings are not stored in this file.
1908 With the exception of the following comment, initial version of the $(PEGASUS_PLANNED_CONFIG_FILE)
1909 file is empty.
1910 </p><ul>
1911 <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>
1912
1913 </ul>
1914
1915 marek 1.1 <p>The following table describes the upgrade strategy for the
1916 PEGASUS_PLANNED_CONFIG_FILE.</p>
1917
1918 <ul>
1919
1920 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="688" height="119">
1921 <tbody><tr>
1922 <th bgcolor="#cae6ca" width="175">File Name</th>
1923 <th bgcolor="#cae6ca" width="96">Operating System</th>
1924 <th bgcolor="#cae6ca" width="261">Description</th>
1925 <th bgcolor="#cae6ca" width="133">Install Option</th>
1926 </tr>
1927 <tr align="center">
1928 <td rowspan="4" width="175">$(PEGASUS_PLANNED_CONFIG_FILE) </td>
1929 </tr>
1930 <tr align="center">
1931 <td width="96">Linux</td>
1932 <td width="261">
1933 <p align="left"><b>Upgrade: </b>If the file has not been modified on disk, the rpm command will
1934 overwrite the file. If the file has been modified on disk, the rpm
1935 command will copy the new file with an extra file-name extension of .rpmnew.</p><p align="left">
1936 marek 1.1 <b>Erase: </b>If the file has not been modified on disk, the file will
1937 be removed. If the file has been modified, the rpm command will save the
1938 file with an extra file-name extension of .rpmsave.</p></td>
1939 <td width="133">%config(noreplace)</td>
1940 </tr>
1941 <tr align="center">
1942 <td width="96">HP-UX</td>
1943 <td width="261"> </td>
1944 <td width="133"> </td>
1945 </tr>
1946 <tr align="center">
1947 <td width="96">OpenVMS</td>
1948 <td width="261"> </td>
1949 <td width="133"> </td>
1950 </tr>
1951 </tbody></table>
1952 </ul>
1953
1954 <br>The following generated data files and directories are removed on upgrade
1955 and erase: $(PEGASUS_PLANNED_CONFIG_FILE), $(PEGASUS_PID_FILE), $(PEGASUS_LOCAL_AUTH_DIR), $(PEGASUS_LOCAL_DOMAIN_SOCKET_DIR)
1956 and $(PEGASUS_TRACE_DIR).<h5><a name="SecConfigFiles"></a>OpenPegasus Configuration Files</h5>
1957 marek 1.1
1958 <p>This section describes OpenPegasus configuration files. Files in this section
1959 are expected to be rooted in a single directory $(PEGASUS_CONFIG_DIR).</p>
1960
1961
1962 <ul>
1963
1964 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="604" height="119">
1965 <tbody><tr>
1966 <th rowspan="2" bgcolor="#cae6ca" width="206" height="1">File Name</th>
1967 <th rowspan="2" bgcolor="#cae6ca" width="220" height="1">Packaged or
1968 Generated?</th>
1969 <th rowspan="2" bgcolor="#cae6ca" width="205" height="1">Operating System</th>
1970 <th colspan="2" bgcolor="#cae6ca" width="486" height="16">File</th>
1971 </tr>
1972 <tr>
1973 <th bgcolor="#cae6ca" width="290" height="1">Owner/Group</th>
1974 <th bgcolor="#cae6ca" width="196" height="1">Permissions</th>
1975 </tr>
1976 <tr align="center">
1977 <td rowspan="3" width="206" height="52">ssl.cnf</td>
1978 marek 1.1 <td rowspan="3" align="left" width="220" height="52">Generated</td>
1979 <td width="205" height="14">Linux</td>
1980 <td width="290" height="14">root/root</td>
1981 <td width="196" height="14">-r--------</td>
1982 </tr>
1983 <tr>
1984 <td align="center" width="205" height="14">HP-UX</td>
1985 <td align="center" width="290" height="14">bin/bin</td>
1986 <td align="center" width="196" height="14">-r--------</td>
1987 </tr>
1988 <tr align="center">
1989 <td align="center" width="205" height="14">OpenVMS</td>
1990 <td align="center" width="290" height="14">system</td>
1991 <td align="center" width="196" height="14">S:wred,O:r,G:,W:</td>
1992 </tr>
1993 </tbody></table>
1994 </ul>
1995
1996 <br>
1997
1998 <p>The following table describes the recommended install, upgrade and remove
1999 marek 1.1 behavior for the OpenPegasus ssl.cnf file.</p>
2000
2001 <ul>
2002 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="470">
2003 <tbody><tr>
2004 <th bgcolor="#cae6ca" width="99">Install Type</th>
2005 <th bgcolor="#cae6ca" width="358">Actions</th>
2006 </tr>
2007 <tr align="center">
2008 <td width="99">Install</td>
2009 <td align="left" width="358">
2010 <li>The OpenPegasus ssl.cnf file is not created by default. The genOpenPegasusSSLCerts
2011 script can be used to a default ssl.cnf file.</li>
2012 </td>
2013 </tr>
2014 <tr align="center">
2015 <td width="99">Upgrade</td>
2016 <td align="left" width="358">
2017 <li>The ssl.cnf file is not updated.</li>
2018 </td>
2019 </tr>
2020 marek 1.1 <tr align="center">
2021 <td width="99">Remove</td>
2022 <td align="left" width="358">
2023 <li>The ssl.cnf file is not removed.</li>
2024 </td>
2025 </tr>
2026 </tbody></table>
2027
2028 </ul>
2029
2030 <h5><a name="SecPEMFiles"></a>OpenSSL PEM Files</h5>
2031
2032 <p>This section describes the OpenSSL PEM files.
2033 Files in this section are expected to be rooted in a single directory $(PEGASUS_PEM_DIR).</p>
2034
2035
2036 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="711" height="302">
2037 <tbody><tr>
2038 <th rowspan="2" bgcolor="#cae6ca" width="208" height="37">File Name<p>see
2039 PEP 308</p></th>
2040 <th rowspan="2" bgcolor="#cae6ca" width="105" height="37">Packaged or Generated?</th>
2041 marek 1.1 <th rowspan="2" bgcolor="#cae6ca" width="73" height="37">File Name</th>
2042 <th rowspan="2" bgcolor="#cae6ca" width="81" height="37">Operating System</th>
2043 <th colspan="2" bgcolor="#cae6ca" width="215" height="16">File</th>
2044 </tr>
2045 <tr>
2046 <th bgcolor="#cae6ca" width="91" height="16">Owner/Group</th>
2047 <th bgcolor="#cae6ca" width="120" height="16">Permissions</th>
2048 </tr>
2049 <tr align="center">
2050 <td rowspan="3" width="208" height="52">sslKeyFilePath<br>
2051 $(PEGASUS_SSL_KEY_FILE)</td>
2052 <td rowspan="3" align="left" width="105" height="52">
2053 <p align="center">Generated</p></td>
2054 <td width="73" height="14">file.pem</td>
2055 <td width="81" height="14">Linux</td>
2056 <td width="91" height="14">root/root</td>
2057 <td width="120" height="14">-r--------</td>
2058 </tr>
2059 <tr>
2060 <td align="center" width="73" height="14"> </td>
2061 <td align="center" width="81" height="14">HP-UX</td>
2062 marek 1.1 <td align="center" width="91" height="14">bin/bin</td>
2063 <td align="center" width="120" height="14">-r--------</td>
2064 </tr>
2065 <tr align="center">
2066 <td align="center" width="73" height="14"> </td>
2067 <td align="center" width="81" height="14">OpenVMS</td>
2068 <td align="center" width="91" height="14">system</td>
2069 <td align="center" width="120" height="14">S:wred,O:r,G:,W</td>
2070 </tr>
2071 <tr>
2072 <td rowspan="3" align="center" width="208" height="65">sslTrustStore<br>
2073 $(PEGASUS_SSL_TRUSTSTORE)</td>
2074 <td rowspan="3" align="center" width="105" height="65">Empty File</td>
2075 <td align="center" width="73" height="14">client.pem</td>
2076 <td align="center" width="81" height="14">Linux</td>
2077 <td align="center" width="91" height="14">root/root</td>
2078 <td align="center" width="120" height="14">-r--r--r--</td>
2079 </tr>
2080 <tr>
2081 <td align="center" width="73" height="14"> </td>
2082 <td align="center" width="81" height="14">HP-UX</td>
2083 marek 1.1 <td align="center" width="91" height="14">root/sys</td>
2084 <td align="center" width="120" height="14">-r--------</td>
2085 </tr>
2086 <tr>
2087 <td align="center" width="73" height="8"> </td>
2088 <td align="center" width="81" height="8">OpenVMS</td>
2089 <td align="center" width="91" height="8">system</td>
2090 <td align="center" width="120" height="8">S:wred,O:r,G:,W:</td>
2091 </tr>
2092 <tr>
2093 <td rowspan="4" align="center" width="208" height="52">
2094 sslCertificateFilePath<p>$(PEGASUS_SSL_CERT_FILE)</p></td>
2095 <td rowspan="3" align="left" width="105" height="52">
2096 <p align="center">Generated</p></td>
2097 <td align="center" width="73" height="14">server.pem</td>
2098 <td align="center" width="81" height="14">Linux</td>
2099 <td align="center" width="91" height="14">root/root</td>
2100 <td align="center" width="120" height="14">-r--r--r--</td>
2101 </tr>
2102 <tr>
2103 <td align="center" width="73" height="14"> </td>
2104 marek 1.1 <td align="center" width="81" height="14">HP-UX</td>
2105 <td align="center" width="91" height="14">root/sys</td>
2106 <td align="center" width="120" height="14">-r--------</td>
2107 </tr>
2108 <tr>
2109 <td align="center" width="73" height="14"> </td>
2110 <td align="center" width="81" height="14">OpenVMS</td>
2111 <td align="center" width="91" height="14">system</td>
2112 <td align="center" width="120" height="14">S:wred,O:r,G:,W:</td>
2113 </tr>
2114 </tbody></table>
2115
2116 <br>
2117
2118 <p>The following table describes the recommended install, upgrade and remove
2119 behavior for the OpenPegasus *.pem files.</p>
2120
2121 </dd>
2122
2123 </dl>
2124
2125 marek 1.1
2126
2127
2128 <ul>
2129
2130
2131 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="470">
2132 <tbody><tr>
2133 <th bgcolor="#cae6ca" width="99">Install Type</th>
2134 <th bgcolor="#cae6ca" width="358">Actions</th>
2135 </tr>
2136 <tr align="center">
2137 <td width="99">Install</td>
2138 <td align="left" width="358">
2139 <li>The *.pem files are not created by default. The genOpenPegasusSSLCerts
2140 script can be used to create self-signed *.pem files.</li>
2141 </td>
2142 </tr>
2143 <tr align="center">
2144 <td width="99">Upgrade</td>
2145 <td align="left" width="358">
2146 marek 1.1 <li>The *.pem files are not updated.</li>
2147 </td>
2148 </tr>
2149 <tr align="center">
2150 <td width="99">Remove</td>
2151 <td align="left" width="358">
2152 <li>The *.pem files are not removed.</li>
2153 </td>
2154 </tr>
2155 </tbody></table>
2156
2157 </ul>
2158
2159
2160
2161 <h5><a name="SecPAMConfigFiles"></a>PAM Configuration Files</h5>
2162
2163
2164
2165 <p>This section describes OpenPegasus configuration files. </p>
2166
2167 marek 1.1
2168
2169 <ul>
2170
2171
2172
2173 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="714" height="119">
2174 <tbody><tr>
2175 <th rowspan="2" bgcolor="#cae6ca" width="206" height="1">File Name</th>
2176 <th rowspan="2" bgcolor="#cae6ca" width="207" height="1">Packaged or
2177 Generated?</th>
2178 <th rowspan="2" bgcolor="#cae6ca" width="112" height="1">Operating System</th>
2179 <th colspan="2" bgcolor="#cae6ca" width="178" height="16">File</th>
2180 </tr>
2181 <tr>
2182 <th bgcolor="#cae6ca" width="85" height="1">Owner/Group</th>
2183 <th bgcolor="#cae6ca" width="99" height="1">Permissions</th>
2184 </tr>
2185 <tr align="center">
2186 <td rowspan="4" width="206" height="52">$(PAM_CONFIG_DIR)/wbem</td>
2187 </tr>
2188 marek 1.1 <tr align="center">
2189 <td rowspan="3" width="207" height="52">
2190 Packaged</td>
2191 <td width="112" height="14">Linux</td>
2192 <td width="85" height="14">root/pegasus</td>
2193 <td width="99" height="14">-rw-------</td>
2194 </tr>
2195 <tr>
2196 <td align="center" width="112" height="14">HP-UX</td>
2197 <td align="center" width="85" height="14"> </td>
2198 <td align="center" width="99" height="14"> </td>
2199 </tr>
2200 <tr align="center">
2201 <td align="center" width="112" height="14">OpenVMS</td>
2202 <td align="center" width="85" height="14"> </td>
2203 <td align="center" width="99" height="14"> </td>
2204 </tr>
2205 <tr>
2206 <td rowspan="4" align="center" width="206" height="52">$(PEGASUS_CONFIG_DIR)/access.conf</td>
2207 </tr>
2208 <tr align="center">
2209 marek 1.1 <td rowspan="3" width="207" height="52">
2210 Packaged</td>
2211 <td width="112" height="14">Linux</td>
2212 <td width="85" height="14">root/pegasus</td>
2213 <td width="99" height="14">-rw-------</td>
2214 </tr>
2215 <tr>
2216 <td align="center" width="112" height="14">HP-UX</td>
2217 <td align="center" width="85" height="14"> </td>
2218 <td align="center" width="99" height="14"> </td>
2219 </tr>
2220 <tr align="center">
2221 <td align="center" width="112" height="14">OpenVMS</td>
2222 <td align="center" width="85" height="14"> </td>
2223 <td align="center" width="99" height="14"> </td>
2224 </tr>
2225 </tbody></table>
2226 </ul>
2227
2228
2229
2230 marek 1.1 <p>
2231
2232 <br>
2233
2234 </p>
2235
2236
2237
2238 <p>The following table describes the upgrade strategy for the PAM configuration
2239 files.</p>
2240
2241
2242
2243 <ul>
2244
2245
2246
2247 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="688" height="119">
2248 <tbody><tr>
2249 <th bgcolor="#cae6ca" width="175">File Name</th>
2250 <th bgcolor="#cae6ca" width="96">Operating System</th>
2251 marek 1.1 <th bgcolor="#cae6ca" width="264">Description</th>
2252 <th bgcolor="#cae6ca" width="130">Install Option</th>
2253 </tr>
2254 <tr align="center">
2255 <td rowspan="4" width="175">$(PAM_CONFIG_DIR)/wbem</td>
2256 </tr>
2257 <tr align="center">
2258 <td width="96">Linux</td>
2259 <td width="264">
2260 <p align="left"><b>Upgrade: </b>If the file has not been modified on disk, the rpm command will
2261 overwrite the file. If the file has been modified on disk, the rpm
2262 command will copy the new file with an extra file-name extension of .rpmnew.</p><p align="left">
2263 <b>Erase: </b>If the file has not been modified on disk, the file will
2264 be removed. If the file has been modified, the rpm command will save the
2265 file with an extra file-name extension of .rpmsave.</p></td>
2266 <td width="130">%config(noreplace)</td>
2267 </tr>
2268 <tr align="center">
2269 <td width="96">HP-UX</td>
2270 <td width="264"> </td>
2271 <td width="130"> </td>
2272 marek 1.1 </tr>
2273 <tr align="center">
2274 <td width="96">OpenVMS</td>
2275 <td width="264"> </td>
2276 <td width="130"> </td>
2277 </tr>
2278 <tr>
2279 <td rowspan="4" width="175">$(PEGASUS_CONFIG_DIR)/<br>
2280 access.conf</td>
2281 </tr>
2282 <tr align="center">
2283 <td width="96">Linux</td>
2284 <td width="264">
2285 <p align="left"><b>Upgrade: </b>If the file has not been modified on disk, the rpm command will
2286 overwrite the file. If the file has been modified on disk, the rpm
2287 command will copy the new file with an extra file-name extension of .rpmnew.</p><p align="left">
2288 <b>Erase: </b>If the file has not been modified on disk, the file will
2289 be removed. If the file has been modified, the rpm command will save the
2290 file with an extra file-name extension of .rpmsave.</p></td>
2291 <td width="130">%config(noreplace)</td>
2292 </tr>
2293 marek 1.1 <tr align="center">
2294 <td width="96">HP-UX</td>
2295 <td width="264"> </td>
2296 <td width="130"> </td>
2297 </tr>
2298 <tr align="center">
2299 <td width="96">OpenVMS</td>
2300 <td width="264"> </td>
2301 <td width="130"> </td>
2302 </tr>
2303 </tbody></table>
2304 </ul>
2305
2306
2307
2308 <h5><a name="SecRepositoryDataFiles"></a>Repository Data Files</h5>
2309
2310
2311
2312 <p>This section describes the installation of the Repository Data Files.
2313 Files in this section are expected to be rooted in a single
2314 marek 1.1 directory $(PEGASUS_REPOSITORY_DIR).</p>
2315
2316
2317
2318 <p>The following table describes the recommended install, upgrade and remove
2319 behavior for the OpenPegasus Repository data files.</p>
2320
2321
2322
2323 <ul>
2324
2325
2326 <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="712">
2327 <tbody><tr>
2328 <th bgcolor="#cae6ca" width="99">Install Type</th>
2329 <th bgcolor="#cae6ca" width="600">Actions</th>
2330 </tr>
2331 <tr align="center">
2332 <td width="99">Install</td>
2333 <td align="left" width="600">
2334 <li>The packaged Repository data files are installed in $(PEGASUS_REPOSITORY_DIR).</li>
2335 marek 1.1 </td>
2336 </tr>
2337 <tr align="center">
2338 <td width="99">Upgrade</td>
2339 <td align="left" width="600">
2340 <li>If $(PEGASUS_REPOSITORY_DIR) exists ... </li>
2341 <ul>
2342 <li>$(PEGASUS_PREV_REPOSITORY_DIR) is saved as an archive file.</li>
2343 <li>$(PEGASUS_REPOSITORY_DIR) renamed to $(PEGASUS_PREV_REPOSITORY_DIR).</li>
2344 </ul>
2345 <li>The packaged Repository data files are installed in $(PEGASUS_REPOSITORY_DIR).</li>
2346 <li>If $(PEGASUS_PREV_REPOSITORY_DIR) exists, the repupgrade utility
2347 is used to merge changes from $(PEGASUS_PREV_REPOSITORY_DIR) to $(PEGASUS_REPOSITORY_DIR).
2348 Once the upgrade is complete, $(PEGASUS_PREV_REPOSITORY_DIR) is saved
2349 as an archive file.</li>
2350 </td>
2351 </tr>
2352 <tr align="center">
2353 <td width="99">Remove</td>
2354 <td align="left" width="600">
2355 <li>If it exists, $(PEGASUS_PREV_REPOSITORY_DIR) is saved as an
2356 marek 1.1 archive file.</li>
2357 <li>If it exists, $(PEGASUS_REPOSITORY_DIR) is saved as an archive.</li>
2358 </td>
2359 </tr>
2360 </tbody></table>
2361
2362 </ul>
2363
2364
2365
2366 <h3><font color="#800080"><a name="SecBuild"></a></font>OpenPegasus Build
2367 & Installs Steps</h3>
2368
2369
2370
2371
2372 <p>For supported Operating Systems, pegasus/Makefile.Release can be used to perform the steps
2373 necessary to build and place the necessary OpenPegasus release files in a
2374 staging directory, PEGASUS_STAGING_DIR. </p>
2375
2376
2377 marek 1.1
2378 <ul>
2379
2380
2381 <p>$(MAKE) -f pegasus/Makefile.Release rebuild</p>
2382 </ul>
2383
2384
2385
2386 <p>For successful operation, Makefile.Release is dependent on the existence of
2387 an operating system dependent file that defines the setting of key
2388 environment variables. Two sample files have been placed in the pegasus
2389 directory: env_var_HPUX.status and env_var_Linux.status.</p>
2390
2391
2392
2393 <p>Use of this utility has been tested on the following platforms.</p>
2394
2395
2396
2397 <ul>
2398 marek 1.1
2399
2400 <li>Linux</li>
2401 <li>HP-UX</li>
2402 </ul>
2403
2404
2405
2406 <h2><font color="#000000">References</font></h2>
2407
2408
2409 <p>Note: Starting with the OpenPegasus 2.9.0 release, the OpenPegasus Build and
2410 Configuration Options document is available in OpenPegasus CVS Repository,
2411 pegasus/doc/BuildAndReleaseOptions.html.</p>
2412
2413
2414 <ol>
2415
2416
2417 <li>
2418 <a href="http://www.openpegasus.org/pp/uploads/40/6160/PEP174_RecommendedReleaseOptions.htm">
2419 marek 1.1 PEP#174 - Recommended OpenPegasus 2.4 Build and Configuration Options</a>
2420 </li>
2421 <li> <a href="http://www.openpegasus.org/pp/uploads/40/8502/PEP200_RecommendedReleaseOptions.htm">
2422 PEP#200 - Recommended OpenPegasus 2.5 Build and Configuration Options</a>
2423 </li>
2424 <li>
2425 <a href="http://www.openpegasus.org/pp/uploads/40/10083/PEP237_RecommendedReleaseOptions.htm">
2426 PEP#237 - Recommended OpenPegasus 2.5.1 Build and Configuration Options</a></li>
2427 <li>
2428 <a href="http://www.openpegasus.org/pp/protected/upreviews/20/2096/PEP277_RecommendedReleaseOptions.htm">
2429 PEP#277 - Recommended OpenPegasus 2.6.0 Build and Configuration Options for
2430 Selected Platforms</a></li>
2431 <li>
2432 <a href="http://www.openpegasus.org/pp/uploads/40/14873/PEP292_RecommendedReleaseOptions.htm">
2433 PEP#292 - Recommended OpenPegasus 2.7.0 Build and Configuration Options for
2434 Selected Platforms</a></li>
2435 <li>
2436 <a href="http://www.openpegasus.org/pp/uploads/40/16781/PEP308_RecommendedReleaseOptions.htm">
2437 PEP#308 - Recommended OpenPegasus 2.8.0 Build and Configuration Options for
2438 Selected Platforms</a></li>
2439
2440 marek 1.1 </ol>
2441
2442
2443
2444
2445
2446
2447 <h2><font color="#000000">Rationale</font></h2>
2448
2449
2450
2451 <h2><font color="#000000">Schedule</font></h2>
2452
2453
2454
2455 <h2><font color="#000000">Discussion</font></h2>
2456
2457
2458
2459 <hr>
2460
2461 marek 1.1 <p>Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;<br>
2462 EMC Corporation; Symantec Corporation; The Open Group.<br>
2463 <br>
2464 Permission is hereby granted, free of charge, to any person obtaining a copy<br>
2465 of this software and associated documentation files (the "Software"), to<br>
2466 deal in the Software without restriction, including without limitation the<br>
2467 rights to use, copy, modify, merge, publish, distribute, sublicense, and/or<br>
2468 sell copies of the Software, and to permit persons to whom the Software is<br>
2469 furnished to do so, subject to the following conditions:<br>
2470 <br>
2471 THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN<br>
2472 ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED<br>
2473 "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT<br>
2474 LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR<br>
2475 PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT<br>
2476 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN<br>
2477 ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION<br>
2478 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p>
2479
2480
2481 <hr>
2482 marek 1.1 <p>Template last modified: <b>March 26th 2006</b> by <b>Martin Kirk<br>
2483 </b>Template version: <b>1.11</b></p>
2484
2485
2486
|