(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.3 and 1.30

version 1.24.2.3, 2013/06/03 22:34:46 version 1.30, 2012/02/09 09:18:37
Line 74 
Line 74 
       <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_XSCALE_GNU</td>       <td>LINUX_XSCALE_GNU</td>
       <td>&nbsp;</td>       <td>&nbsp;</td>
     </tr>     </tr>
Line 174 
Line 170 
      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 278 
Line 288 
 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 773 
Line 783 
      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 1097 
Line 1092 
      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 1179 
Line 1197 
 <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 1217 
Line 1234 
      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 2497 
Line 2494 
        </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 2783 
Line 2690 
      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 2918 
Line 2809 
      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 3088 
Line 2979 
        </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 3370 
Line 3223 
      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.3  
changed lines
  Added in v.1.30

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2