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