(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.35

version 1.24.2.8, 2014/05/05 21:03:29 version 1.35, 2012/08/09 10:32:16
Line 78 
Line 78 
       <td>&nbsp;</td>       <td>&nbsp;</td>
     </tr>     </tr>
     <tr align="left">     <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 282 
Line 278 
 must exist in the $(PEGASUS_ROOT)/Schemas directory) that will be used must exist in the $(PEGASUS_ROOT)/Schemas directory) that will be used
 to build the class repository for testing the pegasus environment to build the class repository for testing the pegasus environment
 ("make repository", etc.).<br> ("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>Default Value:&nbsp;</b>CIM231 (Note that this may change as newer versions of the CIM Schema are used as the default.<br>
   <b>Recommended Value (Development Build):&nbsp;</b>   <b>Recommended Value (Development Build):&nbsp;</b>
      No Specific Recommendation<br>      No Specific Recommendation<br>
   <b>Recommended Value (Release Build):&nbsp;</b>   <b>Recommended Value (Release Build):&nbsp;</b>
Line 877 
Line 873 
      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 960 
Line 942 
      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 1099 
Line 1097 
      2.3.2 on Linux" for additional details.<br>      2.3.2 on Linux" for additional details.<br>
 </ul> </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>
   
 <h5>PEGASUS_MAX_THREADS_PER_SVC_QUEUE</h5> <h5>PEGASUS_MAX_THREADS_PER_SVC_QUEUE</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>Controls the maximum number of threads   <b>Description:&nbsp;</b>Controls the maximum number of threads
Line 1181 
Line 1202 
 <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 1239 
      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 1995 
Line 1995 
       <tr align="center">       <tr align="center">
         <td align="left" height="14" width="1">$MESSAGEDIR</td>         <td align="left" height="14" width="1">$MESSAGEDIR</td>
       </tr>       </tr>
       <tr align="center">  
         <td align="left" height="14" width="1">$WEBCONFDIR</td>  
       </tr>  
   
       </tbody></table>       </tbody></table>
 </ul> </ul>
  
Line 2750 
Line 2746 
  
 <h5>maxIndicationDeliveryRetryAttempts</h5> <h5>maxIndicationDeliveryRetryAttempts</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b> If set to a positive integer, value defines the number    <b>Description:&nbsp;</b> If set to a positive integer, this value
          of times indication service will enable the reliableIndication feature and try       defines the number of times that the indication service will
          to deliver an indication to a particular listener destination.       try to deliver an indication to a particular listener destination.
          This does not effect the original delivery attempt. A value of disables       This does not effect the original delivery attempt, thus if set to 0,
          reliable indication feature completely, and cimserver will deliver the       cimserver will only try to deliver the indication once.<br>
          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 (Development Build):&nbsp;</b>3<br>
   <b>Recommended Default Value (Release 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 (Development Build): </b>No/No<br>
Line 3096 
Line 3090 
        </tbody></table>        </tbody></table>
 </p></ul> </p></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>
   <b>Description:&nbsp;</b>If the CIM Server receives an   <b>Description:&nbsp;</b>If the CIM Server receives an
Line 3192 
Line 3148 
      Pegasus/Config/SecurityPropertyOwner.cpp      Pegasus/Config/SecurityPropertyOwner.cpp
 </ul> </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
Line 3396 
Line 3334 
      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>


Legend:
Removed from v.1.24.2.8  
changed lines
  Added in v.1.35

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2