(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.8 and 1.25

version 1.24.2.8, 2014/05/05 21:03:29 version 1.25, 2011/01/20 13:08:17
Line 1 
Line 1 
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  <html>
 <html><head>  <head>
     <link rel="stylesheet" href=
       "http://www.opengroup.org/stylesheets/info1.css">
   </head>
  
   <link rel="stylesheet" href="http://www.opengroup.org/stylesheets/info1.css"></head><body>  <body>
 <hr> <hr>
  
 <p align="center"> <p align="center">
Line 15 
Line 18 
   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
   "Documented Platforms" section of this document.    &quot;Documented Platforms&quot; 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 44 
Line 47 
 additional information.</p> additional information.</p>
  
 <ul> <ul>
   <table bordercolordark="#666666" bordercolorlight="#CCCCCC" border="1" cellspacing="1" width="20%">    <table border="1" cellspacing="1" bordercolordark="#666666"
     <tbody><tr>      bordercolorlight="#CCCCCC" width=20%>
       <th align="center" bgcolor="#cae6ca">Platform</th>      <tr>
       <th align="center" bgcolor="#cae6ca">Status</th>        <th bgcolor="#CAE6CA" align=center>Platform</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 74 
Line 78 
       <td>&nbsp;</td>       <td>&nbsp;</td>
     </tr>     </tr>
     <tr align="left">     <tr align="left">
       <td>LINUX_PPC_E500_GNU</td>  
       <td>&nbsp;</td>  
     </tr>  
     <tr align="left">  
       <td>LINUX_SH4_GNU</td>  
       <td>&nbsp;</td>  
     </tr>  
     <tr align="left">  
       <td>LINUX_XSCALE_GNU</td>       <td>LINUX_XSCALE_GNU</td>
       <td>&nbsp;</td>       <td>&nbsp;</td>
     </tr>     </tr>
Line 101 
Line 97 
       <td>VMS_IA64_DECCXX</td>       <td>VMS_IA64_DECCXX</td>
       <td>&nbsp;</td>       <td>&nbsp;</td>
     </tr>     </tr>
     </tbody></table>      </table>
 </ul> </ul>
  
 <h2>Proposed Solution</h2> <h2>Proposed Solution</h2>
Line 117 
Line 113 
     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="http://www.openpegasus.org/pp/uploads/40/7197/SecurityGuidePEP.htm">      that feature. See <a href=
       "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 130 
Line 127 
 <h3>Terminology Notes</h3> <h3>Terminology Notes</h3>
 <ol> <ol>
   <li>   <li>
     In this document, the term "Not Set" is used to indicate      In this document, the term &quot;Not Set&quot; 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.
     "Set" is used to indicate that the value must be defined,      &quot;Set&quot; 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 142 
Line 139 
 <ol> <ol>
   <li>   <li>
     Not all functionality described in this document has achieved     Not all functionality described in this document has achieved
     "Green"status, please refer to the      &quot;Green&quot;status, please refer to the
     <a href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&amp;ggid=799">      <a href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&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 178 
Line 175 
      additional details.      additional details.
 </ul> </ul>
  
   <h5>ICU_NO_UPPERCASE_ROOT</h5>
   <ul>
     <b>Description:&nbsp;</b>If set, the messages in the root resource
        bundle will NOT be capitalized. By default, the root resource
        bundle is capitalized.<br>
     <b>Default Value:&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>Required:&nbsp;</b>No<br>
     <b>Considerations:&nbsp;</b>This environment variable is only used
        if PEGASUS_HAS_MESSAGES is set. Refer to PEGASUS_HAS_MESSAGES for
        additional details.
   </ul>
   
 <h5>ICU_ROOT_BUNDLE_LANG</h5> <h5>ICU_ROOT_BUNDLE_LANG</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>If set, specifies the language   <b>Description:&nbsp;</b>If set, specifies the language
Line 256 
Line 267 
      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>
 </p></ul>  </ul>
  
 <h5>PEGASUS_CCOVER</h5> <h5>PEGASUS_CCOVER</h5>
 <ul> <ul>
Line 270 
Line 281 
   <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&amp;T system.<br>       CCOVER for the NB&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 testing OpenPegasus in the integrated       OpenPegasus development team when upgrading the OpenPegasus build
 build/test environment. It defines the version of the CIM Schema (which       environment to a new version of the CIM Schema.<br>
 must exist in the $(PEGASUS_ROOT)/Schemas directory) that will be used    <b>Default Value:&nbsp;</b>CIM217<br>
 to build the class repository for testing the pegasus environment  
 ("make repository", etc.).<br>  
   <b>Default Value:&nbsp;</b>CIM236 (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>    <b>Considerations:</b> Additional code changes may be required when
 Additional code changes may be required when upgrading or downgrading       upgrading or downgrading the CIM Schema version.</p>
 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 307 
Line 309 
   <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></p>    <b>Required:&nbsp;</b>No </p>
 </ul> </ul>
  
 <h5>PEGASUS_DEBUG</h5> <h5>PEGASUS_DEBUG</h5>
Line 363 
Line 365 
      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 "hard-coded" default setting for the       change the &quot;hard-coded&quot; 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 439 
Line 441 
      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
      "LOCAL_DOMAIN_SOCKET" functionality has not been       &quot;LOCAL_DOMAIN_SOCKET&quot; 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 "Set" for Windows and OpenVMS       default, this option is &quot;Set&quot; for Windows and OpenVMS
      platforms.      platforms.
 </ul> </ul>
  
Line 596 
Line 598 
      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></p>    <b>Required:&nbsp;</b>No</p>
 </ul> </ul>
  
 <h5>PEGASUS_ENABLE_COMPRESSED_REPOSITORY</h5> <h5>PEGASUS_ENABLE_COMPRESSED_REPOSITORY</h5>
Line 697 
Line 699 
   <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="http://ltp.sourceforge.net/coverage/lcov.php">         Note: LCOV, <a href=
          "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 723 
Line 726 
                  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>
        </li></ol>         </ol>
     </ul>     </ul>
 </ul> </ul>
  
Line 747 
Line 750 
 <h5>PEGASUS_ENABLE_PROTOCOL_BINARY</h5> <h5>PEGASUS_ENABLE_PROTOCOL_BINARY</h5>
 <ul> <ul>
   <b>Description: </b>If true, OpenPegasus uses a faster binary   <b>Description: </b>If true, OpenPegasus uses a faster binary
      protocol between local clients and the CIM server. If false, OpenPegasus       protocol between local clients (including the provider agent) and the
      uses the conventional XML-based protocol instead.       CIM server. If false, OpenPegasus uses the conventional XML-based protocol
      See PEP#340 for more details.       instead. See PEP#340 for more details.
      <br>      <br>
   <b>Default Value: </b>false<br>   <b>Default Value: </b>false<br>
   <b>Recommended Value (Development Build): </b>false<br>   <b>Recommended Value (Development Build): </b>false<br>
Line 777 
Line 780 
      details.<br>      details.<br>
 </ul> </ul>
  
 <h5>PEGASUS_INTEROP_NAMESPACE</h5>  
 <ul>  
   <b>Description: </b>This variable is used for configuring the Interop  
      namespace name. This option helps to establish a consistent Interop  
      Namespace as mentioned in DMTF specification.(DSP1033)<br>  
   <b>Default Value: </b>root/PG_InterOp<br>  
   <b>Recommended Value (Development Build): </b>Not Set<br>  
   <b>Recommended Value (Release Build): </b>Not Set<br>  
   <b>Required: </b>No <br>  
   <b>Considerations:&nbsp;</b>The accepted values for this environment  
      variable are "root/PG_InterOp" or "interop" or "root/interop". For  
      any other value, the default value will be used.With the usage of  
      this build option, we have to start using pegasus with fresh repository.  
 </ul>  
   
 <h5>PEGASUS_ENABLE_IPV6</h5> <h5>PEGASUS_ENABLE_IPV6</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>This variable can be used to specify   <b>Description:&nbsp;</b>This variable can be used to specify
Line 821 
Line 809 
   <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></p>    <b>Required:&nbsp;</b>No</p>
 </ul> </ul>
  
 <h5>PEGASUS_ENABLE_OBJECT_NORMALIZATION</h5> <h5>PEGASUS_ENABLE_OBJECT_NORMALIZATION</h5>
Line 877 
Line 865 
      releases. Also note the known limitations specified in PEP 311.<br>      releases. Also note the known limitations specified in PEP 311.<br>
 </ul> </ul>
  
 <h5>PEGASUS_ENABLE_PROTOCOL_WEB</h5>  
 <ul>  
   <b>Description:&nbsp;</b>Enable pegasus to act as webserver capable  
      of serving webpages by comsuming the JSON output from CIM-RS.<br>  
   <b>Default Value:&nbsp;</b>true<br>  
   <b>Recommended Value (Development Build):&nbsp;</b>true<br>  
   <b>Recommended Value (Release Build):&nbsp;</b>true<br>  
   <b>Required:&nbsp;</b>No<br>  
   <b>Considerations:&nbsp;</b> When authentication is disabled, Anybody can  
   modify the pegasus cimserver. Please enable authentication when using  
   webadmin to prevent unauthorized access. <br>  
 </ul>  
   
   
 <h5>PEGASUS_ENABLE_REMOTE_CMPI</h5> <h5>PEGASUS_ENABLE_REMOTE_CMPI</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>If set, a version of OpenPegasus that   <b>Description:&nbsp;</b>If set, a version of OpenPegasus that
Line 899 
Line 873 
   <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></p>    <b>Required:&nbsp;</b>No</p>
 </ul> </ul>
  
 <h5>PEGASUS_ENABLE_SLP</h5> <h5>PEGASUS_ENABLE_SLP</h5>
Line 911 
Line 885 
      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., "PEGASUS_ENABLE_SLP ($(PEGASUS_ENABLE_SLP)) invalid,       (e.g., &quot;PEGASUS_ENABLE_SLP ($(PEGASUS_ENABLE_SLP)) invalid,
      must be true or false").<br>       must be true or false&quot;).<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 960 
Line 934 
      CIM_ERR_NOT_SUPPORTED.<br>      CIM_ERR_NOT_SUPPORTED.<br>
 </ul> </ul>
  
   <h5>PEGASUS_ENABLE_SSLV2</h5>
   <ul>
     <b>Description:&nbsp;</b>By default, support for the SSLV2 protocol
        is disabled in OpenPegasus. The option can be used to build a
        version of OpenPegasus that supports SSLV2. This variable affects
        how SSL contexts are constructed for both the CIM Server and CIM
        Clients.<br>
     <b>Default Value:&nbsp;</b>Not Set<br>
     <b>Recommended Value (Development Build): </b>Not Set<br>
     <b>Recommended Value (Release Build):&nbsp;</b>Not Set<br>
     <b>Required:&nbsp;</b>No<br>
     <b>Considerations:</b> Unless SSLV2 is required for backward
        compatibility, enabling this protocol is not recommended (SSLV3
        or later is preferred).
    </ul>
   
 <h5>PEGASUS_ENABLE_USERGROUP_AUTHORIZATION</h5> <h5>PEGASUS_ENABLE_USERGROUP_AUTHORIZATION</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>Builds a  version of OpenPegasus that   <b>Description:&nbsp;</b>Builds a  version of OpenPegasus that
Line 1091 
Line 1081 
   <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 "PEGASUS_HOME    <b>Considerations:&nbsp;</b>The error &quot;PEGASUS_HOME
      environment variable undefined" is returned if the       environment variable undefined&quot; 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 "Environment Variable Settings for Running OpenPegasus       titled &quot;Environment Variable Settings for Running OpenPegasus
      2.3.2 on Linux" for additional details.<br>       2.3.2 on Linux&quot; for additional details.<br>
   </ul>
   
   <h5>PEGASUS_INDICATIONS_Q_THRESHOLD</h5>
   <ul>
     <b>Description:&nbsp;</b>Controls if indications providers are stalled
        if the indications service queue is too large. It can be set
        to any positive value. If not set providers are never
        stalled. This implies that the indications service
        queue may become as large as necessary to hold all the
        indications generated. If set to any value then
        providers are stalled by forcing them to sleep when they
        try to deliver an indication and the indications service
        queue exceeds this value. They are resumed when the queue
        count falls 10 percent below this value. Stall and resume log
        entries are made to inform the administrator the condition has
        occurred.<br>
     <b>Default Value:&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>Required:&nbsp;</b>No<br>
     <b>Considerations:&nbsp;</b>Use of this setting may have
        unintended side-effects when using Out-of-Process Providers
        including delayed processing of CIM Operation Requests.
 </ul> </ul>
  
 <h5>PEGASUS_MAX_THREADS_PER_SVC_QUEUE</h5> <h5>PEGASUS_MAX_THREADS_PER_SVC_QUEUE</h5>
Line 1181 
Line 1194 
 <h5>PEGASUS_NOASSERTS</h5> <h5>PEGASUS_NOASSERTS</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>Defines the NDEBUG compilation macro, which   <b>Description:&nbsp;</b>Defines the NDEBUG compilation macro, which
      causes the preprocessor to remove PEGASUS_ASSERT() and disables assertion       causes the preprocessor to remove PEGASUS_ASSERT() statements.<br>
      on PEGASUS_FCT_EXECUTE_AND_ASSERT statements.<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>
   <b>Recommended Value (Release Build):&nbsp;</b>Set<br>   <b>Recommended Value (Release Build):&nbsp;</b>Set<br>
Line 1219 
Line 1231 
      dependent on platform support for PAM.<br>      dependent on platform support for PAM.<br>
 </ul> </ul>
  
 <h5>PEGASUS_PAM_SESSION_SECURITY</h5>  
 <ul>  
   <b>Description:&nbsp;</b>Enables support for PAM-(Pluggable  
      Authentication Modules) based authentication and authorization.<br>  
      When choosing this PAM method the PAM session started through pam_start  
      is kept open for the complete CIM request.  
      The PAM item PAM_RHOST will be set to the connection IP address.  
      This allows PAM modules to restrict number of concurrent connections  
      from a single host.<br>  
      If PEGASUS_PAM_SESSION_SECURITY is set, you cannot enable the Privilege  
      Separation feature (PEGASUS_ENABLE_PRIVILEGE_SEPARATION) or the  
      authentication-only PAM mechanism (PEGASUS_PAM_AUTHENTICATION).<br>  
   <b>Default Value:&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>Required:&nbsp;</b>No<br>  
   <b>Considerations:&nbsp;</b>Support for PAM in OpenPegasus is  
      dependent on platform support for PAM.<br>  
 </ul>  
   
 <h5>PEGASUS_PLATFORM</h5> <h5>PEGASUS_PLATFORM</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>Describes the target platform for the   <b>Description:&nbsp;</b>Describes the target platform for the
Line 1250 
Line 1242 
      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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="542">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>         bordercolorlight="#CCCCCC" width=542
         <th bgcolor="#cae6ca" width="190">Platform</th>         style='font-size=10.0pt;font-family:Arial'>
         <th bgcolor="#cae6ca" width="351">Recommended Value <br>         <tr>
           <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 align="left" width="190">Linux IA32</td>          <td width="190" align="left">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 align="left" width="190">Linux IA64</td>         <td width="190" align="left">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 align="left" width="190">Linux X86_64</td>         <td width="190" align="left">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 align="left" width="190">HP-UX PA-RISC</td>         <td width="190" align="left">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 align="left" width="190">HP-UX IPF</td>         <td width="190" align="left">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 align="left" width="190">OpenVMS Alpha</td>         <td width="190" align="left">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 align="left" width="190">OpenVMS IA64</td>         <td width="190" align="left">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>
      </tbody></table>       </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 1389 
Line 1383 
      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>
 </p></ul>  </ul>
  
 <h5>PEGASUS_SNIA_EXTENSIONS</h5> <h5>PEGASUS_SNIA_EXTENSIONS</h5>
 <ul> <ul>
Line 1468 
Line 1462 
 <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 "alltests" OpenPegasus       be run as part of the &quot;alltests&quot; 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 1504 
Line 1498 
      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 "invalidUser" is not a valid       also assumes that &quot;invalidUser&quot; 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 1590 
Line 1584 
   <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>
 </p></ul>  </ul>
  
  
 <h5>PEGASUS_USE_NET_SNMP</h5> <h5>PEGASUS_USE_NET_SNMP</h5>
Line 1615 
Line 1609 
   <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>
 </p></ul>  </ul>
  
 <h5>PEGASUS_ENABLE_NET_SNMPV3</h5> <h5>PEGASUS_ENABLE_NET_SNMPV3</h5>
 <ul> <ul>
Line 1629 
Line 1623 
   <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>
 </p></ul>  </ul>
  
  
 <h5>PEGASUS_USE_OPENSLP</h5> <h5>PEGASUS_USE_OPENSLP</h5>
Line 1673 
Line 1667 
 <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 "Development Build"       OpenPegasus is built using the &quot;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 1683 
Line 1677 
      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
      ("Development Build") environment and a set of options       (&quot;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 "Recommended Value (Release Build)"       variable,&nbsp; the &quot;Recommended Value (Release Build)&quot;
      value defines the recommended settings to use for a      value defines the recommended settings to use for a
      "Release Build".&nbsp; Please refer to the       &quot;Release Build&quot;.&nbsp; Please refer to the
      description of each variable for additional information.      description of each variable for additional information.
 </ul> </ul>
  
Line 1697 
Line 1691 
 <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 "Development Build"       OpenPegasus is built using the &quot;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 1707 
Line 1701 
      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
      ("Development Build") environment and a set tuned for the       (&quot;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 1822 
Line 1816 
   <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></p>    <b>Required:&nbsp;</b>No </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 1891 
Line 1885 
      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
      "$PEGASUS_HOME/msg" else "."<br>       &quot;$PEGASUS_HOME/msg&quot; else &quot;.&quot;<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 1916 
Line 1910 
     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 ("Development Build") environment      development/debug (&quot;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 1953 
Line 1947 
     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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" height="228" width="148">      <table border="1" cellspacing="1" bordercolordark="#666666"
       <tbody><tr>          bordercolorlight="#CCCCCC" width=148
         <th bgcolor="#cae6ca" height="16" width="1">&nbsp;</th>          style='font-size=10.0pt;font-family:Arial' height="228">
         <tr>
           <th bgcolor="#CAE6CA" width=1 height="16">&nbsp;</th>
       </tr>       </tr>
         <tr align="center">         <tr align="center">
         <td align="left" height="12" width="1">$LOGDIR</td>          <td align="left" width="1" height="12">$LOGDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$PROVIDERDIRS</td>          <td align="left" width="1" height="14">$PROVIDERDIRS</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">          <td align="left" width="1" height="14">
           $PROVIDERMANAGERDIRS</td>           $PROVIDERMANAGERDIRS</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$REPOSITORYDIR </td>          <td align="left" width="1" height="14">$REPOSITORYDIR </td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$CERTIFICATEDIR&nbsp;          <td align="left" width="1" height="14">$CERTIFICATEDIR&nbsp;
         </td>         </td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$LOCALAUTHDIR</td>          <td align="left" width="1" height="14">$LOCALAUTHDIR</td>
       </tr>  
       <tr align="center">  
         <td align="left" height="14" width="1">$TRACEDIR</td>  
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$CONFIGDIR</td>          <td align="left" width="1" height="14">$TRACEDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$PIDFILE</td>          <td align="left" width="1" height="14">$CONFIGDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$RANDOMDIR</td>          <td align="left" width="1" height="14">$PIDFILE</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$SOCKETDIR</td>          <td align="left" width="1" height="14">$RANDOMDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$MESSAGEDIR</td>          <td align="left" width="1" height="14">$SOCKETDIR</td>
       </tr>       </tr>
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$WEBCONFDIR</td>          <td align="left" width="1" height="14">$MESSAGEDIR</td>
       </tr>       </tr>
         </table>
       </tbody></table>  
 </ul> </ul>
  
 <h4>Definitions</h4> <h4>Definitions</h4>
Line 2040 
Line 2032 
      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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
      <tbody><tr>         bordercolorlight="#CCCCCC" width=531
        <th bgcolor="#cae6ca" width="168">Platform</th>         style='font-size=10.0pt;font-family:Arial'>
        <th bgcolor="#cae6ca" width="350">Source Configuration File</th>       <tr>
          <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 2060 
Line 2054 
        <td align="left" width="350">        <td align="left" width="350">
          Pegasus/Config/DefaultPropertyTableVms.h</td>          Pegasus/Config/DefaultPropertyTableVms.h</td>
      </tr>      </tr>
      </tbody></table>       </table>
 </p></ul>  </ul>
  
 <h5>enableAssociationTraversal</h5> <h5>enableAssociationTraversal</h5>
 <ul> <ul>
Line 2079 
Line 2073 
      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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
      <tbody><tr>         bordercolorlight="#CCCCCC" width=531
        <th bgcolor="#cae6ca" width="168">Platform</th>         style='font-size=10.0pt;font-family:Arial'>
        <th bgcolor="#cae6ca" width="350">Source Configuration File</th>       <tr>
          <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 2099 
Line 2095 
        <td align="left" width="350">        <td align="left" width="350">
          Pegasus/Config/DefaultPropertyTableVms.h</td>          Pegasus/Config/DefaultPropertyTableVms.h</td>
      </tr>      </tr>
      </tbody></table>       </table>
 </ul> </ul>
  
 <h5>enableAuditLog</h5> <h5>enableAuditLog</h5>
Line 2141 
Line 2137 
   <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></p>       Pegasus/Config/RepositoryPropertyOwner.cpp</p>
 </ul> </ul>
  
  
Line 2166 
Line 2162 
      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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" width="168">Platform</th>           style='font-size=10.0pt;font-family:Arial'>
          <th bgcolor="#cae6ca" width="350">Source Configuration File</th>         <tr>
            <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 2186 
Line 2184 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </ul> </ul>
  
 <h5>enableHttpsConnection</h5> <h5>enableHttpsConnection</h5>
Line 2204 
Line 2202 
      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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" width="168">Platform</th>           style='font-size=10.0pt;font-family:Arial'>
          <th bgcolor="#cae6ca" width="350">Source Configuration File</th>         <tr>
            <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 2224 
          <td align="left" width="350">          <td align="left" width="350">
           Pegasus/Config/DefaultPropertyTableVms.h</td>           Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </ul> </ul>
  
 <h5>enableIndicationService</h5> <h5>enableIndicationService</h5>
Line 2262 
Line 2262 
      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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" width="168">Platform</th>           style='font-size=10.0pt;font-family:Arial'>
          <th bgcolor="#cae6ca" width="350">Source Configuration File</th>         <tr>
            <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 2282 
Line 2284 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </ul> </ul>
  
 <h5>enableNamespaceAuthorization</h5> <h5>enableNamespaceAuthorization</h5>
Line 2323 
Line 2325 
           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><li>Provider Modules that are listed on the        <li>Provider Modules that are listed on the
           excludeModulesFromNormalization           excludeModulesFromNormalization
           configuration option are excluded from normalization.           configuration option are excluded from normalization.
       </li><li>Since the concept of normalization is relatively new to        <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 2335 
Line 2337 
           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><li>'CMPI' / 2.0.0 or greater              <li>'CMPI' / 2.0.0 or greater
             </li><li>'JMPI' / 1.0.0 or greater              <li>'JMPI' / 1.0.0 or greater
         </li></ul>          </ul>
      </li></ul>       </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 2390 
Line 2392 
      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>""<br>    <b>Default Value:&nbsp;</b>&quot;&quot;<br>
   <b>Recommended Default Value (Development Build):</b>   <b>Recommended Default Value (Development Build):</b>
      ""<br>       &quot;&quot;<br>
   <b>Recommended Default Value (Release Build):&nbsp;</b>   <b>Recommended Default Value (Release Build):&nbsp;</b>
      ""<br>       &quot;&quot;<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 2445 
Line 2447 
        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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">         <table border="1" cellspacing="1" bordercolordark="#666666"
          <tbody><tr>             bordercolorlight="#CCCCCC" width=531
            <th bgcolor="#cae6ca" width="168">Platform</th>             style='font-size=10.0pt;font-family:Arial'>
            <th bgcolor="#cae6ca" width="350">           <tr>
              <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 2466 
Line 2470 
            <td align="left" width="350">            <td align="left" width="350">
              Pegasus/Config/DefaultPropertyTableVms.h</td>              Pegasus/Config/DefaultPropertyTableVms.h</td>
          </tr>          </tr>
          </tbody></table>           </table>
 </ul> </ul>
  
 <h5>home</h5> <h5>home</h5>
Line 2480 
Line 2484 
   <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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" width="168">Platform</th>           style='font-size=10.0pt;font-family:Arial'>
          <th bgcolor="#cae6ca" width="350">Source Configuration File</th>         <tr>
            <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 2500 
Line 2506 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </p></ul>  
   
 <h5>hostname</h5>  
 <ul>  
   <b>Description:&nbsp;</b> Can be used to override the local system supplied  
       hostname without domain the CIM Server is using to build objects.  
       If not set, querying this configuration option will report  
       the system supplied hostname and behavior is not changed.<br>  
       Setting this value to a valid hostname on CIM Server startup or as  
       planned value will force the server to assume the configured name as the  
       local hosts name. Setting this allows the administrator to set the name  
       that operations such as associator, reference etc. return with  
       object paths.<br>  
       In common setups it is not recommended to explicitly set this value.  
      <br>  
   <b>Usage scenarios:&nbsp;</b> The following scenarios in which changing the  
       default value makes sense are known today:<br>  
           1. The case where what the CIM Server shall return to clients for  
              host name is NOT the name of the current host but some  
              administrator defined name  
              (ex. system behind a firewall or some redirector).<br>  
           2. Embedded systems that have a system set hostname which is not  
              valid and needs to be overridden by CIM administrator without  
              changing the actual IP configuration.  
      <br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>  
      blank<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>  
      blank<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>Dynamic?:&nbsp;</b>No<br>  
   <b>Considerations: </b> When setting this configuration option the option  
       fullyQualifiedHostName should be adjusted too.<br>  
       Providers returning the systems hostname in an  
       instance property might return a different value then the CIM server is  
       setting in the object path. hostnames explicitly set into the object  
       paths by providers will not be overridden by the CIM Server to allow  
       cross-namespace associations.  
      <br>  
       It is necessary to upgrade existing repositories using the repupgrade  
       utility when upgrading from an OpenPegasus version less than 2.12.  
      <br>  
   <b>Source Configuration File:&nbsp;</b>  
      Pegasus/Config/DefaultPropertyOwner.cpp  
 </ul>  
   
 <h5>fullyQualifiedHostName</h5>  
 <ul>  
   <b>Description:&nbsp;</b> Can be used to override the local system supplied  
       fully qualified hostname (with domain) the CIM Server is using to build  
       objects.  
       If not set, querying this configuration option will report  
       the system supplied fully qualified hostname and behavior is  
       not changed.<br>  
       Setting this value to a valid hostname on CIM Server startup or as  
       planned value will force the server to assume the configured name as the  
       local hosts name with domain. Setting this allows the administrator to  
       set the name that indication operations and the CIM_ObjectManager  
       assume for SystemName returned as instance and key properties.<br>  
       In common setups it is not recommended to explicitly set this value.  
      <br>  
   <b>Usage scenarios:&nbsp;</b> The following scenarios in which changing the  
       default value makes sense are known today:<br>  
           1. The case where what the CIM Server shall return to clients for  
              SystemName is NOT the name of the current host but some  
              administrator defined name  
              (ex. system behind a firewall or some redirector).<br>  
           2. Embedded systems that have a system set hostname which is not  
              valid and needs to be overridden by CIM administrator without  
              changing the actual IP configuration.  
      <br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>  
      blank<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>  
      blank<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>Dynamic?:&nbsp;</b>No<br>  
   <b>Considerations: </b> When setting this configuration option the option  
       fullyQualifiedHostName should be adjusted too.<br>  
       Providers returning the systems hostname in an  
       instance property might return a different value then the CIM server is  
       setting in SystemName.  
      <br>  
       It is necessary to upgrade existing repositories using the repupgrade  
       utility when upgrading from an OpenPegasus version less than 2.12.  
      <br>  
   <b>Source Configuration File:&nbsp;</b>  
      Pegasus/Config/DefaultPropertyOwner.cpp  
 </ul> </ul>
  
 <h5>httpPort</h5> <h5>httpPort</h5>
Line 2611 
Line 2527 
      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 "". This       httpPort was changed from 5988 to &quot;&quot;. 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 2620 
Line 2536 
      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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" width="168">Platform</th>           style='font-size=10.0pt;font-family:Arial'>
          <th bgcolor="#cae6ca" width="350">Source Configuration File</th>         <tr>
            <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 2640 
Line 2558 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </ul> </ul>
  
 <h5>httpsPort</h5> <h5>httpsPort</h5>
Line 2662 
Line 2580 
      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 "". This       httpPort was changed from 5989 to &quot;&quot;. 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 2671 
Line 2589 
      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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" width="168">Platform</th>           style='font-size=10.0pt;font-family:Arial'>
          <th bgcolor="#cae6ca" width="350">Source Configuration File</th>         <tr>
            <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 2691 
Line 2611 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </ul> </ul>
  
 <h5>idleConnectionTimeout</h5> <h5>idleConnectionTimeout</h5>
Line 2748 
Line 2668 
      the ultimate goal SHALL be fixing the faulty provider.      the ultimate goal SHALL be fixing the faulty provider.
 </ul> </ul>
  
 <h5>maxIndicationDeliveryRetryAttempts</h5>  
 <ul>  
   <b>Description:&nbsp;</b> If set to a positive integer, value defines the number  
          of times indication service will enable the reliableIndication feature and try  
          to deliver an indication to a particular listener destination.  
          This does not effect the original delivery attempt. A value of disables  
          reliable indication feature completely, and cimserver will deliver the  
          indication once.This is in accord with DTMF Specification 1054,  
          Indication Profile, version 1.2.1.<br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>3<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>3<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>Dynamic?:&nbsp;</b>No<br>  
   <b>Considerations:&nbsp;</b> This value is used to set the  
      CIM_IndicationService.DeliveryRetryAttempts property. See  
      CIM_IndicationService.DeliveryRetryAttempts property for more details. This  
      option is supported only when PEGASUS_ENABLE_DMTF_INDICATION_PROFILE_SUPPORT  
      is defined.<br>  
   <b>Source Configuration File:&nbsp;</b>  
      Pegasus/Config/IndicationServicePropertyOwner.cpp<br>  
 </ul>  
   
 <h5>minIndicationDeliveryRetryInterval</h5>  
 <ul>  
   <b>Description:&nbsp;</b> If set to a positive integer, this value defines  
      the minimal time interval in seconds for the indication service to wait  
      before retrying to deliver an indication to a listener destination that  
      previously failed. Cimserver may take longer due to QoS or other processing.<br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>30<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>30<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>Dynamic?:&nbsp;</b>No<br>  
   <b>Considerations:&nbsp;</b> This value is used to initialize the property  
      CIM_IndicationService.DeliveryRetryInterval. See  
      CIM_IndicationService.DeliveryRetryInterval property for more details. This  
      option is supported only when PEGASUS_ENABLE_DMTF_INDICATION_PROFILE_SUPPORT  
      is defined.<br>  
   <b>Source Configuration File:&nbsp;</b>  
      Pegasus/Config/IndicationServicePropertyOwner.cpp<br>  
 </ul>  
   
 <h5>listenAddress</h5>  
 <ul>  
   <b>Description:&nbsp;</b> Network interface where the cimserver  
      should listen to for connections.For example listenAddress=All or  
      listenAddress=121.12.33.112 or listenAddress=121.33.21.26,127.0.0.1,  
      fe80::fe62:9346%eth0<br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>All<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>No Specific suggestion<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>Dynamic?:&nbsp;</b>No<br>  
   <b>Considerations:&nbsp;</b>Default value of "All" will make cimserver to listen on all the network interfaces.<br>  
   <b>Source Configuration File:&nbsp;</b>  
      Pegasus/Config/DefaultPropertyOwner.cpp<br>  
 </ul>  
   
 <h5>logdir</h5> <h5>logdir</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>Specifies the name of the directory   <b>Description:&nbsp;</b>Specifies the name of the directory
Line 2869 
Line 2730 
      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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" width="168">Platform</th>           style='font-size=10.0pt;font-family:Arial'>
          <th bgcolor="#cae6ca" width="350">         <tr>
            <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 2890 
Line 2753 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </ul> </ul>
  
 <h5>messageDir</h5> <h5>messageDir</h5>
Line 2923 
Line 2786 
   <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&#8217;s executable to be       system. Allowing a registered Provider’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. Administrators are responsible for ensuring       to the system. Adminstrators are responsible for ensuring
      that only trusted Providers are loaded into providerDir.      that only trusted Providers are loaded into providerDir.
      In order to simplify the management task associated with      In order to simplify the management task associated with
      securing Provider executable, the value of providerDir can be      securing Provider executable, the value of providerDir can be
Line 2969 
Line 2832 
   <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>
 </p></ul>  </ul>
  
 <h5>repositoryIsDefaultInstanceProvider</h5> <h5>repositoryIsDefaultInstanceProvider</h5>
 <ul> <ul>
Line 2996 
Line 2859 
        <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> &nbsp;A client application         <li><b>Appearance of instrumentation.</b>  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&nbsp;a             the client gets a "success" response. Does that mean 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> &nbsp;Using the         <li><b>Potential for inconsistent data.</b>  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 3072 
Line 2935 
   <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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" height="80" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" height="16" width="168">Platform</th>           style='font-size=10.0pt;font-family:Arial' height="80">
          <th bgcolor="#cae6ca" height="16" width="350">         <tr>
            <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 height="14" width="168">Linux</td>          <td width="168" height="14">Linux</td>
          <td align="left" height="14" width="350">           <td align="left" width="350" height="14">
            Pegasus/Config/DefaultPropertyTableLinux.h</td>            Pegasus/Config/DefaultPropertyTableLinux.h</td>
        </tr>        </tr>
        <tr align="center">        <tr align="center">
          <td height="14" width="168">HP-UX</td>           <td width="168" height="14">HP-UX</td>
          <td align="left" height="14" width="350">           <td align="left" width="350" height="14">
            Pegasus/Config/DefaultPropertyTableHpux.h</td>            Pegasus/Config/DefaultPropertyTableHpux.h</td>
        </tr>        </tr>
        <tr align="center">        <tr align="center">
          <td height="16" width="168">OpenVMS</td>           <td width="168" height="16">OpenVMS</td>
          <td align="left" height="16" width="350">           <td align="left" width="350" height="16">
            Pegasus/Config/DefaultPropertyTableVms.h</td>            Pegasus/Config/DefaultPropertyTableVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </p></ul>  </ul>
   
 <h5>slpProviderStartupTimeout</h5>  
 <ul>  
   <b>Description:&nbsp;</b>Timeout value in milli seconds used to specify  
     how long the registration with an SLP SA may take. Registration will be  
     retried three times. This value only needs to be increased in case that  
     the loading of a set of providers who reporting their implementation of a  
     registered profile takes very long.<br>  
   <b>Default Value:&nbsp;</b>300000<br>  
   <b>Recommended Default Value (Development Build): </b>300000<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>300000<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>Dynamic?:&nbsp;</b>No<p>&nbsp;<br>  
   <br>  
      <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" height="80" width="531">  
        <tbody><tr>  
          <th bgcolor="#cae6ca" height="16" width="168">Platform</th>  
          <th bgcolor="#cae6ca" height="16" width="350">  
            Source Configuration File</th>  
        </tr>  
        <tr align="center">  
         <td height="14" width="168">Linux</td>  
          <td align="left" height="14" width="350">  
            Pegasus/Config/DefaultPropertyTable.h</td>  
        </tr>  
        <tr align="center">  
          <td height="14" width="168">HP-UX</td>  
          <td align="left" height="14" width="350">  
            Pegasus/Config/DefaultPropertyTable.h</td>  
        </tr>  
        <tr align="center">  
          <td height="16" width="168">OpenVMS</td>  
          <td align="left" height="16" width="350">  
            Pegasus/Config/DefaultPropertyTable.h</td>  
        </tr>  
        </tbody></table>  
 </p></ul>  
  
 <h5>socketWriteTimeout</h5> <h5>socketWriteTimeout</h5>
 <ul> <ul>
Line 3172 
Line 2999 
      Pegasus/Config/SecurityPropertyOwner.cpp      Pegasus/Config/SecurityPropertyOwner.cpp
 </ul> </ul>
  
 <h5>sslCipherSuite</h5>  
 <ul>  
   <b>Description:&nbsp;</b>String containing OpenSSL cipher  
      specifications to configure the cipher suite the client is  
      permitted to negotiate with the server during the SSL  
      handshake phase.<br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>  
      DEFAULT (the default cipher list of OpenSSL)<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>  
      DEFAULT (the default cipher list of OpenSSL)<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>Dynamic?:&nbsp;</b>No<br>  
   <b>Considerations:&nbsp;</b>The value should be mentioned between  
      single quotes since it can contain special characters like .+,  
      !, -.. For more details look at SSL ciphers.<br>  
   <b>Source Configuration File:&nbsp;</b>  
      Pegasus/Config/SecurityPropertyOwner.cpp  
 </ul>  
   
 <h5>sslBackwardCompatibility</h5>  
 <ul>  
   <b>Description:&nbsp;</b> If set to true, OpenPegasus support  
      SSLv3 and TLSv1 protocol.If set to false OpenPegasus support  
      only TLS1.2 protocol for openssl 1.0.1+ <br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>  
      false<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>  
      false<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>Dynamic?:&nbsp;</b>No<br>  
   <b>Considerations:&nbsp;</b> For a more detailed look at SSL options  
      and their ramifications, please see the SSL guidelines.<br>  
   <b>Source Configuration File:&nbsp;</b>  
      Pegasus/Config/SecurityPropertyOwner.cpp  
 </ul>  
   
 <h5>sslClientVerificationMode</h5> <h5>sslClientVerificationMode</h5>
 <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>&#8220;<b>required</b>&#8221; &#8211; The server requires certificate-based        <li>“<b>required</b>” – 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>&#8220;<b>optional</b>&#8221; &#8211; The server supports, but does not        <li>“<b>optional</b>” – 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>&#8220;<b>disabled</b>&#8221; &#8211; The server does not support        <li>“<b>disabled</b>” – 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 3238 
Line 3027 
   <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>"true"</b>.       <b>enableHttpsConnection</b> is  <b>&quot;true&quot;</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
      "sslClientVerificationMode" variable is set to       &quot;sslClientVerificationMode&quot; variable is set to
      "required" and HTTP is disabled.&nbsp; For these       &quot;required&quot; 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 "optional."<br>       property value to &quot;optional.&quot;<br>
   <b>Source Configuration File:&nbsp;</b>   <b>Source Configuration File:&nbsp;</b>
      Pegasus/Config/SecurityPropertyOwner.cpp      Pegasus/Config/SecurityPropertyOwner.cpp
 </ul> </ul>
Line 3325 
Line 3114 
 <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: "File"       messages. Valid values include: &quot;File&quot;
      , "Log" and "Memory" .<br>       , &quot;Log&quot; and &quot;Memory&quot; .<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 3334 
Line 3123 
   <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 "File",    <b>Considerations:&nbsp;</b>If you specify &quot;File&quot;,
      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
      "Log", trace messages are written to the       &quot;Log&quot;, 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 "PEGASUSMEMTRACE" at       found by the eye-catcher &quot;PEGASUSMEMTRACE&quot; 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 "EOTRACE".<br>       the last written message has the suffix &quot;EOTRACE&quot;.<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 3366 
Line 3155 
  
 <h5>traceLevel</h5> <h5>traceLevel</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>Defines the desired level of    <b>Description:&nbsp;</b></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&lt;<br>    <b>Recommended Default Value (Release Build): </b>0<<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 3396 
Line 3185 
      Pegasus/Config/TracePropertyOwner.cpp<br>      Pegasus/Config/TracePropertyOwner.cpp<br>
 </ul> </ul>
  
 <h5>traceFileSizeKBytes</h5>  
 <ul>  
   <b>Description:&nbsp;</b>Defines the size of the tracefile in Kilo bytes. The trace file will be  
      rolled once its size exceeds the specified size. <br>  
   <b>Default Value:&nbsp;</b>1048576<br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>1048576<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>1048576<br>  
   <b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br>  
   <b>Recommend To Be Fixed/Hidden (Release Build):</b>&nbsp;No/Yes<br>  
   <b>Dynamic?:</b>&nbsp;Yes<br>  
   <b>Considerations:</b>Minimum accepted value is 10240 KB,Maximum accepted value is 2097152 KB. &nbsp;<br>  
   <b>Source Configuration File:</b>&nbsp; Pegsus/Config/TracePropertyOwner.cpp<p>&nbsp;</p>  
 </ul>  
   
 <h5>numberOfTraceFiles</h5>  
 <ul>  
   <b>Description:&nbsp;</b>Specifies the number of the tracefiles for rolling.<br>  
   <b>Default Value:&nbsp;</b>3<br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>3<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>3<br>  
   <b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br>  
   <b>Recommend To Be Fixed/Hidden (Release Build):</b>&nbsp;No/Yes<br>  
   <b>Dynamic?:</b>&nbsp;Yes<br>  
   <b>Considerations:</b>Minimum accepted value is 3,Maximum accepted value is 20. &nbsp;<br>  
   <b>Source Configuration File:</b>&nbsp; Pegsus/Config/TracePropertyOwner.cpp<p>&nbsp;</p>  
 </ul>  
   
 <h5>webRoot</h5>  
 <ul>  
   <b>Description:&nbsp;</b> Points to a location where the static web pages to  
   be served by the pegasus webserver are stored.<br>  
   <b>Default Value:&nbsp;</b>www<br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>www<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>$WEBCONFDIR/www<br>  
   <b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br>  
   <b>Recommend To Be Fixed/Hidden (Release Build):</b>&nbsp;Yes/Yes<br>  
   <b>Dynamic?:</b>&nbsp;No<br>  
   <b>Considerations:</b> When not fixed and hidden, it can be modified to  
   point to a location having spurious pages. Please consider fixing this value. &nbsp;<br>  
   <b>Source Configuration File:</b>&nbsp; Pegsus/Config/DefaultPropertyOwner.cpp<p>&nbsp;</p>  
 </ul>  
   
 <h5>indexFile</h5>  
 <ul>  
   <b>Description:&nbsp;</b> Specifies the name of index file used by pegasus webserver,  
   default to index.html. This file should be available at the webRoot path.<br>  
   <b>Default Value:&nbsp;</b>index.html<br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>index.html<br>  
   <b>Recommended Default Value (Release Build):&nbsp;</b>index.html<br>  
   <b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br>  
   <b>Recommend To Be Fixed/Hidden (Release Build):</b>&nbsp;Yes/Yes<br>  
   <b>Dynamic?:</b>&nbsp;No<br>  
   <b>Considerations:</b> &nbsp; Hide it and fixed in release build to prevent  
   using any file as index file<br>  
   <b>Source Configuration File:</b>&nbsp; Pegsus/Config/DefaultPropertyOwner.cpp<p>&nbsp;</p>  
 </ul>  
   
 <h5>mimeTypesFile</h5>  
 <ul>  
   <b>Description:&nbsp;</b> Refers to the file which holds the mime types being  
   served by the pegasus webserver.<br>  
   <b>Default Value:&nbsp;</b>www/mimeTypes.txt<br>  
   <b>Recommended Default Value (Development Build):&nbsp;</b>www/mimeTypes.txt<br>  
   <b>Recommended Default Value (Release  
       Build):&nbsp;</b>$WEBCONFDIR/www/mimeTypes.txt<br>  
   <b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br>  
   <b>Recommend To Be Fixed/Hidden (Release Build):</b>&nbsp;Yes/Yes<br>  
   <b>Dynamic?:</b>&nbsp;No<br>  
   <b>Considerations:</b>&nbsp;Fix and make it read only when to prevent  
   modification in deployment<br>  
   <b>Source Configuration File:</b>&nbsp; Pegsus/Config/DefaultPropertyOwner.cpp<p>&nbsp;</p>  
 </ul>  
   
   
 <h3>Configuration Constants</h3> <h3>Configuration Constants</h3>
  
 <h4>Definitions</h4> <h4>Definitions</h4>
Line 3484 
Line 3199 
      $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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" width="168">Platform</th>           style='font-size=10.0pt;font-family:Arial'>
          <th bgcolor="#cae6ca" width="350">         <tr>
            <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 3504 
Line 3221 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/ConfigFileDirVms.h</td>            Pegasus/Config/ConfigFileDirVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </ul> </ul>
  
 <h5>static char PLANNED_CONFIG_FILE [] = </h5> <h5>static char PLANNED_CONFIG_FILE [] = </h5>
Line 3517 
Line 3234 
      $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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" width="168">Platform</th>          style='font-size=10.0pt;font-family:Arial'>
          <th bgcolor="#cae6ca" width="350">         <tr>
            <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 3538 
Line 3257 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/ConfigFileDirVms.h</td>            Pegasus/Config/ConfigFileDirVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </ul> </ul>
  
 <h5>static char CIMSERVER_START_FILE [] = </h5> <h5>static char CIMSERVER_START_FILE [] = </h5>
Line 3552 
Line 3271 
      $PIDFILE<br>      $PIDFILE<br>
   <b>Dynamic?:&nbsp;</b>No<br>   <b>Dynamic?:&nbsp;</b>No<br>
      <br>      <br>
      <table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531">       <table border="1" cellspacing="1" bordercolordark="#666666"
        <tbody><tr>           bordercolorlight="#CCCCCC" width=531
          <th bgcolor="#cae6ca" width="168">Platform</th>           style='font-size=10.0pt;font-family:Arial'>
          <th bgcolor="#cae6ca" width="350">         <tr>
            <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 3573 
Line 3294 
          <td align="left" width="350">          <td align="left" width="350">
            Pegasus/Config/ConfigFileDirVms.h</td>            Pegasus/Config/ConfigFileDirVms.h</td>
        </tr>        </tr>
        </tbody></table>         </table>
 </ul> </ul>
  
 <h3>Configuration Macros</h3> <h3>Configuration Macros</h3>
Line 3632 
Line 3353 
      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>
 </b></ul>  </ul>
  
 <h5><b>PEGASUS_LOCAL_AUTH_DIR</b></h5>  <h5>PEGASUS_LOCAL_AUTH_DIR</h5>
 <ul> <ul>
 <b>  <b>Description:</b>&nbsp;</b>For local connections (i.e.,    <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 3682 
Line 3403 
 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></html>  </body>
   </html>

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