version 1.32, 2012/05/14 09:12:11
|
version 1.40, 2013/05/02 09:31:00
|
|
|
additional details. | additional details. |
</ul> | </ul> |
| |
<h5>ICU_NO_UPPERCASE_ROOT</h5> |
|
<ul> |
|
<b>Description: </b>If set, the messages in the root resource |
|
bundle will NOT be capitalized. By default, the root resource |
|
bundle is capitalized.<br> |
|
<b>Default Value: </b>Not Set<br> |
|
<b>Recommended Value (Development Build): </b>Not Set<br> |
|
<b>Recommended Value (Release Build): </b>Not Set<br> |
|
<b>Required: </b>No<br> |
|
<b>Considerations: </b>This environment variable is only used |
|
if PEGASUS_HAS_MESSAGES is set. Refer to PEGASUS_HAS_MESSAGES for |
|
additional details. |
|
</ul> |
|
|
|
<h5>ICU_ROOT_BUNDLE_LANG</h5> | <h5>ICU_ROOT_BUNDLE_LANG</h5> |
<ul> | <ul> |
<b>Description: </b>If set, specifies the language | <b>Description: </b>If set, specifies the language |
|
|
must exist in the $(PEGASUS_ROOT)/Schemas directory) that will be used | must exist in the $(PEGASUS_ROOT)/Schemas directory) that will be used |
to build the class repository for testing the pegasus environment | to build the class repository for testing the pegasus environment |
("make repository", etc.).<br> | ("make repository", etc.).<br> |
<b>Default Value: </b>CIM231 (Note that this may change as newer versions of the CIM Schema are used as the default.<br> |
<b>Default Value: </b>CIM236 (Note that this may change as newer versions of the CIM Schema are used as the default.<br> |
<b>Recommended Value (Development Build): </b> | <b>Recommended Value (Development Build): </b> |
No Specific Recommendation<br> | No Specific Recommendation<br> |
<b>Recommended Value (Release Build): </b> | <b>Recommended Value (Release Build): </b> |
|
|
2.3.2 on Linux" for additional details.<br> | 2.3.2 on Linux" for additional details.<br> |
</ul> | </ul> |
| |
<h5>PEGASUS_INDICATIONS_Q_THRESHOLD</h5> |
|
<ul> |
|
<b>Description: </b>Controls if indications providers are stalled |
|
if the indications service queue is too large. It can be set |
|
to any positive value. If not set providers are never |
|
stalled. This implies that the indications service |
|
queue may become as large as necessary to hold all the |
|
indications generated. If set to any value then |
|
providers are stalled by forcing them to sleep when they |
|
try to deliver an indication and the indications service |
|
queue exceeds this value. They are resumed when the queue |
|
count falls 10 percent below this value. Stall and resume log |
|
entries are made to inform the administrator the condition has |
|
occurred.<br> |
|
<b>Default Value: </b>Not Set<br> |
|
<b>Recommended Value (Development Build): </b>Not Set<br> |
|
<b>Recommended Value (Release Build): </b>Not Set<br> |
|
<b>Required: </b>No<br> |
|
<b>Considerations: </b>Use of this setting may have |
|
unintended side-effects when using Out-of-Process Providers |
|
including delayed processing of CIM Operation Requests. |
|
</ul> |
|
|
|
<h5>PEGASUS_MAX_THREADS_PER_SVC_QUEUE</h5> | <h5>PEGASUS_MAX_THREADS_PER_SVC_QUEUE</h5> |
<ul> | <ul> |
<b>Description: </b>Controls the maximum number of threads | <b>Description: </b>Controls the maximum number of threads |
|
|
<h5>PEGASUS_NOASSERTS</h5> | <h5>PEGASUS_NOASSERTS</h5> |
<ul> | <ul> |
<b>Description: </b>Defines the NDEBUG compilation macro, which | <b>Description: </b>Defines the NDEBUG compilation macro, which |
causes the preprocessor to remove PEGASUS_ASSERT() statements.<br> |
causes the preprocessor to remove PEGASUS_ASSERT() and disables assertion |
|
on PEGASUS_FCT_EXECUTE_AND_ASSERT statements.<br> |
<b>Default Value: </b>Not Set<br> | <b>Default Value: </b>Not Set<br> |
<b>Recommended Value (Development Build): </b>Not Set<br> | <b>Recommended Value (Development Build): </b>Not Set<br> |
<b>Recommended Value (Release Build): </b>Set<br> | <b>Recommended Value (Release Build): </b>Set<br> |
|
|
</tbody></table> | </tbody></table> |
</p></ul> | </p></ul> |
| |
|
<h5>hostname</h5> |
|
<ul> |
|
<b>Description: </b> Can be used to override the local system supplied |
|
hostname without domain the CIM Server is using to build objects. |
|
If not set, querying this configuration option will report |
|
the system supplied hostname and behavior is not changed.<br> |
|
Setting this value to a valid hostname on CIM Server startup or as |
|
planned value will force the server to assume the configured name as the |
|
local hosts name. Setting this allows the administrator to set the name |
|
that operations such as associator, reference etc. return with |
|
object paths.<br> |
|
In common setups it is not recommended to explicitly set this value. |
|
<br> |
|
<b>Usage scenarios: </b> The following scenarios in which changing the |
|
default value makes sense are known today:<br> |
|
1. The case where what the CIM Server shall return to clients for |
|
host name is NOT the name of the current host but some |
|
administrator defined name |
|
(ex. system behind a firewall or some redirector).<br> |
|
2. Embedded systems that have a system set hostname which is not |
|
valid and needs to be overridden by CIM administrator without |
|
changing the actual IP configuration. |
|
<br> |
|
<b>Recommended Default Value (Development Build): </b> |
|
blank<br> |
|
<b>Recommended Default Value (Release Build): </b> |
|
blank<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>Considerations: </b> When setting this configuration option the option |
|
fullyQualifiedHostName should be adjusted too.<br> |
|
Providers returning the systems hostname in an |
|
instance property might return a different value then the CIM server is |
|
setting in the object path. hostnames explicitly set into the object |
|
paths by providers will not be overridden by the CIM Server to allow |
|
cross-namespace associations. |
|
<br> |
|
It is necessary to upgrade existing repositories using the repupgrade |
|
utility when upgrading from an OpenPegasus version less than 2.12. |
|
<br> |
|
<b>Source Configuration File: </b> |
|
Pegasus/Config/DefaultPropertyOwner.cpp |
|
</ul> |
|
|
|
<h5>fullyQualifiedHostName</h5> |
|
<ul> |
|
<b>Description: </b> Can be used to override the local system supplied |
|
fully qualified hostname (with domain) the CIM Server is using to build |
|
objects. |
|
If not set, querying this configuration option will report |
|
the system supplied fully qualified hostname and behavior is |
|
not changed.<br> |
|
Setting this value to a valid hostname on CIM Server startup or as |
|
planned value will force the server to assume the configured name as the |
|
local hosts name with domain. Setting this allows the administrator to |
|
set the name that indication operations and the CIM_ObjectManager |
|
assume for SystemName returned as instance and key properties.<br> |
|
In common setups it is not recommended to explicitly set this value. |
|
<br> |
|
<b>Usage scenarios: </b> The following scenarios in which changing the |
|
default value makes sense are known today:<br> |
|
1. The case where what the CIM Server shall return to clients for |
|
SystemName is NOT the name of the current host but some |
|
administrator defined name |
|
(ex. system behind a firewall or some redirector).<br> |
|
2. Embedded systems that have a system set hostname which is not |
|
valid and needs to be overridden by CIM administrator without |
|
changing the actual IP configuration. |
|
<br> |
|
<b>Recommended Default Value (Development Build): </b> |
|
blank<br> |
|
<b>Recommended Default Value (Release Build): </b> |
|
blank<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>Considerations: </b> When setting this configuration option the option |
|
fullyQualifiedHostName should be adjusted too.<br> |
|
Providers returning the systems hostname in an |
|
instance property might return a different value then the CIM server is |
|
setting in SystemName. |
|
<br> |
|
It is necessary to upgrade existing repositories using the repupgrade |
|
utility when upgrading from an OpenPegasus version less than 2.12. |
|
<br> |
|
<b>Source Configuration File: </b> |
|
Pegasus/Config/DefaultPropertyOwner.cpp |
|
</ul> |
|
|
<h5>httpPort</h5> | <h5>httpPort</h5> |
<ul> | <ul> |
<b>Description: </b>OpenPegasus first attempts to look up the | <b>Description: </b>OpenPegasus first attempts to look up the |
|
|
Pegasus/Config/IndicationServicePropertyOwner.cpp<br> | Pegasus/Config/IndicationServicePropertyOwner.cpp<br> |
</ul> | </ul> |
| |
|
<h5>listenAddress</h5> |
|
<ul> |
|
<b>Description: </b> Network interface where the cimserver |
|
should listen to for connections.For example listenAddress=All or |
|
listenAddress=121.12.33.112 or listenAddress=121.33.21.26,127.0.0.1, |
|
fe80::fe62:9346%eth0<br> |
|
<b>Recommended Default Value (Development Build): </b>All<br> |
|
<b>Recommended Default Value (Release Build): </b>No Specific suggestion<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>Considerations: </b>Default value of "All" will make cimserver to listen on all the network interfaces.<br> |
|
<b>Source Configuration File: </b> |
|
Pegasus/Config/DefaultPropertyOwner.cpp<br> |
|
</ul> |
|
|
<h5>logdir</h5> | <h5>logdir</h5> |
<ul> | <ul> |
<b>Description: </b>Specifies the name of the directory | <b>Description: </b>Specifies the name of the directory |
|
|
system. Allowing a registered Provider’s executable to be | system. Allowing a registered Provider’s executable to be |
replaced with malicious code would result in a critical | replaced with malicious code would result in a critical |
security defect, giving a malicious user privileged access | security defect, giving a malicious user privileged access |
to the system. Adminstrators are responsible for ensuring |
to the system. Administrators are responsible for ensuring |
that only trusted Providers are loaded into providerDir. | that only trusted Providers are loaded into providerDir. |
In order to simplify the management task associated with | In order to simplify the management task associated with |
securing Provider executable, the value of providerDir can be | securing Provider executable, the value of providerDir can be |
|
|
</tbody></table> | </tbody></table> |
</p></ul> | </p></ul> |
| |
|
<h5>slpProviderStartupTimeout</h5> |
|
<ul> |
|
<b>Description: </b>Timeout value in milli seconds used to specify |
|
how long the registration with an SLP SA may take. Registration will be |
|
retried three times. This value only needs to be increased in case that |
|
the loading of a set of providers who reporting their implementation of a |
|
registered profile takes very long.<br> |
|
<b>Default Value: </b>300000<br> |
|
<b>Recommended Default Value (Development Build): </b>300000<br> |
|
<b>Recommended Default Value (Release Build): </b>300000<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<p> <br> |
|
<br> |
|
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" height="80" width="531"> |
|
<tbody><tr> |
|
<th bgcolor="#cae6ca" height="16" width="168">Platform</th> |
|
<th bgcolor="#cae6ca" height="16" width="350"> |
|
Source Configuration File</th> |
|
</tr> |
|
<tr align="center"> |
|
<td height="14" width="168">Linux</td> |
|
<td align="left" height="14" width="350"> |
|
Pegasus/Config/DefaultPropertyTable.h</td> |
|
</tr> |
|
<tr align="center"> |
|
<td height="14" width="168">HP-UX</td> |
|
<td align="left" height="14" width="350"> |
|
Pegasus/Config/DefaultPropertyTable.h</td> |
|
</tr> |
|
<tr align="center"> |
|
<td height="16" width="168">OpenVMS</td> |
|
<td align="left" height="16" width="350"> |
|
Pegasus/Config/DefaultPropertyTable.h</td> |
|
</tr> |
|
</tbody></table> |
|
</p></ul> |
|
|
<h5>socketWriteTimeout</h5> | <h5>socketWriteTimeout</h5> |
<ul> | <ul> |
<b>Description: </b>If the CIM Server receives an | <b>Description: </b>If the CIM Server receives an |
|
|
Pegasus/Config/TracePropertyOwner.cpp<br> | Pegasus/Config/TracePropertyOwner.cpp<br> |
</ul> | </ul> |
| |
|
<h5>traceFileSizeKBytes</h5> |
|
<ul> |
|
<b>Description: </b>Defines the size of the tracefile in Kilo bytes. The trace file will be |
|
rolled once its size exceeds the specified size. <br> |
|
<b>Default Value: </b>1048576<br> |
|
<b>Recommended Default Value (Development Build): </b>1048576<br> |
|
<b>Recommended Default Value (Release Build): </b>1048576<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>Dynamic?:</b> Yes<br> |
|
<b>Considerations:</b>Minimum accepted value is 10240 KB,Maximum accepted value is 2097152 KB. <br> |
|
<b>Source Configuration File:</b> Pegsus/Config/TracePropertyOwner.cpp<p> </p> |
|
</ul> |
|
|
|
<h5>numberOfTraceFiles</h5> |
|
<ul> |
|
<b>Description: </b>Specifies the number of the tracefiles for rolling.<br> |
|
<b>Default Value: </b>3<br> |
|
<b>Recommended Default Value (Development Build): </b>3<br> |
|
<b>Recommended Default Value (Release Build): </b>3<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>Dynamic?:</b> Yes<br> |
|
<b>Considerations:</b>Minimum accepted value is 3,Maximum accepted value is 20. <br> |
|
<b>Source Configuration File:</b> Pegsus/Config/TracePropertyOwner.cpp<p> </p> |
|
</ul> |
|
|
<h3>Configuration Constants</h3> | <h3>Configuration Constants</h3> |
| |
<h4>Definitions</h4> | <h4>Definitions</h4> |