pegasus/doc/BuildAndReleaseOptions.html - diff

Return to BuildAndReleaseOptions.html CVS log

Up to [Pegasus] / pegasus / doc

Diff for /pegasus/doc/BuildAndReleaseOptions.html between version 1.1 and 1.8

version 1.1, 2008/09/05 01:23:15

version 1.8, 2008/11/12 17:22:30

Line 556

for additional details.

</ul>

<h5>PEGASUS_EMBEDDED_INSTANCE_SUPPORT</h5>

<ul>

Description: Controls whether the server is built with

support for the EmbeddedInstance value type for properties and

paramters.

Default Value: true

Recommended Value (Development Build): true

Recommended Value (Release Build): true

Required: No

Considerations: Setting this build variable to 'false' may

adversely affect interoperability with WBEM clients/servers that

make use of EmbeddedInstance values.

</ul>

<h5>PEGASUS_ENABLE_AUDIT_LOGGER</h5>

<ul>

Description: When this variable is set to false, support

Line 653

Line 639

to false), a build error will be generated.

</ul>

<h5>PEGASUS_ENABLE_ENCAPSULATED_XML</h5>

<ul>

Description:

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.

Default Value: false

Recommended Value (Development Build):

No Specific Recommendation

Recommended Value (Release Build):

No Specific Recommendation

Required: No

Considerations: 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>

<ul>

Description: When this environment variable is set,

Line 744

Line 755

indication provider.

</ul>

<h5>PEGASUS_ENABLE_INTERNAL_BINARY_PROTOCOL</h5>

<ul>

Description: 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.

Default Value: true

Recommended Value (Development Build): true

Recommended Value (Release Build): true

Required: No

Considerations: 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.

</ul>

<h5>PEGASUS_ENABLE_INTEROP_PROVIDER</h5>

<ul>

Description: If true, the OpenPegasus Interop Provider

Line 833

Line 862

<ul>

Description: If true, a version of OpenPegasus is

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.

built or included in any way.

Default Value: false

Recommended Value (Development Build): true

Recommended Value (Release Build): false

Line 1317

Line 1346

Required: No

</ul>

<h5>PEGASUS_REPOSITORY_STORE_COMPLETE_CLASSES</h5>

<ul>

Description: 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.

Default Value: false

Recommended Value (Development Build): false

Recommended Value (Release Build): false

Required: No

Considerations: 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.

</ul>

<h5>PEGASUS_SLP_REG_TIMEOUT</h5>

<ul>

Description: Most SLP implementations allow a lifetime

Line 1652

Line 1701

titled "Configuration Properties" for additional detail.

</ul>

<h5>PEGASUS_USE_SQLITE_REPOSITORY</h5>

<ul>

Description: If true, new repository stores are created

using a SQLite database. Existing file-based stores will continue

to be recognized and operate seamlessly.

Default Value: false

Recommended Value (Development Build): true

Recommended Value (Release Build): true

Required: No

Considerations: 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>

<ul>

Description: If set, OpenPegasus will be built

Line 1682

Line 1747

compiler version < 1300.

</ul>

<h5>SQLITE_HOME</h5>

<ul>

Description: 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.

Default Value: Not Set

Recommended Value (Development Build):

No Specific Recommendation

Recommended Value (Release Build):

No Specific Recommendation

Required: Yes, if PEGASUS_USE_SQLITE_REPOSITORY is set to true

and the SQLite files are not installed in locations that are searched by

default.

Considerations: 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>

<ul>

export PEGASUS_ROOT=/home/pegasusbld/pegasus

Line 2154

Line 2236

Recommended Default Value (Release Build): false

Recommend To Be Fixed/Hidden (Development Build): No/No

Recommend To Be Fixed/Hidden (Release Build): No/No

Dynamic?: No

Dynamic?: Yes

Considerations:

<ul>

<li>Any errors encountered during normalization result in a

Line 2545

Line 2627

Pegsus/Config/LogPropertyOwner.cpp

</ul>

<h5>maxLogFileSizeKBytes</h5>

<ul>

Description: Specifies the maximum size of the logfile in Kilo

Bytes. If the logfile size exceeds maxLogFileSizeKBytes logfile will be pruned.

Default Value: 32768

Recommended Default Value (Development Build):  32768

Recommended Default Value (Release Build): 32768

Recommend To Be Fixed/Hidden (Development Build): No/No

Recommend To Be Fixed/Hidden (Release Build): No/No

Dynamic?: Yes

Considerations: This option is not supported if PEGASUS_USE_SYSLOGS is defined. Minimum accepted value is 32 KB.

Source Configuration File:  Pegsus/Config/LogPropertyOwner.cpp

</ul>

<h5>maxProviderProcesses</h5>

<ul>

Description: Limits the number of provider

Legend:

Removed from v.1.1
changed lines
	Added in v.1.8

No CVS admin address has been configured