(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.5 and 1.32

version 1.24.2.5, 2013/09/14 23:08:13 version 1.32, 2012/05/14 09:12:11
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 178 
Line 174 
      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 282 
Line 292 
 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 1101 
Line 1111 
      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 1183 
Line 1216 
 <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 1221 
Line 1253 
      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 2501 
Line 2513 
        </tbody></table>        </tbody></table>
 </p></ul> </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>  
   
 <h5>httpPort</h5> <h5>httpPort</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>OpenPegasus first attempts to look up the   <b>Description:&nbsp;</b>OpenPegasus first attempts to look up the
Line 2787 
Line 2709 
      Pegasus/Config/IndicationServicePropertyOwner.cpp<br>      Pegasus/Config/IndicationServicePropertyOwner.cpp<br>
 </ul> </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 2922 
Line 2828 
      system. Allowing a registered Provider&#8217;s executable to be      system. Allowing a registered Provider&#8217;s executable to be
      replaced with malicious code would result in a critical      replaced with malicious code would result in a critical
      security defect, giving a malicious user privileged access      security defect, giving a malicious user privileged access
      to the system. 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 3092 
Line 2998 
        </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 3188 
Line 3056 
      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 3392 
Line 3242 
      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>  
   
 <h3>Configuration Constants</h3> <h3>Configuration Constants</h3>
  
 <h4>Definitions</h4> <h4>Definitions</h4>


Legend:
Removed from v.1.24.2.5  
changed lines
  Added in v.1.32

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2