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

No CVS admin address has been configured