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