(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.2 and 1.24.2.3

version 1.24.2.2, 2012/02/15 17:47:00 version 1.24.2.3, 2013/06/03 22:34:46
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 170 
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 288 
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>CIM231 (Note that this may change as newer versions of the CIM Schema are used as the default.<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>
Line 783 
Line 773 
      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 1092 
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 1197 
Line 1179 
 <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() statements.<br>       causes the preprocessor to remove PEGASUS_ASSERT() and disables assertion
        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 1234 
Line 1217 
      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 2494 
Line 2497 
        </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 2690 
Line 2783 
      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 2809 
Line 2918 
      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. Adminstrators are responsible for ensuring       to the system. Administrators 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 2979 
Line 3088 
        </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 3223 
Line 3370 
      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.2  
changed lines
  Added in v.1.24.2.3

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2