version 1.1.2.1, 2008/09/09 18:45:03
|
version 1.8, 2008/11/12 17:22:30
|
|
|
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 |
|
|
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: </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: </b>false<br> |
|
<b>Recommended Value (Development Build): </b> |
|
No Specific Recommendation<br> |
|
<b>Recommended Value (Release Build): </b> |
|
No Specific Recommendation<br> |
|
<b>Required: </b>No<br> |
|
<b>Considerations: </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: </b>When this environment variable is set, | <b>Description: </b>When this environment variable is set, |
|
|
indication provider.<br> | indication provider.<br> |
</ul> | </ul> |
| |
|
<h5>PEGASUS_ENABLE_INTERNAL_BINARY_PROTOCOL</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. The binary protocol also supports an optional |
|
"encapsulated XML" feature (see PEGASUS_ENABLE_ENCAPSULATED_XML) for |
|
details. |
|
<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 |
|
|
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 |