(file) Return to BuildAndReleaseOptions.html CVS log (file) (dir) Up to [Pegasus] / pegasus / doc

Diff for /pegasus/doc/BuildAndReleaseOptions.html between version 1.9 and 1.13.2.2

version 1.9, 2008/11/19 06:01:19 version 1.13.2.2, 2010/07/15 09:36:52
Line 639 
Line 639 
      to false), a build error will be generated.      to false), a build error will be generated.
 </ul> </ul>
  
 <h5>PEGASUS_ENABLE_ENCAPSULATED_XML</h5>  
 <ul>  
   <b>Description:&nbsp;</b>  
      This option enables the "encapsulated XML" feature. It is used in  
      conjunction with the "internal binary protocol" feature (see  
      PEGASUS_ENABLE_INTERNAL_BINARY_PROTOCOL). When enabled, the out-of-process  
      provider agent serializes CIM instances (contained in get-instance and  
      enumerate-instances responses) as XML (embedded in a binary message  
      envelope). This improves performance since the server may pass the  
      XML instaces through to the requesting client without deserializing them  
      from binary and then reserializing them as XML.  
      <br>  
   <b>Default Value:&nbsp;</b>false<br>  
   <b>Recommended Value (Development Build): </b>  
      No Specific Recommendation<br>  
   <b>Recommended Value (Release Build):&nbsp;</b>  
      No Specific Recommendation<br>  
   <b>Required:&nbsp;</b>No<br>  
   <b>Considerations:&nbsp;</b>This feature has no effect unless the "internal  
      binary protocol" feature is enabled (see  
      PEGASUS_ENABLE_INTERNAL_BINARY_PROTOCOL). Deciding whether to enable or  
      disable this feature is left to the user. Every environment is different  
      and some users may prefer lower bandwidth rather than higher performance.  
 </ul>  
   
 <h5>PEGASUS_ENABLE_EXECQUERY</h5> <h5>PEGASUS_ENABLE_EXECQUERY</h5>
 <ul> <ul>
   <b>Description:&nbsp;</b>When this environment variable is set,   <b>Description:&nbsp;</b>When this environment variable is set,
Line 755 
Line 730 
      indication provider.<br>      indication provider.<br>
 </ul> </ul>
  
 <h5>PEGASUS_ENABLE_INTERNAL_BINARY_PROTOCOL</h5>  <h5>PEGASUS_ENABLE_PROTOCOL_INTERNAL_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 the CIM server and provider manager. If false,      protocol between the CIM server and provider manager. If false,
Line 767 
Line 742 
   <b>Required: </b>No<br>   <b>Required: </b>No<br>
   <b>Considerations: </b>This option improves performance by optimizing the   <b>Considerations: </b>This option improves performance by optimizing the
      serialization and deserialization of messages between the server and      serialization and deserialization of messages between the server and
      out-of-process providers. The binary protocol also supports an optional       out-of-process providers.
      "encapsulated XML" feature (see PEGASUS_ENABLE_ENCAPSULATED_XML) for       <br>
      details.  </ul>
   
   <h5>PEGASUS_ENABLE_PROTOCOL_BINARY</h5>
   <ul>
     <b>Description: </b>If true, OpenPegasus uses a faster binary
        protocol between local clients (including the provider agent) and the
        CIM server. If false, OpenPegasus uses the conventional XML-based protocol
        instead. See PEP#340 for more details.
        <br>
     <b>Default Value: </b>false<br>
     <b>Recommended Value (Development Build): </b>false<br>
     <b>Recommended Value (Release Build): </b>false<br>
     <b>Required: </b>No<br>
     <b>Considerations: </b>This option improves performance by using a faster
        binary protocol between local clients and the CIM server.
      <br>      <br>
 </ul> </ul>
  
Line 1664 
Line 1653 
      the "Release Build" configuration options. By default,      the "Release Build" configuration options. By default,
      OpenPegasus is built using the &quot;Development Build"      OpenPegasus is built using the &quot;Development Build"
      configuration options.<br>      configuration options.<br>
   <b>Default Value:&nbsp;</b>Not Set<br>    <b>Default Value:&nbsp;</b>false<br>
   <b>Recommended Value (Development Build):&nbsp;</b>Not Set<br>    <b>Recommended Value (Development Build):&nbsp;</b>false<br>
   <b>Recommended Value (Release Build):&nbsp;</b>Set<br>    <b>Recommended Value (Release Build):&nbsp;</b>true<br>
   <b>Required:&nbsp;</b>No<br>   <b>Required:&nbsp;</b>No<br>
   <b>Considerations:&nbsp;</b>(1)The   <b>Considerations:&nbsp;</b>(1)The
      PEGASUS_USE_RELEASE_CONFIG_OPTIONS variable allows a platform      PEGASUS_USE_RELEASE_CONFIG_OPTIONS variable allows a platform
Line 2580 
Line 2569 
   <b>Recommended Default Value (Release Build):&nbsp;</b>0<br>   <b>Recommended Default Value (Release Build):&nbsp;</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):&nbsp;</b>No/No<br>   <b>Recommend To Be Fixed/Hidden (Release Build):&nbsp;</b>No/No<br>
     <b>Dynamic?:&nbsp;</b>Yes<br>
   <b>Considerations:&nbsp;</b>A client connection is considered   <b>Considerations:&nbsp;</b>A client connection is considered
      idle when it is not in the process of sending a request and      idle when it is not in the process of sending a request and
      the CIM Server is not processing a request from that connection.      the CIM Server is not processing a request from that connection.
Line 2592 
Line 2582 
      considered when configuring an idle connection timeout value.      considered when configuring an idle connection timeout value.
      The idle connection time is computed using the system clock.      The idle connection time is computed using the system clock.
      Thus, resetting the system clock may cause unexpected timeout      Thus, resetting the system clock may cause unexpected timeout
      behavior.<br>       behavior.This config property can be changed dynamically. The
        changes will apply to all new and existing connections. <br>
 </ul> </ul>
  
 <h5>logdir</h5> <h5>logdir</h5>
Line 2709 
Line 2700 
      $PROVIDERDIRS<br>      $PROVIDERDIRS<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>Yes<br>   <b>Recommend To Be Fixed/Hidden (Release Build):&nbsp;</b>Yes<br>
   <b>Dynamic?:&nbsp;</b>No<br>    <b>Dynamic?:&nbsp;</b>Yes<br>
   <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
Line 2901 
Line 2892 
      20 (seconds)<br>      20 (seconds)<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>Yes<br>
     <b>Considerations:&nbsp;</b>Any changes made to this config property
        dynamically will apply to new CIM Server connections only
        keeping old already established connections unchanged.<br>
   <b>Source Configuration File:&nbsp;</b>   <b>Source Configuration File:&nbsp;</b>
      Pegasus/Config/DefaultPropertyTable.h      Pegasus/Config/DefaultPropertyTable.h
 </ul> </ul>
Line 3039 
Line 3033 
 <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: &quot;File&quot;      messages. Valid values include: &quot;File&quot;
      and &quot;Log&quot;.<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 3051 
Line 3045 
      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
      &quot;Log&quot;, trace messages are written to the      &quot;Log&quot;, trace messages are written to the
      OpenPegasus Log.<br>       OpenPegasus Log. If you specify Memory, the trace messages
        are collected in a wrap-around memory buffer.
        If this memory is part of a dump the trace messages can be
        found by the eye-catcher &quot;PEGASUSMEMTRACE&quot; at
        the top of the memory buffer. The trace is in clear text and
        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 3086 
Line 3085 
      Pegasus/Config/TracePropertyOwner.cpp<br>      Pegasus/Config/TracePropertyOwner.cpp<br>
 </ul> </ul>
  
   <h5>traceMemoryBufferKbytes</h5>
   <ul>
     <b>Description:&nbsp;</b>Defines the size of the buffer for
       in memory tracing in kbytes ( 2<sup>10</sup> bytes ).
       Smallest value is 16.<br>
     <b>Default Value:&nbsp;</b>10240<br>
     <b>Recommended Default Value (Development Build): </b>10240<br>
     <b>Recommended Default Value (Release Build): </b>10240<br>
     <b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br>
     <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/No<br>
     <b>Dynamic?:&nbsp;</b>No<br>
     <b>Case Sensitive?:&nbsp;</b>No<br>
     <b>Considerations:&nbsp;</b>Is ignored if configuration
       property traceFacility is not set to Memory.<br>
     <b>Source Configuration File:&nbsp;</b>
        Pegasus/Config/TracePropertyOwner.cpp<br>
   </ul>
   
 <h3>Configuration Constants</h3> <h3>Configuration Constants</h3>
  
 <h4>Definitions</h4> <h4>Definitions</h4>
Line 3282 
Line 3299 
 </ul> </ul>
  
 <hr> <hr>
 <p><font size="2">  <p>Licensed to The Open Group (TOG) under one or more contributor license
 Copyright (c) 2004 EMC Corporation; Hewlett-Packard  Development  agreements.  Refer to the OpenPegasusNOTICE.txt file distributed with
 Company, L.P.; IBM Corp.; The Open Group; VERITAS Software Corporation<br>  this work for additional information regarding copyright ownership.
 Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;  Each contributor licenses this file to you under the OpenPegasus Open
 EMC Corporation; Symantec Corporation; The Open Group.<br>  Source License; you may not use this file except in compliance with the
 <br>  License.</p>
 Permission is hereby granted, free of charge, to any person  <p>Permission is hereby granted, free of charge, to any person obtaining a
 obtaining a copy&nbsp; of this software and associated documentation files  copy of this software and associated documentation files (the "Software"),
 (the &quot;Software&quot;), to deal in the Software without restriction,  to deal in the Software without restriction, including without limitation
 including without limitation the rights to use, copy,  the rights to use, copy, modify, merge, publish, distribute, sublicense,
 modify, merge, publish, distribute, sublicense, and/or sell copies  and/or sell copies of the Software, and to permit persons to whom the
 of the Software, and to permit persons to whom the Software is  Software is furnished to do so, subject to the following conditions:</p>
 furnished to do so, subject to the following conditions:  <p>The above copyright notice and this permission notice shall be included
 <br><br>  in all copies or substantial portions of the Software.</p>
 THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED  <p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 IN ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE  OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 SOFTWARE IS PROVIDED&nbsp; &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND  CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS  TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p>
 ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN  
 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE  
 SOFTWARE.  
 </font></p>  
   
 <hr> <hr>
 <p>Template last modified: January 20th 2004 by Martin Kirk<br>Template version: 1.6</p>  
   
 </body> </body>
 </html> </html>

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