version 1.3, 2008/09/19 13:48:34
|
version 1.13.2.2, 2010/07/15 09:36: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> |
|
|
the "Release Build" configuration options. By default, | the "Release Build" configuration options. By default, |
OpenPegasus is built using the "Development Build" | OpenPegasus is built using the "Development Build" |
configuration options.<br> | configuration options.<br> |
<b>Default Value: </b>Not Set<br> |
<b>Default Value: </b>false<br> |
<b>Recommended Value (Development Build): </b>Not Set<br> |
<b>Recommended Value (Development Build): </b>false<br> |
<b>Recommended Value (Release Build): </b>Set<br> |
<b>Recommended Value (Release Build): </b>true<br> |
<b>Required: </b>No<br> | <b>Required: </b>No<br> |
<b>Considerations: </b>(1)The | <b>Considerations: </b>(1)The |
PEGASUS_USE_RELEASE_CONFIG_OPTIONS variable allows a platform | PEGASUS_USE_RELEASE_CONFIG_OPTIONS variable allows a platform |
|
|
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> |
|
|
<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> |