|
version 1.2, 2008/09/16 18:27:46
|
version 1.13.2.1, 2009/05/05 12:53:08
|
|
|
|
| for additional details.<br> | for additional details.<br> |
| </ul> | </ul> |
| | |
| <h5>PEGASUS_EMBEDDED_INSTANCE_SUPPORT</h5> |
|
| <ul> |
|
| <b>Description: </b>Controls whether the server is built with |
|
| support for the EmbeddedInstance value type for properties and |
|
| paramters.<br> |
|
| <b>Default Value: </b>true<br> |
|
| <b>Recommended Value (Development Build): </b>true<br> |
|
| <b>Recommended Value (Release Build): </b>true<br> |
|
| <b>Required: </b>No<br> |
|
| <b>Considerations: </b>Setting this build variable to 'false' may |
|
| adversely affect interoperability with WBEM clients/servers that |
|
| make use of EmbeddedInstance values.<br> |
|
| </ul> |
|
| |
|
| <h5>PEGASUS_ENABLE_AUDIT_LOGGER</h5> | <h5>PEGASUS_ENABLE_AUDIT_LOGGER</h5> |
| <ul> | <ul> |
| <b>Description: </b>When this variable is set to false, support | <b>Description: </b>When this variable is set to false, support |
|
|
|
| indication provider.<br> | indication provider.<br> |
| </ul> | </ul> |
| | |
| |
<h5>PEGASUS_ENABLE_PROTOCOL_INTERNAL_BINARY</h5> |
| |
<ul> |
| |
<b>Description: </b>If true, OpenPegasus uses a faster binary |
| |
protocol between the CIM server and provider manager. If false, |
| |
OpenPegasus uses the older XML-based protocol instead. |
| |
<br> |
| |
<b>Default Value: </b>true<br> |
| |
<b>Recommended Value (Development Build): </b>true<br> |
| |
<b>Recommended Value (Release Build): </b>true<br> |
| |
<b>Required: </b>No<br> |
| |
<b>Considerations: </b>This option improves performance by optimizing the |
| |
serialization and deserialization of messages between the server and |
| |
out-of-process providers. |
| |
<br> |
| |
</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> |
| |
</ul> |
| |
|
| <h5>PEGASUS_ENABLE_INTEROP_PROVIDER</h5> | <h5>PEGASUS_ENABLE_INTEROP_PROVIDER</h5> |
| <ul> | <ul> |
| <b>Description: </b>If true, the OpenPegasus Interop Provider | <b>Description: </b>If true, the OpenPegasus Interop Provider |
|
|
|
| <ul> | <ul> |
| <b>Description: </b>If true, a version of OpenPegasus is | <b>Description: </b>If true, a version of OpenPegasus is |
| built that accepts and processes WS-Management requests. This | built that accepts and processes WS-Management requests. This |
| feature is initially limited to WS-Transfer operations. If false |
feature is initially limited to WS-Transfer and WS-Enumeration |
| or not set, WS-Management support is not built or included in |
operations. If false or not set, WS-Management support is not |
| any way.<br> |
built or included in any way.<br> |
| <b>Default Value: </b>false<br> | <b>Default Value: </b>false<br> |
| <b>Recommended Value (Development Build): </b>true<br> | <b>Recommended Value (Development Build): </b>true<br> |
| <b>Recommended Value (Release Build): </b>false<br> | <b>Recommended Value (Release Build): </b>false<br> |
|
|
|
| titled "Configuration Properties" for additional detail.<br> | titled "Configuration Properties" for additional detail.<br> |
| </ul> | </ul> |
| | |
| |
<h5>PEGASUS_USE_SQLITE_REPOSITORY</h5> |
| |
<ul> |
| |
<b>Description: </b>If true, new repository stores are created |
| |
using a SQLite database. Existing file-based stores will continue |
| |
to be recognized and operate seamlessly.<br> |
| |
<b>Default Value: </b>false<br> |
| |
<b>Recommended Value (Development Build): </b>true<br> |
| |
<b>Recommended Value (Release Build): </b>true<br> |
| |
<b>Required: </b>No<br> |
| |
<b>Considerations: </b>If PEGASUS_USE_SQLITE_REPOSITORY is set to true |
| |
and SQLite files are not installed in default search locations, |
| |
SQLITE_HOME must also be configured. |
| |
PEGASUS_REPOSITORY_STORE_COMPLETE_CLASSES may not be set to true when |
| |
PEGASUS_USE_SQLITE_REPOSITORY is set to true. |
| |
</ul> |
| |
|
| <h5>PEGASUS_USE_SYSLOGS</h5> | <h5>PEGASUS_USE_SYSLOGS</h5> |
| <ul> | <ul> |
| <b>Description: </b>If set, OpenPegasus will be built | <b>Description: </b>If set, OpenPegasus will be built |
|
|
|
| compiler version < 1300.<br> | compiler version < 1300.<br> |
| </ul> | </ul> |
| | |
| |
<h5>SQLITE_HOME</h5> |
| |
<ul> |
| |
<b>Description: </b>Specifies the location of the SQLite SDK directory. |
| |
This directory must contain sqlite3.h in the $(SQLITE_HOME)/include |
| |
directory, and libsqlite3 in the $(SQLITE_HOME)/lib directory.<br> |
| |
<b>Default Value: </b>Not Set<br> |
| |
<b>Recommended Value (Development Build): </b> |
| |
No Specific Recommendation<br> |
| |
<b>Recommended Value (Release Build): </b> |
| |
No Specific Recommendation<br> |
| |
<b>Required: </b>Yes, if PEGASUS_USE_SQLITE_REPOSITORY is set to true |
| |
and the SQLite files are not installed in locations that are searched by |
| |
default.<br> |
| |
<b>Considerations: </b>This environment variable is only used if |
| |
PEGASUS_USE_SQLITE_REPOSITORY is set to true. |
| |
</ul> |
| |
|
| <h4>Examples Building a Linux IA32 (#IA64) Development/Debug Version</h4> | <h4>Examples Building a Linux IA32 (#IA64) Development/Debug Version</h4> |
| <ul> | <ul> |
| export PEGASUS_ROOT=/home/pegasusbld/pegasus<br> | export PEGASUS_ROOT=/home/pegasusbld/pegasus<br> |
|
|
|
| <b>Recommended Default Value (Release Build): </b>false<br> | <b>Recommended Default Value (Release Build): </b>false<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): </b>No/No<br> | <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/No<br> |
| <b>Dynamic?: </b>No<br> |
<b>Dynamic?: </b>Yes<br> |
| <b>Considerations: </b> | <b>Considerations: </b> |
| <ul> | <ul> |
| <li>Any errors encountered during normalization result in a | <li>Any errors encountered during normalization result in a |
|
|
|
| <b>Recommended Default Value (Release Build): </b>0<br> | <b>Recommended Default Value (Release Build): </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): </b>No/No<br> | <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/No<br> |
| |
<b>Dynamic?: </b>Yes<br> |
| <b>Considerations: </b>A client connection is considered | <b>Considerations: </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. |
|
|
|
| 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> |
|
|
|
| Pegsus/Config/LogPropertyOwner.cpp<p> </p> | Pegsus/Config/LogPropertyOwner.cpp<p> </p> |
| </ul> | </ul> |
| | |
| |
<h5>maxLogFileSizeKBytes</h5> |
| |
<ul> |
| |
<b>Description: </b>Specifies the maximum size of the logfile in Kilo |
| |
Bytes. If the logfile size exceeds maxLogFileSizeKBytes logfile will be pruned.<br> |
| |
<b>Default Value: </b>32768<br> |
| |
<b>Recommended Default Value (Development Build): </b> 32768<br> |
| |
<b>Recommended Default Value (Release Build): </b>32768<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?:</b> Yes<br> |
| |
<b>Considerations:</b> This option is not supported if PEGASUS_USE_SYSLOGS is defined. Minimum accepted value is 32 KB. <br> |
| |
<b>Source Configuration File:</b> Pegsus/Config/LogPropertyOwner.cpp<p> </p> |
| |
</ul> |
| <h5>maxProviderProcesses</h5> | <h5>maxProviderProcesses</h5> |
| <ul> | <ul> |
| <b>Description:</b> Limits the number of provider | <b>Description:</b> Limits the number of provider |
|
|
|
| <b>Recommended Default Value (Release Build):</b> 0<br> | <b>Recommended Default Value (Release Build):</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): </b>No/Yes<br> | <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/Yes<br> |
| <b>Dynamic?: </b>No<br> |
<b>Dynamic?: </b>Yes<br> |
| <b>Considerations: </b><br> |
<b>Considerations: </b>Consider there are five provider processes |
| |
already running and the maxProviderProcesses is dynamically changed to |
| |
four. In this case though new provider processes will not be created |
| |
but existing five will continue running<br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" | <table border="1" cellspacing="1" bordercolordark="#666666" |
| bordercolorlight="#CCCCCC" width=531 | bordercolorlight="#CCCCCC" width=531 |
|
|
|
| $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): </b>Yes<br> | <b>Recommend To Be Fixed/Hidden (Release Build): </b>Yes<br> |
| <b>Dynamic?: </b>No<br> |
<b>Dynamic?: </b>Yes<br> |
| <b>Considerations: </b>The CIM Server runs as a privileged | <b>Considerations: </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 |
|
|
|
| 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): </b>No/No<br> | <b>Recommend To Be Fixed/Hidden (Release Build): </b>No/No<br> |
| <b>Dynamic?: </b>No<br> |
<b>Dynamic?: </b>Yes<br> |
| |
<b>Considerations: </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: </b> | <b>Source Configuration File: </b> |
| Pegasus/Config/DefaultPropertyTable.h | Pegasus/Config/DefaultPropertyTable.h |
| </ul> | </ul> |
|
|
|
| <ul> | <ul> |
| <b>Description: </b>Defines the desired facility for trace | <b>Description: </b>Defines the desired facility for trace |
| messages. Valid values include: "File" | messages. Valid values include: "File" |
| and "Log".<br> |
, "Log" and "Memory" .<br> |
| <b>Default Value: </b>File<br> | <b>Default Value: </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> |
|
|
|
| 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 |
| "Log", trace messages are written to the | "Log", 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 "PEGASUSMEMTRACE" at |
| |
the top of the memory buffer. The trace is in clear text and |
| |
the last written message has the suffix "EOTRACE".<br> |
| <b>Source Configuration File: </b> | <b>Source Configuration File: </b> |
| Pegasus/Config/TracePropertyOwner.cpp<br> | Pegasus/Config/TracePropertyOwner.cpp<br> |
| </ul> | </ul> |
|
|
|
| Pegasus/Config/TracePropertyOwner.cpp<br> | Pegasus/Config/TracePropertyOwner.cpp<br> |
| </ul> | </ul> |
| | |
| |
<h5>traceMemoryBufferKbytes</h5> |
| |
<ul> |
| |
<b>Description: </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: </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?: </b>No<br> |
| |
<b>Case Sensitive?: </b>No<br> |
| |
<b>Considerations: </b>Is ignored if configuration |
| |
property traceFacility is not set to Memory.<br> |
| |
<b>Source Configuration File: </b> |
| |
Pegasus/Config/TracePropertyOwner.cpp<br> |
| |
</ul> |
| |
|
| <h3>Configuration Constants</h3> | <h3>Configuration Constants</h3> |
| | |
| <h4>Definitions</h4> | <h4>Definitions</h4> |
|
|
|
| </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 of this software and associated documentation files |
copy of this software and associated documentation files (the "Software"), |
| (the "Software"), 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 "AS IS", 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> |
Return to
BuildAndReleaseOptions.html
CVS log
Up to [Pegasus] / pegasus / doc