version 1.1, 2008/09/05 01:23:15
|
version 1.13, 2008/12/18 16:41:52
|
|
|
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> |
|
|
<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> |
|
|
</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> |