version 1.1.2.1, 2008/09/09 18:45:03
|
version 1.12, 2008/12/16 18:55:36
|
|
|
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 |
|
|
<b>Required: </b>No<p> </p> | <b>Required: </b>No<p> </p> |
</ul> | </ul> |
| |
|
<h5>PEGASUS_REPOSITORY_STORE_COMPLETE_CLASSES</h5> |
|
<ul> |
|
<b>Description: </b>This variable defines the default contents of a |
|
class definition in the repository store when a new repository is created. |
|
Specifically, when set to true, propagated elements are included in a |
|
class definition in the persistent store. The contents of a class |
|
definition returned from the repository interface is not affected by this |
|
option.<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<p> </p> |
|
<b>Considerations: </b>A repository which stores complete class |
|
definitions does not allow modifications to non-leaf classes or changes |
|
to a superclass designation. Complete classes use more storage space, |
|
often twice as much as local (incomplete) classes. Class retrieval may |
|
be more expensive when local classes are stored. No specific mechanism |
|
is available to change this setting in an existing repository.<br> |
|
</ul> |
|
|
<h5>PEGASUS_SLP_REG_TIMEOUT</h5> | <h5>PEGASUS_SLP_REG_TIMEOUT</h5> |
<ul> | <ul> |
<b>Description: </b>Most SLP implementations allow a lifetime | <b>Description: </b>Most SLP implementations allow a lifetime |
|
|
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> |