pegasus/doc/RuntimePackaging.html - annotate

Return to RuntimePackaging.html CVS log

Up to [Pegasus] / pegasus / doc

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

No CVS admin address has been configured