(file) Return to BuildAndReleaseOptions.html CVS log (file) (dir) Up to [Pegasus] / pegasus / doc

Diff for /pegasus/doc/BuildAndReleaseOptions.html between version 1.24.2.1 and 1.24.2.2

version 1.24.2.1, 2011/10/11 18:17:55 version 1.24.2.2, 2012/02/15 17:47:00
Line 1 
Line 1 
 <html>  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <head>  <html><head>
   <link rel="stylesheet" href=  
     "http://www.opengroup.org/stylesheets/info1.css">  
 </head>  
  
 <body>    <link rel="stylesheet" href="http://www.opengroup.org/stylesheets/info1.css"></head><body>
 <hr> <hr>
  
 <p align="center"> <p align="center">
Line 18 
Line 15 
   testing and running OpenPegasus on a selected set of   testing and running OpenPegasus on a selected set of
   platforms. In this version of the document, platform-specific configuration   platforms. In this version of the document, platform-specific configuration
   information have been documented for the platforms described in the   information have been documented for the platforms described in the
   &quot;Documented Platforms&quot; section of this document.    "Documented Platforms" section of this document.
 </p> </p>
  
 <p><b>Note 1: </b> <p><b>Note 1: </b>
   The recommendations defined in this document are not intended to document   The recommendations defined in this document are not intended to document
   the feature set included in any vendor's OpenPegasus-based product.   the feature set included in any vendor's OpenPegasus-based product.
   Rather, the purpose of this document is to provide input to vendors when   Rather, the purpose of this document is to provide input to vendors when
   making product decisions.<BR>    making product decisions.<br>
 </p> </p>
  
 <hr> <hr>
Line 47 
Line 44 
 additional information.</p> additional information.</p>
  
 <ul> <ul>
   <table border="1" cellspacing="1" bordercolordark="#666666"    <table bordercolordark="#666666" bordercolorlight="#CCCCCC" border="1" cellspacing="1" width="20%">
     bordercolorlight="#CCCCCC" width=20%>      <tbody><tr>
     <tr>        <th align="center" bgcolor="#cae6ca">Platform</th>
       <th bgcolor="#CAE6CA" align=center>Platform</th>        <th align="center" bgcolor="#cae6ca">Status</th>
       <th bgcolor="#CAE6CA" align=center>Status</th>  
     </tr>     </tr>
     <tr align="left">     <tr align="left">
       <td>HPUX_IA64_ACC</td>       <td>HPUX_IA64_ACC</td>
Line 97 
Line 93 
       <td>VMS_IA64_DECCXX</td>       <td>VMS_IA64_DECCXX</td>
       <td>&nbsp;</td>       <td>&nbsp;</td>
     </tr>     </tr>
     </table>      </tbody></table>
 </ul> </ul>
  
 <h2>Proposed Solution</h2> <h2>Proposed Solution</h2>
Line 113 
Line 109 
     that expects the providers to perform authorization. Note that     that expects the providers to perform authorization. Note that
     this authorization burden is considerably lighter if the provider     this authorization burden is considerably lighter if the provider
     is registered as 'run as requestor' and if the CIM Server enables     is registered as 'run as requestor' and if the CIM Server enables
     that feature. See <a href=      that feature. See <a href="http://www.openpegasus.org/pp/uploads/40/7197/SecurityGuidePEP.htm">
     "http://www.openpegasus.org/pp/uploads/40/7197/SecurityGuidePEP.htm">  
     PEP#223 - Security Coding Guidelines</a> for additional     PEP#223 - Security Coding Guidelines</a> for additional
     details.     details.
   </li>   </li>
Line 127 
Line 122 
 <h3>Terminology Notes</h3> <h3>Terminology Notes</h3>
 <ol> <ol>
   <li>   <li>
     In this document, the term &quot;Not Set&quot; is used to indicate      In this document, the term "Not Set" is used to indicate
     that the a value for the environment variable has not been defined.     that the a value for the environment variable has not been defined.
     &quot;Set&quot; is used to indicate that the value must be defined,      "Set" is used to indicate that the value must be defined,
     but the actual value of the variable is not checked.     but the actual value of the variable is not checked.
   </li>   </li>
 </ol> </ol>
Line 139 
Line 134 
 <ol> <ol>
   <li>   <li>
     Not all functionality described in this document has achieved     Not all functionality described in this document has achieved
     &quot;Green&quot;status, please refer to the      "Green"status, please refer to the
     <a href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&ggid=799">      <a href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&amp;ggid=799">
     OpenPegasus Project Feature Status </a>page for information on     OpenPegasus Project Feature Status </a>page for information on
     the maturity level of OpenPegasus features.     the maturity level of OpenPegasus features.
   </li>   </li>
Line 267 
Line 262 
      environments to understand the security implications of allowing      environments to understand the security implications of allowing
      providers to be loaded from a dynamically changing set of      providers to be loaded from a dynamically changing set of
      directories.<br>      directories.<br>
 </ul>  </p></ul>
  
 <h5>PEGASUS_CCOVER</h5> <h5>PEGASUS_CCOVER</h5>
 <ul> <ul>
Line 281 
Line 276 
   <b>Recommended Value (Release Build):&nbsp;</b>Not Set<br>   <b>Recommended Value (Release Build):&nbsp;</b>Not Set<br>
   <b>Required:&nbsp;</b>No<br>   <b>Required:&nbsp;</b>No<br>
   <b>Considerations: </b>This flag is only supported on HP-UX to enable   <b>Considerations: </b>This flag is only supported on HP-UX to enable
      CCOVER for the NB&T system.<br>       CCOVER for the NB&amp;T system.<br>
 </ul> </ul>
  
 <h5>PEGASUS_CIM_SCHEMA</h5> <h5>PEGASUS_CIM_SCHEMA</h5>
 <ul> <ul>
   
   <b>Description:&nbsp;</b>This variable is used internally by the   <b>Description:&nbsp;</b>This variable is used internally by the
      OpenPegasus development team when upgrading the OpenPegasus build  OpenPegasus development team when testing OpenPegasus in the integrated
      environment to a new version of the CIM Schema.<br>  build/test environment. It defines the version of the CIM Schema (which
   <b>Default Value:&nbsp;</b>CIM217<br>  must exist in the $(PEGASUS_ROOT)/Schemas directory) that will be used
   to build the class repository for testing the pegasus environment
   ("make repository", etc.).<br>
     <b>Default Value:&nbsp;</b>CIM231 (Note that this may change as newer versions of the CIM Schema are used as the default.<br>
   <b>Recommended Value (Development Build):&nbsp;</b>   <b>Recommended Value (Development Build):&nbsp;</b>
      No Specific Recommendation<br>      No Specific Recommendation<br>
   <b>Recommended Value (Release Build):&nbsp;</b>   <b>Recommended Value (Release Build):&nbsp;</b>
      No Specific Recommendation<br>      No Specific Recommendation<br>
   <b>Required:&nbsp;</b>No <br>   <b>Required:&nbsp;</b>No <br>
   <b>Considerations:</b> Additional code changes may be required when    <b>Considerations:</b>
      upgrading or downgrading the CIM Schema version.</p>  Additional code changes may be required when upgrading or downgrading
   the CIM Schema version from the default.&nbsp; The default CIM Schema
   is defined in the file $(PEGASUS_ROOT)/mak/config.mak.<br>
     <br>
   <p></p>
 </ul> </ul>
  
   
 <h5>PEGASUS_CLASS_CACHE_SIZE</h5> <h5>PEGASUS_CLASS_CACHE_SIZE</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>This environment variable gives the size of   <b>Description:&nbsp;</b>This environment variable gives the size of
Line 309 
Line 313 
   <b>Default Value:&nbsp;</b>8<br>   <b>Default Value:&nbsp;</b>8<br>
   <b>Recommended Value (Development Build):&nbsp;</b>8<br>   <b>Recommended Value (Development Build):&nbsp;</b>8<br>
   <b>Recommended Value (Release Build):&nbsp;</b>8<br>   <b>Recommended Value (Release Build):&nbsp;</b>8<br>
   <b>Required:&nbsp;</b>No </p>    <b>Required:&nbsp;</b>No <p></p>
 </ul> </ul>
  
 <h5>PEGASUS_DEBUG</h5> <h5>PEGASUS_DEBUG</h5>
Line 365 
Line 369 
      Linux)<br>      Linux)<br>
   <b>Required:&nbsp;</b>No<br>   <b>Required:&nbsp;</b>No<br>
   <b>Considerations: </b>This environment variable can be used to   <b>Considerations: </b>This environment variable can be used to
      change the &quot;hard-coded&quot; default setting for the       change the "hard-coded" default setting for the
      forceProviderProcesses configuration value.&nbsp;      forceProviderProcesses configuration value.&nbsp;
      Refer to the definition of <b>forceProviderProcesses</b> for      Refer to the definition of <b>forceProviderProcesses</b> for
      additional information.      additional information.
Line 441 
Line 445 
      receive and process requests from local CIM Clients. (2)      receive and process requests from local CIM Clients. (2)
      Enabling this option may result in lose of functionality when      Enabling this option may result in lose of functionality when
      sslClientVerificationMode = required. (3)The      sslClientVerificationMode = required. (3)The
      &quot;LOCAL_DOMAIN_SOCKET&quot; functionality has not been       "LOCAL_DOMAIN_SOCKET" functionality has not been
      implemented for&nbsp; Windows or OpenVMS.&nbsp; Therefore, by      implemented for&nbsp; Windows or OpenVMS.&nbsp; Therefore, by
      default, this option is &quot;Set&quot; for Windows and OpenVMS       default, this option is "Set" for Windows and OpenVMS
      platforms.      platforms.
 </ul> </ul>
  
Line 598 
Line 602 
      Platform Only)<br>      Platform Only)<br>
   <b>Recommended Value (Release Build):&nbsp;</b>true (Linux Platform   <b>Recommended Value (Release Build):&nbsp;</b>true (Linux Platform
      Only)<br>      Only)<br>
   <b>Required:&nbsp;</b>No</p>    <b>Required:&nbsp;</b>No<p></p>
 </ul> </ul>
  
 <h5>PEGASUS_ENABLE_COMPRESSED_REPOSITORY</h5> <h5>PEGASUS_ENABLE_COMPRESSED_REPOSITORY</h5>
Line 699 
Line 703 
   <b>Required:&nbsp;</b>No<br><b>Considerations:&nbsp;</b>   <b>Required:&nbsp;</b>No<br><b>Considerations:&nbsp;</b>
      This flag is currently only supported with GCC on Linux.      This flag is currently only supported with GCC on Linux.
      <ul>      <ul>
        Note: LCOV, <a href=         Note: LCOV, <a href="http://ltp.sourceforge.net/coverage/lcov.php">
        "http://ltp.sourceforge.net/coverage/lcov.php">  
        http://ltp.sourceforge.net/coverage/lcov.php</a>, is a        http://ltp.sourceforge.net/coverage/lcov.php</a>, is a
        graphical front-end extension for GCOV. It collects GCOV data        graphical front-end extension for GCOV. It collects GCOV data
        for multiple source files and creates HTML pages with coverage        for multiple source files and creates HTML pages with coverage
Line 726 
Line 729 
                  output (e.g., <i>genhtml result.info</i>).&nbsp; The                  output (e.g., <i>genhtml result.info</i>).&nbsp; The
                  top .html file is named index.html.</li>                  top .html file is named index.html.</li>
            </ul>            </ul>
        </ol>         </li></ol>
     </ul>     </ul>
 </ul> </ul>
  
Line 809 
Line 812 
   <b>Default Value:&nbsp;</b>false<br>   <b>Default Value:&nbsp;</b>false<br>
   <b>Recommended Value (Development Build):&nbsp;</b>false<br>   <b>Recommended Value (Development Build):&nbsp;</b>false<br>
   <b>Recommended Value (Release Build):&nbsp;</b>false<br>   <b>Recommended Value (Release Build):&nbsp;</b>false<br>
   <b>Required:&nbsp;</b>No</p>    <b>Required:&nbsp;</b>No<p></p>
 </ul> </ul>
  
 <h5>PEGASUS_ENABLE_OBJECT_NORMALIZATION</h5> <h5>PEGASUS_ENABLE_OBJECT_NORMALIZATION</h5>
Line 873 
Line 876 
   <b>Default Value:&nbsp;</b>Not Set<br>   <b>Default Value:&nbsp;</b>Not Set<br>
   <b>Recommended Value (Development Build):&nbsp;</b>Not Set<br>   <b>Recommended Value (Development Build):&nbsp;</b>Not Set<br>
   <b>Recommended Value (Release Build):&nbsp;</b>Not Set<br>   <b>Recommended Value (Release Build):&nbsp;</b>Not Set<br>
   <b>Required:&nbsp;</b>No</p>    <b>Required:&nbsp;</b>No<p></p>
 </ul> </ul>
  
 <h5>PEGASUS_ENABLE_SLP</h5> <h5>PEGASUS_ENABLE_SLP</h5>
Line 885 
Line 888 
      this variable is set to 'false' or not set, the SLP functionality      this variable is set to 'false' or not set, the SLP functionality
      will not be included.&nbsp; All other values are considered      will not be included.&nbsp; All other values are considered
      invalid and will result in a build error      invalid and will result in a build error
      (e.g., &quot;PEGASUS_ENABLE_SLP ($(PEGASUS_ENABLE_SLP)) invalid,       (e.g., "PEGASUS_ENABLE_SLP ($(PEGASUS_ENABLE_SLP)) invalid,
      must be true or false&quot;).<br>       must be true or false").<br>
   <b>Default Value: </b>'true' for Windows; 'false' for all other   <b>Default Value: </b>'true' for Windows; 'false' for all other
      Platforms<br>      Platforms<br>
   <b>Recommended Value (Development Build):&nbsp;</b>'true' for   <b>Recommended Value (Development Build):&nbsp;</b>'true' for
Line 1081 
Line 1084 
   <b>Recommended Value (Release Build):&nbsp;</b>   <b>Recommended Value (Release Build):&nbsp;</b>
      No Specific Recommendation<br>      No Specific Recommendation<br>
   <b>Required:&nbsp;</b>Yes<br>   <b>Required:&nbsp;</b>Yes<br>
   <b>Considerations:&nbsp;</b>The error &quot;PEGASUS_HOME    <b>Considerations:&nbsp;</b>The error "PEGASUS_HOME
      environment variable undefined&quot; is returned if the       environment variable undefined" is returned if the
      PEGASUS_HOME environment variable is not set.      PEGASUS_HOME environment variable is not set.
      This variable is also used during runtime. Refer to the section      This variable is also used during runtime. Refer to the section
      titled &quot;Environment Variable Settings for Running OpenPegasus       titled "Environment Variable Settings for Running OpenPegasus
      2.3.2 on Linux&quot; for additional details.<br>       2.3.2 on Linux" for additional details.<br>
 </ul> </ul>
  
 <h5>PEGASUS_INDICATIONS_Q_THRESHOLD</h5> <h5>PEGASUS_INDICATIONS_Q_THRESHOLD</h5>
Line 1242 
Line 1245 
      following table describes the platforms documented in      following table describes the platforms documented in
      this version of the document. <br>      this version of the document. <br>
   <b>Default Value:&nbsp;</b>None<p>&nbsp;</p>   <b>Default Value:&nbsp;</b>None<p>&nbsp;</p>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="542">
        bordercolorlight="#CCCCCC" width=542         <tbody><tr>
        style='font-size=10.0pt;font-family:Arial'>          <th bgcolor="#cae6ca" width="190">Platform</th>
        <tr>          <th bgcolor="#cae6ca" width="351">Recommended Value <br>
         <th bgcolor="#CAE6CA" width="190">Platform</th>  
         <th bgcolor="#CAE6CA" width=351>Recommended Value <br>  
           Development Build</th>           Development Build</th>
         <th bgcolor="#CAE6CA" width=338>Recommended Value <br>          <th bgcolor="#cae6ca" width="338">Recommended Value <br>
           Release Build</th>           Release Build</th>
        </tr>        </tr>
        <tr align="center">        <tr align="center">
         <td width="190" align="left">Linux IA32</td>          <td align="left" width="190">Linux IA32</td>
         <td width="351">LINUX_IX86_GNU</td>         <td width="351">LINUX_IX86_GNU</td>
         <td width="338">LINUX_IX86_GNU</td>         <td width="338">LINUX_IX86_GNU</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
        <td width="190" align="left">Linux IA64</td>         <td align="left" width="190">Linux IA64</td>
        <td width="351">LINUX_IA64_GNU</td>        <td width="351">LINUX_IA64_GNU</td>
        <td width="338">LINUX_IA64_GNU</td>        <td width="338">LINUX_IA64_GNU</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
        <td width="190" align="left">Linux X86_64</td>         <td align="left" width="190">Linux X86_64</td>
        <td width="351">LINUX_X86_64_GNU</td>        <td width="351">LINUX_X86_64_GNU</td>
        <td width="338">LINUX_X86_64_GNU</td>        <td width="338">LINUX_X86_64_GNU</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
        <td width="190" align="left">HP-UX PA-RISC</td>         <td align="left" width="190">HP-UX PA-RISC</td>
        <td width="351">HPUX_PARISC_ACC</td>        <td width="351">HPUX_PARISC_ACC</td>
        <td width="338">HPUX_PARISC_ACC</td>        <td width="338">HPUX_PARISC_ACC</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
        <td width="190" align="left">HP-UX IPF</td>         <td align="left" width="190">HP-UX IPF</td>
        <td width="351">HPUX_IA64_ACC</td>        <td width="351">HPUX_IA64_ACC</td>
        <td width="338">HPUX_IA64_ACC</td>        <td width="338">HPUX_IA64_ACC</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
        <td width="190" align="left">OpenVMS Alpha</td>         <td align="left" width="190">OpenVMS Alpha</td>
        <td width="351">VMS_ALPHA_DECCXX</td>        <td width="351">VMS_ALPHA_DECCXX</td>
        <td width="338">VMS_ALPHA_DECCXX</td>        <td width="338">VMS_ALPHA_DECCXX</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
        <td width="190" align="left">OpenVMS IA64</td>         <td align="left" width="190">OpenVMS IA64</td>
        <td width="351">VMS_IA64_DECCXX</td>        <td width="351">VMS_IA64_DECCXX</td>
        <td width="338"> VMS_IA64_DECCXX</td>        <td width="338"> VMS_IA64_DECCXX</td>
       </tr>       </tr>
      </table>       </tbody></table>
      <br><br>      <br><br>
   <b>Required:&nbsp;</b>Yes<br>   <b>Required:&nbsp;</b>Yes<br>
   <b>Considerations:&nbsp;</b>The error "PEGASUS_PLATFORM   <b>Considerations:&nbsp;</b>The error "PEGASUS_PLATFORM
Line 1383 
Line 1384 
      do any validity checking on the specified value, either      do any validity checking on the specified value, either
      to determine if it is a valid positive integer or if it      to determine if it is a valid positive integer or if it
      exceeds some maximum value.<br>      exceeds some maximum value.<br>
 </ul>  </p></ul>
  
 <h5>PEGASUS_SNIA_EXTENSIONS</h5> <h5>PEGASUS_SNIA_EXTENSIONS</h5>
 <ul> <ul>
Line 1462 
Line 1463 
 <ul> <ul>
   <b>Description:&nbsp;</b>This variable is only used for   <b>Description:&nbsp;</b>This variable is only used for
      testing.&nbsp; If set to true, the IPv6-specific tests will      testing.&nbsp; If set to true, the IPv6-specific tests will
      be run as part of the &quot;alltests&quot; OpenPegasus       be run as part of the "alltests" OpenPegasus
      TestMakefile test suite. If this variable is not set or set to      TestMakefile test suite. If this variable is not set or set to
      false,&nbsp; the IPv6-specific tests will not be run.&nbsp; All      false,&nbsp; the IPv6-specific tests will not be run.&nbsp; All
      other values are invalid.<br>      other values are invalid.<br>
Line 1498 
Line 1499 
      PEGASUS_TEST_USER_ID and PEGASUS_TEST_USER_PASS variables      PEGASUS_TEST_USER_ID and PEGASUS_TEST_USER_PASS variables
      defines a valid user/password pair and can be used for      defines a valid user/password pair and can be used for
      certificate-based authentication testing.&nbsp; These tests      certificate-based authentication testing.&nbsp; These tests
      also assumes that &quot;invalidUser&quot; is not a valid       also assumes that "invalidUser" is not a valid
      user.<br>      user.<br>
   <b>Default Value:&nbsp;</b>Not Set<br>   <b>Default Value:&nbsp;</b>Not Set<br>
   <b>Recommended Value (Development Build):&nbsp;</b>Set<br>   <b>Recommended Value (Development Build):&nbsp;</b>Set<br>
Line 1584 
Line 1585 
   <b>Considerations:&nbsp;</b>Either the PEGASUS_USE_NET_SNMP or   <b>Considerations:&nbsp;</b>Either the PEGASUS_USE_NET_SNMP or
      PEGASUS_USE_EMANATE variable must be set for the SNMP      PEGASUS_USE_EMANATE variable must be set for the SNMP
      Handler to be supported.<br>      Handler to be supported.<br>
 </ul>  </p></ul>
  
  
 <h5>PEGASUS_USE_NET_SNMP</h5> <h5>PEGASUS_USE_NET_SNMP</h5>
Line 1609 
Line 1610 
   <b>Considerations:&nbsp;</b>Either the PEGASUS_USE_NET_SNMP or   <b>Considerations:&nbsp;</b>Either the PEGASUS_USE_NET_SNMP or
      PEGASUS_USE_EMANATE variable must be set for the SNMP      PEGASUS_USE_EMANATE variable must be set for the SNMP
      Handler to be supported.<br>      Handler to be supported.<br>
 </ul>  </p></ul>
  
 <h5>PEGASUS_ENABLE_NET_SNMPV3</h5> <h5>PEGASUS_ENABLE_NET_SNMPV3</h5>
 <ul> <ul>
Line 1623 
Line 1624 
   <b>Required:&nbsp;</b>No<p>   <b>Required:&nbsp;</b>No<p>
   <b>Considerations:&nbsp;</b>PEGASUS_USE_NET_SNMP variable must   <b>Considerations:&nbsp;</b>PEGASUS_USE_NET_SNMP variable must
      be set.<br>      be set.<br>
 </ul>  </p></ul>
  
  
 <h5>PEGASUS_USE_OPENSLP</h5> <h5>PEGASUS_USE_OPENSLP</h5>
Line 1667 
Line 1668 
 <ul> <ul>
   <b>Description:&nbsp;</b>If set, OpenPegasus is built using   <b>Description:&nbsp;</b>If set, OpenPegasus is built using
      the "Release Build" configuration options. By default,      the "Release Build" configuration options. By default,
      OpenPegasus is built using the &quot;Development Build"       OpenPegasus is built using the "Development Build"
      configuration options.<br>      configuration options.<br>
   <b>Default Value:&nbsp;</b>false<br>   <b>Default Value:&nbsp;</b>false<br>
   <b>Recommended Value (Development Build):&nbsp;</b>false<br>   <b>Recommended Value (Development Build):&nbsp;</b>false<br>
Line 1677 
Line 1678 
      PEGASUS_USE_RELEASE_CONFIG_OPTIONS variable allows a platform      PEGASUS_USE_RELEASE_CONFIG_OPTIONS variable allows a platform
      vendor to easily toggle between two sets of configurations      vendor to easily toggle between two sets of configurations
      options, a set of options tuned for the development/debug      options, a set of options tuned for the development/debug
      (&quot;Development Build") environment and a set of options       ("Development Build") environment and a set of options
      tuned for the production environment ("Release Build").      tuned for the production environment ("Release Build").
      Refer the section titled "Configuration Properties" for      Refer the section titled "Configuration Properties" for
      additional detail.&nbsp; (2) For each configuration      additional detail.&nbsp; (2) For each configuration
      variable,&nbsp; the &quot;Recommended Value (Release Build)&quot;       variable,&nbsp; the "Recommended Value (Release Build)"
      value defines the recommended settings to use for a      value defines the recommended settings to use for a
      &quot;Release Build&quot;.&nbsp; Please refer to the       "Release Build".&nbsp; Please refer to the
      description of each variable for additional information.      description of each variable for additional information.
 </ul> </ul>
  
Line 1691 
Line 1692 
 <ul> <ul>
   <b>Description:&nbsp;</b>If set, OpenPegasus is built using   <b>Description:&nbsp;</b>If set, OpenPegasus is built using
      the "Release Build" directory definitions. By default,      the "Release Build" directory definitions. By default,
      OpenPegasus is built using the &quot;Development Build"       OpenPegasus is built using the "Development Build"
      directory definitions.<br>      directory definitions.<br>
   <b>Default Value:&nbsp;</b>Not Set<br>   <b>Default Value:&nbsp;</b>Not Set<br>
   <b>Recommended Value (Development Build):&nbsp;</b>Not Set<br>   <b>Recommended Value (Development Build):&nbsp;</b>Not Set<br>
Line 1701 
Line 1702 
      The PEGASUS_USE_RELEASE_DIRS variable allows a platform      The PEGASUS_USE_RELEASE_DIRS variable allows a platform
      vendor to easily toggle between two sets of directory      vendor to easily toggle between two sets of directory
      definitions, a set tuned for the development/debug      definitions, a set tuned for the development/debug
      (&quot;Development Build") environment and a set tuned for the       ("Development Build") environment and a set tuned for the
      production environment ("Release Build").  Refer the section      production environment ("Release Build").  Refer the section
      titled "Configuration Properties" for additional detail.<br>      titled "Configuration Properties" for additional detail.<br>
 </ul> </ul>
Line 1816 
Line 1817 
   <b>Default Value:&nbsp;</b>262144<br>   <b>Default Value:&nbsp;</b>262144<br>
   <b>Recommended Value (Development Build):&nbsp;</b>262144<br>   <b>Recommended Value (Development Build):&nbsp;</b>262144<br>
   <b>Recommended Value (Release Build):&nbsp;</b>262144<br>   <b>Recommended Value (Release Build):&nbsp;</b>262144<br>
   <b>Required:&nbsp;</b>No </p>    <b>Required:&nbsp;</b>No <p></p>
 </ul> </ul>
  
 <h4>Examples Building a Linux IA32 (#IA64) Development/Debug Version</h4> <h4>Examples Building a Linux IA32 (#IA64) Development/Debug Version</h4>
Line 1885 
Line 1886 
      However, CIM Client applications must rely on an alternative      However, CIM Client applications must rely on an alternative
      mechanism to locate this directory.<br>      mechanism to locate this directory.<br>
   <b>Default Value:&nbsp;</b>if $PEGASUS_HOME is set then   <b>Default Value:&nbsp;</b>if $PEGASUS_HOME is set then
      &quot;$PEGASUS_HOME/msg&quot; else &quot;.&quot;<br>       "$PEGASUS_HOME/msg" else "."<br>
   <b>Recommended Value (Development Build): </b>$PEGASUS_HOME/msg<br>   <b>Recommended Value (Development Build): </b>$PEGASUS_HOME/msg<br>
   <b>Recommended Value (Release Build):&nbsp;</b>Not Set <br>   <b>Recommended Value (Release Build):&nbsp;</b>Not Set <br>
   <b>Required:&nbsp;</b>No<br>   <b>Required:&nbsp;</b>No<br>
Line 1910 
Line 1911 
     The PEGASUS_USE_RELEASE_CONFIG_OPTIONS variable allows a     The PEGASUS_USE_RELEASE_CONFIG_OPTIONS variable allows a
     platform vendor to easily toggle between two sets of     platform vendor to easily toggle between two sets of
     configurations options, a set of options tuned for the     configurations options, a set of options tuned for the
     development/debug (&quot;Development Build") environment      development/debug ("Development Build") environment
     and a set of options tuned for the production environment     and a set of options tuned for the production environment
     ("Release Build"). The value of     ("Release Build"). The value of
     <i>Recommended Value (Development Build)</i>     <i>Recommended Value (Development Build)</i>
Line 1947 
Line 1948 
     for the following variables are platform     for the following variables are platform
     and vendor dependent and not documented in this document.</p>     and vendor dependent and not documented in this document.</p>
  
     <table border="1" cellspacing="1" bordercolordark="#666666"      <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" height="228" width="148">
         bordercolorlight="#CCCCCC" width=148        <tbody><tr>
         style='font-size=10.0pt;font-family:Arial' height="228">          <th bgcolor="#cae6ca" height="16" width="1">&nbsp;</th>
       <tr>  
         <th bgcolor="#CAE6CA" width=1 height="16">&nbsp;</th>  
       </tr>       </tr>
         <tr align="center">         <tr align="center">
         <td align="left" width="1" height="12">$LOGDIR</td>          <td align="left" height="12" width="1">$LOGDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">$PROVIDERDIRS</td>          <td align="left" height="14" width="1">$PROVIDERDIRS</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">          <td align="left" height="14" width="1">
           $PROVIDERMANAGERDIRS</td>           $PROVIDERMANAGERDIRS</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">$REPOSITORYDIR </td>          <td align="left" height="14" width="1">$REPOSITORYDIR </td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">$CERTIFICATEDIR&nbsp;          <td align="left" height="14" width="1">$CERTIFICATEDIR&nbsp;
         </td>         </td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">$LOCALAUTHDIR</td>          <td align="left" height="14" width="1">$LOCALAUTHDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">$TRACEDIR</td>          <td align="left" height="14" width="1">$TRACEDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">$CONFIGDIR</td>          <td align="left" height="14" width="1">$CONFIGDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">$PIDFILE</td>          <td align="left" height="14" width="1">$PIDFILE</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">$RANDOMDIR</td>          <td align="left" height="14" width="1">$RANDOMDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">$SOCKETDIR</td>          <td align="left" height="14" width="1">$SOCKETDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" width="1" height="14">$MESSAGEDIR</td>          <td align="left" height="14" width="1">$MESSAGEDIR</td>
       </tr>       </tr>
       </table>        </tbody></table>
 </ul> </ul>
  
 <h4>Definitions</h4> <h4>Definitions</h4>
Line 2032 
Line 2031 
      No/Yes<br>      No/Yes<br>
   <b>Dynamic?:&nbsp;</b>No<p>&nbsp;<br>   <b>Dynamic?:&nbsp;</b>No<p>&nbsp;<br>
      <br>      <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
        bordercolorlight="#CCCCCC" width=531       <tbody><tr>
        style='font-size=10.0pt;font-family:Arial'>         <th bgcolor="#cae6ca" width="168">Platform</th>
      <tr>         <th bgcolor="#cae6ca" width="350">Source Configuration File</th>
        <th bgcolor="#CAE6CA" width="168">Platform</th>  
        <th bgcolor="#CAE6CA" width=350>Source Configuration File</th>  
      </tr>      </tr>
      <tr align="center">      <tr align="center">
        <td width="168">Linux</td>        <td width="168">Linux</td>
Line 2054 
Line 2051 
        <td align="left" width="350">        <td align="left" width="350">
          Pegasus/Config/DefaultPropertyTableVms.h</td>          Pegasus/Config/DefaultPropertyTableVms.h</td>
      </tr>      </tr>
      </table>       </tbody></table>
 </ul>  </p></ul>
  
 <h5>enableAssociationTraversal</h5> <h5>enableAssociationTraversal</h5>
 <ul> <ul>
Line 2073 
Line 2070 
      Provider Registration issue that restricts the degree to      Provider Registration issue that restricts the degree to
      which separate Providers can register for Associations.<br>      which separate Providers can register for Associations.<br>
      <br>      <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
        bordercolorlight="#CCCCCC" width=531       <tbody><tr>
        style='font-size=10.0pt;font-family:Arial'>         <th bgcolor="#cae6ca" width="168">Platform</th>
      <tr>         <th bgcolor="#cae6ca" width="350">Source Configuration File</th>
        <th bgcolor="#CAE6CA" width="168">Platform</th>  
        <th bgcolor="#CAE6CA" width=350>Source Configuration File</th>  
      </tr>      </tr>
      <tr align="center">      <tr align="center">
        <td width="168">Linux</td>        <td width="168">Linux</td>
Line 2095 
Line 2090 
        <td align="left" width="350">        <td align="left" width="350">
          Pegasus/Config/DefaultPropertyTableVms.h</td>          Pegasus/Config/DefaultPropertyTableVms.h</td>
      </tr>      </tr>
      </table>       </tbody></table>
 </ul> </ul>
  
 <h5>enableAuditLog</h5> <h5>enableAuditLog</h5>
Line 2137 
Line 2132 
   <b>Considerations:&nbsp;</b>Repositories containing a mixture   <b>Considerations:&nbsp;</b>Repositories containing a mixture
      of binary and XML objects are supported.<br>      of binary and XML objects are supported.<br>
   <b>Source Configuration File:&nbsp;</b>   <b>Source Configuration File:&nbsp;</b>
      Pegasus/Config/RepositoryPropertyOwner.cpp</p>       Pegasus/Config/RepositoryPropertyOwner.cpp<p></p>
 </ul> </ul>
  
  
Line 2162 
Line 2157 
      user names and passwords will be included in the text of the      user names and passwords will be included in the text of the
      HTTP message.<br>      HTTP message.<br>
      <br>      <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
          style='font-size=10.0pt;font-family:Arial'>           <th bgcolor="#cae6ca" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" width="350">Source Configuration File</th>
          <th bgcolor="#CAE6CA" width="168">Platform</th>  
          <th bgcolor="#CAE6CA" width=350>Source Configuration File</th>  
        </tr>        </tr>
        <tr align="center">        <tr align="center">
          <td width="168">Linux</td>          <td width="168">Linux</td>
Line 2184 
Line 2177 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul> </ul>
  
 <h5>enableHttpsConnection</h5> <h5>enableHttpsConnection</h5>
Line 2202 
Line 2195 
      the environment variable PEGASUS_HAS_SSL must have      the environment variable PEGASUS_HAS_SSL must have
      been set when CIM Server was built.<br>      been set when CIM Server was built.<br>
      <br>      <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
          style='font-size=10.0pt;font-family:Arial'>           <th bgcolor="#cae6ca" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" width="350">Source Configuration File</th>
          <th bgcolor="#CAE6CA" width="168">Platform</th>  
          <th bgcolor="#CAE6CA" width=350>Source Configuration File</th>  
        </tr>        </tr>
        <tr align="center">        <tr align="center">
          <td width="168">Linux</td>          <td width="168">Linux</td>
Line 2224 
Line 2215 
          <td align="left" width="350">          <td align="left" width="350">
           Pegasus/Config/DefaultPropertyTableVms.h</td>           Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul> </ul>
  
 <h5>enableIndicationService</h5> <h5>enableIndicationService</h5>
Line 2262 
Line 2253 
      if exception or timeout happens. There is no automatic recovery from      if exception or timeout happens. There is no automatic recovery from
      degraded state is available at present.<br>      degraded state is available at present.<br>
   <br>   <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
          style='font-size=10.0pt;font-family:Arial'>           <th bgcolor="#cae6ca" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" width="350">Source Configuration File</th>
          <th bgcolor="#CAE6CA" width="168">Platform</th>  
          <th bgcolor="#CAE6CA" width=350>Source Configuration File</th>  
        </tr>        </tr>
        <tr align="center">        <tr align="center">
          <td width="168">Linux</td>          <td width="168">Linux</td>
Line 2284 
Line 2273 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul> </ul>
  
 <h5>enableNamespaceAuthorization</h5> <h5>enableNamespaceAuthorization</h5>
Line 2325 
Line 2314 
           exception have an opportunity to handle the error.           exception have an opportunity to handle the error.
           Otherwise, the exception is passed to the Provider Manager           Otherwise, the exception is passed to the Provider Manager
           and becomes the response for that Provider.           and becomes the response for that Provider.
       <li>Provider Modules that are listed on the        </li><li>Provider Modules that are listed on the
           excludeModulesFromNormalization           excludeModulesFromNormalization
           configuration option are excluded from normalization.           configuration option are excluded from normalization.
       <li>Since the concept of normalization is relatively new to        </li><li>Since the concept of normalization is relatively new to
           OpenPegasus and it establishes and enforces rules for           OpenPegasus and it establishes and enforces rules for
           objects returned by providers, it should only           objects returned by providers, it should only
           apply to providers written against the SDK in which it was           apply to providers written against the SDK in which it was
Line 2337 
Line 2326 
           combination will be subject to normalization:           combination will be subject to normalization:
         <ul>         <ul>
             <li>'C++Default' / 2.5.0 or greater             <li>'C++Default' / 2.5.0 or greater
             <li>'CMPI' / 2.0.0 or greater              </li><li>'CMPI' / 2.0.0 or greater
             <li>'JMPI' / 1.0.0 or greater              </li><li>'JMPI' / 1.0.0 or greater
         </ul>          </li></ul>
      </ul>       </li></ul>
   <b>Source Configuration File:&nbsp;</b>   <b>Source Configuration File:&nbsp;</b>
      Pegasus/Config/NormalizationPropertyOwner.cpp<br>      Pegasus/Config/NormalizationPropertyOwner.cpp<br>
 </ul> </ul>
Line 2392 
Line 2381 
      comma-separated Provider Module names (as specified in      comma-separated Provider Module names (as specified in
      PG_ProviderModule.Name) to exclude from validation and      PG_ProviderModule.Name) to exclude from validation and
      normalization.<br>      normalization.<br>
   <b>Default Value:&nbsp;</b>&quot;&quot;<br>    <b>Default Value:&nbsp;</b>""<br>
   <b>Recommended Default Value (Development Build):</b>   <b>Recommended Default Value (Development Build):</b>
      &quot;&quot;<br>       ""<br>
   <b>Recommended Default Value (Release Build):&nbsp;</b>   <b>Recommended Default Value (Release Build):&nbsp;</b>
      &quot;&quot;<br>       ""<br>
   <b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br>   <b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br>
   <b>Recommend To Be Fixed/Hidden (Release Build):&nbsp;</b>No/No<br>   <b>Recommend To Be Fixed/Hidden (Release Build):&nbsp;</b>No/No<br>
   <b>Dynamic?:&nbsp;</b>No<br>   <b>Dynamic?:&nbsp;</b>No<br>
Line 2447 
Line 2436 
        message informing administrators of what happened and what        message informing administrators of what happened and what
        corrective actions can be taken.<br>        corrective actions can be taken.<br>
        <br>        <br>
        <table border="1" cellspacing="1" bordercolordark="#666666"         <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
            bordercolorlight="#CCCCCC" width=531           <tbody><tr>
            style='font-size=10.0pt;font-family:Arial'>             <th bgcolor="#cae6ca" width="168">Platform</th>
          <tr>             <th bgcolor="#cae6ca" width="350">
            <th bgcolor="#CAE6CA" width="168">Platform</th>  
            <th bgcolor="#CAE6CA" width=350>  
              Source Configuration File</th>              Source Configuration File</th>
          </tr>          </tr>
          <tr align="center">          <tr align="center">
Line 2470 
Line 2457 
            <td align="left" width="350">            <td align="left" width="350">
              Pegasus/Config/DefaultPropertyTableVms.h</td>              Pegasus/Config/DefaultPropertyTableVms.h</td>
          </tr>          </tr>
          </table>           </tbody></table>
 </ul> </ul>
  
 <h5>home</h5> <h5>home</h5>
Line 2484 
Line 2471 
   <b>Recommend To Be Fixed/Hidden (Release Build):&nbsp;</b>Yes<br>   <b>Recommend To Be Fixed/Hidden (Release Build):&nbsp;</b>Yes<br>
   <b>Dynamic?:&nbsp;</b>No<p>&nbsp;<br>   <b>Dynamic?:&nbsp;</b>No<p>&nbsp;<br>
      <br>      <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
          style='font-size=10.0pt;font-family:Arial'>           <th bgcolor="#cae6ca" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" width="350">Source Configuration File</th>
          <th bgcolor="#CAE6CA" width="168">Platform</th>  
          <th bgcolor="#CAE6CA" width=350>Source Configuration File</th>  
        </tr>        </tr>
        <tr align="center">        <tr align="center">
          <td width="168">Linux</td>          <td width="168">Linux</td>
Line 2506 
Line 2491 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul>  </p></ul>
  
 <h5>httpPort</h5> <h5>httpPort</h5>
 <ul> <ul>
Line 2527 
Line 2512 
      IANA</a>. In a production environment, the recommendation is      IANA</a>. In a production environment, the recommendation is
      to use /etc/services to configure the value of this port. (2)      to use /etc/services to configure the value of this port. (2)
      With the release of OpenPegasus 2.5, the default values for      With the release of OpenPegasus 2.5, the default values for
      httpPort was changed from 5988 to &quot;&quot;. This       httpPort was changed from 5988 to "". This
      change was made to allow the OpenPegasus to differentiate      change was made to allow the OpenPegasus to differentiate
      between a default setting of 5988 and a customer-defined      between a default setting of 5988 and a customer-defined
      setting of 5988.&nbsp; With this change,&nbsp; if the port      setting of 5988.&nbsp; With this change,&nbsp; if the port
Line 2536 
Line 2521 
      is specified, the server will continue to use the value in      is specified, the server will continue to use the value in
      /etc/services.<br>      /etc/services.<br>
      <br>      <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
          style='font-size=10.0pt;font-family:Arial'>           <th bgcolor="#cae6ca" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" width="350">Source Configuration File</th>
          <th bgcolor="#CAE6CA" width="168">Platform</th>  
          <th bgcolor="#CAE6CA" width=350>Source Configuration File</th>  
        </tr>        </tr>
        <tr align="center">        <tr align="center">
          <td width="168">Linux</td>          <td width="168">Linux</td>
Line 2558 
Line 2541 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul> </ul>
  
 <h5>httpsPort</h5> <h5>httpsPort</h5>
Line 2580 
Line 2563 
      In a production environment, the recommendation is to use      In a production environment, the recommendation is to use
      /etc/services to configure the value of this port.(2)      /etc/services to configure the value of this port.(2)
      With the release of OpenPegasus 2.5, the default values for      With the release of OpenPegasus 2.5, the default values for
      httpPort was changed from 5989 to &quot;&quot;. This       httpPort was changed from 5989 to "". This
      change was made to allow the OpenPegasus to differentiate      change was made to allow the OpenPegasus to differentiate
      between a default setting of 5989 and a customer-defined      between a default setting of 5989 and a customer-defined
      setting of 5989.&nbsp; With this change,&nbsp; if the port number      setting of 5989.&nbsp; With this change,&nbsp; if the port number
Line 2589 
Line 2572 
      the server will continue to use the value in /etc/services.<br>      the server will continue to use the value in /etc/services.<br>
      <br>      <br>
  
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
          style='font-size=10.0pt;font-family:Arial'>           <th bgcolor="#cae6ca" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" width="350">Source Configuration File</th>
          <th bgcolor="#CAE6CA" width="168">Platform</th>  
          <th bgcolor="#CAE6CA" width=350>Source Configuration File</th>  
        </tr>        </tr>
        <tr align="center">        <tr align="center">
          <td width="168">Linux</td>          <td width="168">Linux</td>
Line 2611 
Line 2592 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul> </ul>
  
 <h5>idleConnectionTimeout</h5> <h5>idleConnectionTimeout</h5>
Line 2771 
Line 2752 
      four. In this case though new provider processes will not be created      four. In this case though new provider processes will not be created
      but existing five will continue running<br>      but existing five will continue running<br>
      <br>      <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
          style='font-size=10.0pt;font-family:Arial'>           <th bgcolor="#cae6ca" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" width="350">
          <th bgcolor="#CAE6CA" width="168">Platform</th>  
          <th bgcolor="#CAE6CA" width=350>  
            Source Configuration File</th>            Source Configuration File</th>
        </tr>        </tr>
        <tr align="center">        <tr align="center">
Line 2794 
Line 2773 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul> </ul>
  
 <h5>messageDir</h5> <h5>messageDir</h5>
Line 2827 
Line 2806 
   <b>Considerations:&nbsp;</b>The CIM Server runs as a privileged   <b>Considerations:&nbsp;</b>The CIM Server runs as a privileged
      user. And, since Providers run in the same process space as the      user. And, since Providers run in the same process space as the
      CIM Server, Providers also have privileged access to the      CIM Server, Providers also have privileged access to the
      system. Allowing a registered Provider’s executable to be       system. Allowing a registered Provider&#8217;s executable to be
      replaced with malicious code would result in a critical      replaced with malicious code would result in a critical
      security defect, giving a malicious user privileged access      security defect, giving a malicious user privileged access
      to the system. Adminstrators are responsible for ensuring      to the system. Adminstrators are responsible for ensuring
Line 2873 
Line 2852 
   <b>Considerations:&nbsp;</b><br>   <b>Considerations:&nbsp;</b><br>
   <b>Source Configuration File:&nbsp;</b>   <b>Source Configuration File:&nbsp;</b>
      Pegasus/Config/FileSystemPropertyOwner.cpp<p><br>      Pegasus/Config/FileSystemPropertyOwner.cpp<p><br>
 </ul>  </p></ul>
  
 <h5>repositoryIsDefaultInstanceProvider</h5> <h5>repositoryIsDefaultInstanceProvider</h5>
 <ul> <ul>
Line 2900 
Line 2879 
        <li><b>Authorization.</b> &nbsp;The repository has no        <li><b>Authorization.</b> &nbsp;The repository has no
            concept of which users (or components) are authorized to            concept of which users (or components) are authorized to
            perform which operations.</li>            perform which operations.</li>
        <li><b>Appearance of instrumentation.</b>  A client application         <li><b>Appearance of instrumentation.</b> &nbsp;A client application
            cannot determine whether instrumentation exists for a            cannot determine whether instrumentation exists for a
            given CIM class. For example,&nbsp; imagine a client            given CIM class. For example,&nbsp; imagine a client
            issues a CreateInstance operation on a Disk class            issues a CreateInstance operation on a Disk class
            for&nbsp;&nbsp;&nbsp; which no provider is registered.            for&nbsp;&nbsp;&nbsp; which no provider is registered.
            &nbsp;The instance will be stored in the repository, and            &nbsp;The instance will be stored in the repository, and
            the client gets a "success" response. Does that mean a             the client gets a "success" response. Does that mean&nbsp;a
            disk device has been created on the server? Even worse,            disk device has been created on the server? Even worse,
            when another client issues an EnumerateInstances            when another client issues an EnumerateInstances
            operation,&nbsp;the spurious Disk instance is returned.            operation,&nbsp;the spurious Disk instance is returned.
            &nbsp;With repositoryIsDefaultInstanceProvider=false, the            &nbsp;With repositoryIsDefaultInstanceProvider=false, the
            CreateInstance operation above would have returned a            CreateInstance operation above would have returned a
            NOT_SUPPORTED error.</li>            NOT_SUPPORTED error.</li>
        <li><b>Potential for inconsistent data.</b>  Using the         <li><b>Potential for inconsistent data.</b> &nbsp;Using the
            repository as a data cache increases the probability            repository as a data cache increases the probability
            that a client will see stale or incorrect data.  A            that a client will see stale or incorrect data.  A
            provider can better control the correlation            provider can better control the correlation
Line 2976 
Line 2955 
   <b>Recommend To Be Fixed/Hidden (Release Build):&nbsp;</b>Yes<br>   <b>Recommend To Be Fixed/Hidden (Release Build):&nbsp;</b>Yes<br>
   <b>Dynamic?:&nbsp;</b>No<p>&nbsp;<br>   <b>Dynamic?:&nbsp;</b>No<p>&nbsp;<br>
   <br>   <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" height="80" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
          style='font-size=10.0pt;font-family:Arial' height="80">           <th bgcolor="#cae6ca" height="16" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" height="16" width="350">
          <th bgcolor="#CAE6CA" width="168" height="16">Platform</th>  
          <th bgcolor="#CAE6CA" width=350 height="16">  
            Source Configuration File</th>            Source Configuration File</th>
        </tr>        </tr>
        <tr align="center">        <tr align="center">
         <td width="168" height="14">Linux</td>          <td height="14" width="168">Linux</td>
          <td align="left" width="350" height="14">           <td align="left" height="14" width="350">
            Pegasus/Config/DefaultPropertyTableLinux.h</td>            Pegasus/Config/DefaultPropertyTableLinux.h</td>
        </tr>        </tr>
        <tr align="center">        <tr align="center">
          <td width="168" height="14">HP-UX</td>           <td height="14" width="168">HP-UX</td>
          <td align="left" width="350" height="14">           <td align="left" height="14" width="350">
            Pegasus/Config/DefaultPropertyTableHpux.h</td>            Pegasus/Config/DefaultPropertyTableHpux.h</td>
        </tr>        </tr>
        <tr align="center">        <tr align="center">
          <td width="168" height="16">OpenVMS</td>           <td height="16" width="168">OpenVMS</td>
          <td align="left" width="350" height="16">           <td align="left" height="16" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul>  </p></ul>
  
 <h5>socketWriteTimeout</h5> <h5>socketWriteTimeout</h5>
 <ul> <ul>
Line 3064 
Line 3041 
 <ul> <ul>
   <b>Description:&nbsp;</b>Describes the desired level of support   <b>Description:&nbsp;</b>Describes the desired level of support
      for certificate-based authentication.      for certificate-based authentication.
     <ul style="MARGIN-TOP: 0in" type="circle">      <ul style="margin-top: 0in;" type="circle">
       <li>“<b>required</b>” – The server requires certificate-based        <li>&#8220;<b>required</b>&#8221; &#8211; The server requires certificate-based
           client authentication.&nbsp; A client MUST present a           client authentication.&nbsp; A client MUST present a
           trusted certificate in order to access the CIM Server.&nbsp;           trusted certificate in order to access the CIM Server.&nbsp;
           If the client fails to send a certificate or sends an           If the client fails to send a certificate or sends an
           untrusted certificate, the connection will be rejected.</li>           untrusted certificate, the connection will be rejected.</li>
       <li>“<b>optional</b>” – The server supports, but does not        <li>&#8220;<b>optional</b>&#8221; &#8211; The server supports, but does not
           require, certificate-based client authentication. The           require, certificate-based client authentication. The
           server will request and attempt to validate a client           server will request and attempt to validate a client
           certificate, however the connection will be accepted even           certificate, however the connection will be accepted even
           if no certificate is sent or an untrusted certificate is           if no certificate is sent or an untrusted certificate is
           sent.&nbsp; The server will then seek to authenticate the           sent.&nbsp; The server will then seek to authenticate the
           client via an authentication header.</li>           client via an authentication header.</li>
       <li>“<b>disabled</b>” – The server does not support        <li>&#8220;<b>disabled</b>&#8221; &#8211; The server does not support
           certificate-based client authentication.</li>           certificate-based client authentication.</li>
     </ul>     </ul>
   <b>Recommended Default Value (Development Build):&nbsp;</b>   <b>Recommended Default Value (Development Build):&nbsp;</b>
Line 3088 
Line 3065 
   <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/No<br>   <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/No<br>
   <b>Dynamic?:&nbsp;</b>No<br>   <b>Dynamic?:&nbsp;</b>No<br>
   <b>Considerations:&nbsp;</b>(1) This property is only used if   <b>Considerations:&nbsp;</b>(1) This property is only used if
      <b>enableHttpsConnection</b> is  <b>&quot;true&quot;</b>.       <b>enableHttpsConnection</b> is  <b>"true"</b>.
      (2) If the platform does not support PEGASUS_LOCAL_DOMAIN_SOCKET,      (2) If the platform does not support PEGASUS_LOCAL_DOMAIN_SOCKET,
      OpenPegasus attempts to use either HTTPS or      OpenPegasus attempts to use either HTTPS or
      HTTP to establish a local connection (connectLocal).&nbsp;      HTTP to establish a local connection (connectLocal).&nbsp;
      For platforms that do not support PEGASUS_LOCAL_DOMAIN_SOCKET,      For platforms that do not support PEGASUS_LOCAL_DOMAIN_SOCKET,
      Clients which use connectLocal, such as cimconfig -l -c,      Clients which use connectLocal, such as cimconfig -l -c,
      cimprovider -l -s and cimserver -s, will not work if&nbsp; the      cimprovider -l -s and cimserver -s, will not work if&nbsp; the
      &quot;sslClientVerificationMode&quot; variable is set to       "sslClientVerificationMode" variable is set to
      &quot;required&quot; and HTTP is disabled.&nbsp; For these       "required" and HTTP is disabled.&nbsp; For these
      platforms, the recommended course of action is to change the      platforms, the recommended course of action is to change the
      property value to &quot;optional.&quot;<br>       property value to "optional."<br>
   <b>Source Configuration File:&nbsp;</b>   <b>Source Configuration File:&nbsp;</b>
      Pegasus/Config/SecurityPropertyOwner.cpp      Pegasus/Config/SecurityPropertyOwner.cpp
 </ul> </ul>
Line 3175 
Line 3152 
 <h5>traceFacility</h5> <h5>traceFacility</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>Defines the desired facility for trace   <b>Description:&nbsp;</b>Defines the desired facility for trace
      messages. Valid values include: &quot;File&quot;       messages. Valid values include: "File"
      , &quot;Log&quot; and &quot;Memory&quot; .<br>       , "Log" and "Memory" .<br>
   <b>Default Value:&nbsp;</b>File<br>   <b>Default Value:&nbsp;</b>File<br>
   <b>Recommended Default Value (Development Build): </b>File<br>   <b>Recommended Default Value (Development Build): </b>File<br>
   <b>Recommended Default Value (Release Build): </b>File<br>   <b>Recommended Default Value (Release Build): </b>File<br>
Line 3184 
Line 3161 
   <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/Yes<br>   <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/Yes<br>
   <b>Dynamic?:&nbsp;</b>Yes<br>   <b>Dynamic?:&nbsp;</b>Yes<br>
   <b>Case Sensitive?:&nbsp;</b>No<br>   <b>Case Sensitive?:&nbsp;</b>No<br>
   <b>Considerations:&nbsp;</b>If you specify &quot;File&quot;,    <b>Considerations:&nbsp;</b>If you specify "File",
      trace messagesare written into the file specified by the      trace messagesare written into the file specified by the
      configuration option traceFilePath. If you specify      configuration option traceFilePath. If you specify
      &quot;Log&quot;, trace messages are written to the       "Log", trace messages are written to the
      OpenPegasus Log. If you specify Memory, the trace messages      OpenPegasus Log. If you specify Memory, the trace messages
      are collected in a wrap-around memory buffer.      are collected in a wrap-around memory buffer.
      If this memory is part of a dump the trace messages can be      If this memory is part of a dump the trace messages can be
      found by the eye-catcher &quot;PEGASUSMEMTRACE&quot; at       found by the eye-catcher "PEGASUSMEMTRACE" at
      the top of the memory buffer. The trace is in clear text and      the top of the memory buffer. The trace is in clear text and
      the last written message has the suffix &quot;EOTRACE&quot;.<br>       the last written message has the suffix "EOTRACE".<br>
   <b>Source Configuration File:&nbsp;</b>   <b>Source Configuration File:&nbsp;</b>
      Pegasus/Config/TracePropertyOwner.cpp<br>      Pegasus/Config/TracePropertyOwner.cpp<br>
 </ul> </ul>
Line 3216 
Line 3193 
  
 <h5>traceLevel</h5> <h5>traceLevel</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b></b>Defines the desired level of    <b>Description:&nbsp;</b>Defines the desired level of
      tracing. Valid values include: 0, 1, 2, 3, 4, 5.<br>      tracing. Valid values include: 0, 1, 2, 3, 4, 5.<br>
   <b>Default Value:&nbsp;</b>0<br>   <b>Default Value:&nbsp;</b>0<br>
   <b>Recommended Default Value (Development Build): </b>0<br>   <b>Recommended Default Value (Development Build): </b>0<br>
   <b>Recommended Default Value (Release Build): </b>0<<br>    <b>Recommended Default Value (Release Build): </b>0&lt;<br>
   <b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br>   <b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br>
   <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/Yes<br>   <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/Yes<br>
   <b>Dynamic?:&nbsp;</b>Yes<br>   <b>Dynamic?:&nbsp;</b>Yes<br>
Line 3260 
Line 3237 
      $CONFIGDIR/cimserver_current.conf<br>      $CONFIGDIR/cimserver_current.conf<br>
   <b>Dynamic?:&nbsp;</b>No&nbsp;<br>   <b>Dynamic?:&nbsp;</b>No&nbsp;<br>
   <br>   <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
          style='font-size=10.0pt;font-family:Arial'>           <th bgcolor="#cae6ca" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" width="350">
          <th bgcolor="#CAE6CA" width="168">Platform</th>  
          <th bgcolor="#CAE6CA" width=350>  
            Source Configuration File</th>            Source Configuration File</th>
        </tr>        </tr>
        <tr align="center">        <tr align="center">
Line 3282 
Line 3257 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/ConfigFileDirVms.h</td>            Pegasus/Config/ConfigFileDirVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul> </ul>
  
 <h5>static char PLANNED_CONFIG_FILE [] = </h5> <h5>static char PLANNED_CONFIG_FILE [] = </h5>
Line 3295 
Line 3270 
      $CONFIGDIR/cimserver_planned.conf<br>      $CONFIGDIR/cimserver_planned.conf<br>
   <b>Dynamic?:&nbsp;</b>No<br>   <b>Dynamic?:&nbsp;</b>No<br>
      <br>      <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
         style='font-size=10.0pt;font-family:Arial'>           <th bgcolor="#cae6ca" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" width="350">
          <th bgcolor="#CAE6CA" width="168">Platform</th>  
          <th bgcolor="#CAE6CA" width=350>  
            Source Configuration File</th>            Source Configuration File</th>
        </tr>        </tr>
        <tr align="center">        <tr align="center">
Line 3318 
Line 3291 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/ConfigFileDirVms.h</td>            Pegasus/Config/ConfigFileDirVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul> </ul>
  
 <h5>static char CIMSERVER_START_FILE [] = </h5> <h5>static char CIMSERVER_START_FILE [] = </h5>
Line 3332 
Line 3305 
      $PIDFILE<br>      $PIDFILE<br>
   <b>Dynamic?:&nbsp;</b>No<br>   <b>Dynamic?:&nbsp;</b>No<br>
      <br>      <br>
      <table border="1" cellspacing="1" bordercolordark="#666666"       <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">
          bordercolorlight="#CCCCCC" width=531         <tbody><tr>
          style='font-size=10.0pt;font-family:Arial'>           <th bgcolor="#cae6ca" width="168">Platform</th>
        <tr>           <th bgcolor="#cae6ca" width="350">
          <th bgcolor="#CAE6CA" width="168">Platform</th>  
          <th bgcolor="#CAE6CA" width=350>  
            Source Configuration File</th>            Source Configuration File</th>
        </tr>        </tr>
        <tr align="center">        <tr align="center">
Line 3355 
Line 3326 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/ConfigFileDirVms.h</td>            Pegasus/Config/ConfigFileDirVms.h</td>
        </tr>        </tr>
        </table>         </tbody></table>
 </ul> </ul>
  
 <h3>Configuration Macros</h3> <h3>Configuration Macros</h3>
Line 3414 
Line 3385 
      each system.<br>      each system.<br>
   <b>Source Configuration File:&nbsp;</b>   <b>Source Configuration File:&nbsp;</b>
      Pegasus/Common/Constants.h<b><br>      Pegasus/Common/Constants.h<b><br>
 </ul>  </b></ul>
  
 <h5>PEGASUS_LOCAL_AUTH_DIR</h5>  <h5><b>PEGASUS_LOCAL_AUTH_DIR</b></h5>
 <ul> <ul>
   <b>Description:</b>&nbsp;</b>For local connections (i.e.,  <b>  <b>Description:</b>&nbsp;</b>For local connections (i.e.,
      connectLocal), OpenPegasus uses a file-based authentication      connectLocal), OpenPegasus uses a file-based authentication
      mechanism.<br>      mechanism.<br>
   <b>Recommended Default Value (Development Build): </b>/tmp<br>   <b>Recommended Default Value (Development Build): </b>/tmp<br>
Line 3464 
Line 3435 
 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p> SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p>
 <hr> <hr>
 </body>  </body></html>
 </html>  

Legend:
Removed from v.1.24.2.1  
changed lines
  Added in v.1.24.2.2
No CVS admin address has been configured
 Powered by
ViewCVS 0.9.2