|
version 1.1, 2008/09/05 01:23:15
|
version 1.36, 2012/11/29 09:59:21
|
|
|
|
| <html> |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <head> |
<html><head> |
| <link rel="stylesheet" href= |
|
| "http://www.opengroup.org/stylesheets/info1.css"> |
|
| </head> |
|
| | |
| <body> |
<link rel="stylesheet" href="http://www.opengroup.org/stylesheets/info1.css"></head><body> |
| <hr> | <hr> |
| | |
| <p align="center"> | <p align="center"> |
|
|
|
| testing and running OpenPegasus on a selected set of | testing and running OpenPegasus on a selected set of |
| platforms. In this version of the document, platform-specific configuration | platforms. In this version of the document, platform-specific configuration |
| information have been documented for the platforms described in the | information have been documented for the platforms described in the |
| "Documented Platforms" section of this document. |
"Documented Platforms" section of this document. |
| </p> | </p> |
| | |
| <p><b>Note 1: </b> | <p><b>Note 1: </b> |
| The recommendations defined in this document are not intended to document | The recommendations defined in this document are not intended to document |
| the feature set included in any vendor's OpenPegasus-based product. | the feature set included in any vendor's OpenPegasus-based product. |
| Rather, the purpose of this document is to provide input to vendors when | Rather, the purpose of this document is to provide input to vendors when |
| making product decisions.<BR> |
making product decisions.<br> |
| </p> | </p> |
| | |
| <hr> | <hr> |
|
|
|
| additional information.</p> | additional information.</p> |
| | |
| <ul> | <ul> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" border="1" cellspacing="1" width="20%"> |
| bordercolorlight="#CCCCCC" width=20%> |
<tbody><tr> |
| <tr> |
<th align="center" bgcolor="#cae6ca">Platform</th> |
| <th bgcolor="#CAE6CA" align=center>Platform</th> |
<th align="center" bgcolor="#cae6ca">Status</th> |
| <th bgcolor="#CAE6CA" align=center>Status</th> |
|
| </tr> | </tr> |
| <tr align="left"> | <tr align="left"> |
| <td>HPUX_IA64_ACC</td> | <td>HPUX_IA64_ACC</td> |
|
|
|
| <td> </td> | <td> </td> |
| </tr> | </tr> |
| <tr align="left"> | <tr align="left"> |
| |
<td>LINUX_PPC_E500_GNU</td> |
| |
<td> </td> |
| |
</tr> |
| |
<tr align="left"> |
| <td>LINUX_XSCALE_GNU</td> | <td>LINUX_XSCALE_GNU</td> |
| <td> </td> | <td> </td> |
| </tr> | </tr> |
|
|
|
| <td>VMS_IA64_DECCXX</td> | <td>VMS_IA64_DECCXX</td> |
| <td> </td> | <td> </td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h2>Proposed Solution</h2> | <h2>Proposed Solution</h2> |
|
|
|
| that expects the providers to perform authorization. Note that | that expects the providers to perform authorization. Note that |
| this authorization burden is considerably lighter if the provider | this authorization burden is considerably lighter if the provider |
| is registered as 'run as requestor' and if the CIM Server enables | is registered as 'run as requestor' and if the CIM Server enables |
| that feature. See <a href= |
that feature. See <a href="http://www.openpegasus.org/pp/uploads/40/7197/SecurityGuidePEP.htm"> |
| "http://www.openpegasus.org/pp/uploads/40/7197/SecurityGuidePEP.htm"> |
|
| PEP#223 - Security Coding Guidelines</a> for additional | PEP#223 - Security Coding Guidelines</a> for additional |
| details. | details. |
| </li> | </li> |
|
|
|
| <h3>Terminology Notes</h3> | <h3>Terminology Notes</h3> |
| <ol> | <ol> |
| <li> | <li> |
| In this document, the term "Not Set" is used to indicate |
In this document, the term "Not Set" is used to indicate |
| that the a value for the environment variable has not been defined. | that the a value for the environment variable has not been defined. |
| "Set" is used to indicate that the value must be defined, |
"Set" is used to indicate that the value must be defined, |
| but the actual value of the variable is not checked. | but the actual value of the variable is not checked. |
| </li> | </li> |
| </ol> | </ol> |
|
|
|
| <ol> | <ol> |
| <li> | <li> |
| Not all functionality described in this document has achieved | Not all functionality described in this document has achieved |
| "Green"status, please refer to the |
"Green"status, please refer to the |
| <a href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&ggid=799"> |
<a href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&ggid=799"> |
| OpenPegasus Project Feature Status </a>page for information on | OpenPegasus Project Feature Status </a>page for information on |
| the maturity level of OpenPegasus features. | the maturity level of OpenPegasus features. |
| </li> | </li> |
|
|
|
| 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 |
|
|
|
| environments to understand the security implications of allowing | environments to understand the security implications of allowing |
| providers to be loaded from a dynamically changing set of | providers to be loaded from a dynamically changing set of |
| directories.<br> | directories.<br> |
| </ul> |
</p></ul> |
| | |
| <h5>PEGASUS_CCOVER</h5> | <h5>PEGASUS_CCOVER</h5> |
| <ul> | <ul> |
|
|
|
| <b>Recommended Value (Release Build): </b>Not Set<br> | <b>Recommended Value (Release Build): </b>Not Set<br> |
| <b>Required: </b>No<br> | <b>Required: </b>No<br> |
| <b>Considerations: </b>This flag is only supported on HP-UX to enable | <b>Considerations: </b>This flag is only supported on HP-UX to enable |
| CCOVER for the NB&T system.<br> |
CCOVER for the NB&T system.<br> |
| </ul> | </ul> |
| | |
| <h5>PEGASUS_CIM_SCHEMA</h5> | <h5>PEGASUS_CIM_SCHEMA</h5> |
| <ul> | <ul> |
| |
|
| <b>Description: </b>This variable is used internally by the | <b>Description: </b>This variable is used internally by the |
| OpenPegasus development team when upgrading the OpenPegasus build |
OpenPegasus development team when testing OpenPegasus in the integrated |
| environment to a new version of the CIM Schema.<br> |
build/test environment. It defines the version of the CIM Schema (which |
| <b>Default Value: </b>CIM217<br> |
must exist in the $(PEGASUS_ROOT)/Schemas directory) that will be used |
| |
to build the class repository for testing the pegasus environment |
| |
("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>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> |
| No Specific Recommendation<br> | No Specific Recommendation<br> |
| <b>Required: </b>No <br> | <b>Required: </b>No <br> |
| <b>Considerations:</b> Additional code changes may be required when |
<b>Considerations:</b> |
| upgrading or downgrading the CIM Schema version.</p> |
Additional code changes may be required when upgrading or downgrading |
| |
the CIM Schema version from the default. The default CIM Schema |
| |
is defined in the file $(PEGASUS_ROOT)/mak/config.mak.<br> |
| |
<br> |
| |
<p></p> |
| </ul> | </ul> |
| | |
| |
|
| <h5>PEGASUS_CLASS_CACHE_SIZE</h5> | <h5>PEGASUS_CLASS_CACHE_SIZE</h5> |
| <ul> | <ul> |
| <b>Description: </b>This environment variable gives the size of | <b>Description: </b>This environment variable gives the size of |
|
|
|
| <b>Default Value: </b>8<br> | <b>Default Value: </b>8<br> |
| <b>Recommended Value (Development Build): </b>8<br> | <b>Recommended Value (Development Build): </b>8<br> |
| <b>Recommended Value (Release Build): </b>8<br> | <b>Recommended Value (Release Build): </b>8<br> |
| <b>Required: </b>No </p> |
<b>Required: </b>No <p></p> |
| </ul> | </ul> |
| | |
| <h5>PEGASUS_DEBUG</h5> | <h5>PEGASUS_DEBUG</h5> |
|
|
|
| Linux)<br> | Linux)<br> |
| <b>Required: </b>No<br> | <b>Required: </b>No<br> |
| <b>Considerations: </b>This environment variable can be used to | <b>Considerations: </b>This environment variable can be used to |
| change the "hard-coded" default setting for the |
change the "hard-coded" default setting for the |
| forceProviderProcesses configuration value. | forceProviderProcesses configuration value. |
| Refer to the definition of <b>forceProviderProcesses</b> for | Refer to the definition of <b>forceProviderProcesses</b> for |
| additional information. | additional information. |
|
|
|
| receive and process requests from local CIM Clients. (2) | receive and process requests from local CIM Clients. (2) |
| Enabling this option may result in lose of functionality when | Enabling this option may result in lose of functionality when |
| sslClientVerificationMode = required. (3)The | sslClientVerificationMode = required. (3)The |
| "LOCAL_DOMAIN_SOCKET" functionality has not been |
"LOCAL_DOMAIN_SOCKET" functionality has not been |
| implemented for Windows or OpenVMS. Therefore, by | implemented for Windows or OpenVMS. Therefore, by |
| default, this option is "Set" for Windows and OpenVMS |
default, this option is "Set" for Windows and OpenVMS |
| platforms. | platforms. |
| </ul> | </ul> |
| | |
|
|
|
| platforms.<br> | platforms.<br> |
| </ul> | </ul> |
| | |
| |
<h5>PEGASUS_EXTRA_PROVIDER_LIB_DIR</h5> |
| |
<ul> |
| |
<b>Description: </b>Specifies the location of the extra provider |
| |
libraries which are part of the release builds.<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> No.<br> |
| |
<b>Considerations: </b> Since providerDir config property is fixed |
| |
and hidden in release builds, this build time option provides facilty |
| |
to include the extra provider directories without any security problems. |
| |
This build time option is useful only when PEGASUS_OVERRIDE_DEFAULT_RELEASE_DIRS |
| |
is set. |
| |
</ul> |
| |
|
| <h5>PEGASUS_EMANATE_INCLUDE_DIR</h5> | <h5>PEGASUS_EMANATE_INCLUDE_DIR</h5> |
| <ul> | <ul> |
| <b>Description: </b>Specifies the location of the EMANATE | <b>Description: </b>Specifies the location of the EMANATE |
|
|
|
| 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 |
|
|
|
| Platform Only)<br> | Platform Only)<br> |
| <b>Recommended Value (Release Build): </b>true (Linux Platform | <b>Recommended Value (Release Build): </b>true (Linux Platform |
| Only)<br> | Only)<br> |
| <b>Required: </b>No</p> |
<b>Required: </b>No<p></p> |
| </ul> | </ul> |
| | |
| <h5>PEGASUS_ENABLE_COMPRESSED_REPOSITORY</h5> | <h5>PEGASUS_ENABLE_COMPRESSED_REPOSITORY</h5> |
|
|
|
| <b>Required: </b>No<br><b>Considerations: </b> | <b>Required: </b>No<br><b>Considerations: </b> |
| This flag is currently only supported with GCC on Linux. | This flag is currently only supported with GCC on Linux. |
| <ul> | <ul> |
| Note: LCOV, <a href= |
Note: LCOV, <a href="http://ltp.sourceforge.net/coverage/lcov.php"> |
| "http://ltp.sourceforge.net/coverage/lcov.php"> |
|
| http://ltp.sourceforge.net/coverage/lcov.php</a>, is a | http://ltp.sourceforge.net/coverage/lcov.php</a>, is a |
| graphical front-end extension for GCOV. It collects GCOV data | graphical front-end extension for GCOV. It collects GCOV data |
| for multiple source files and creates HTML pages with coverage | for multiple source files and creates HTML pages with coverage |
|
|
|
| output (e.g., <i>genhtml result.info</i>). The | output (e.g., <i>genhtml result.info</i>). The |
| top .html file is named index.html.</li> | top .html file is named index.html.</li> |
| </ul> | </ul> |
| </ol> |
</li></ol> |
| </ul> | </ul> |
| </ul> | </ul> |
| | |
|
|
|
| indication provider.<br> | indication provider.<br> |
| </ul> | </ul> |
| | |
| |
<h5>PEGASUS_ENABLE_PROTOCOL_BINARY</h5> |
| |
<ul> |
| |
<b>Description: </b>If true, OpenPegasus uses a faster binary |
| |
protocol between local clients 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 |
|
|
|
| details.<br> | details.<br> |
| </ul> | </ul> |
| | |
| |
<h5>PEGASUS_INTEROP_NAMESPACE</h5> |
| |
<ul> |
| |
<b>Description: </b>This variable is used for configuring the Interop |
| |
namespace name. This option helps to establish a consistent Interop |
| |
Namespace as mentioned in DMTF specification.(DSP1033)<br> |
| |
<b>Default Value: </b>root/PG_InterOp<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>The accepted values for this environment |
| |
variable are "root/PG_InterOp" or "interop" or "root/interop". For |
| |
any other value, the default value will be used.With the usage of |
| |
this build option, we have to start using pegasus with fresh repository. |
| |
</ul> |
| |
|
| <h5>PEGASUS_ENABLE_IPV6</h5> | <h5>PEGASUS_ENABLE_IPV6</h5> |
| <ul> | <ul> |
| <b>Description: </b>This variable can be used to specify | <b>Description: </b>This variable can be used to specify |
|
|
|
| <b>Default Value: </b>false<br> | <b>Default Value: </b>false<br> |
| <b>Recommended Value (Development Build): </b>false<br> | <b>Recommended Value (Development Build): </b>false<br> |
| <b>Recommended Value (Release Build): </b>false<br> | <b>Recommended Value (Release Build): </b>false<br> |
| <b>Required: </b>No</p> |
<b>Required: </b>No<p></p> |
| </ul> | </ul> |
| | |
| <h5>PEGASUS_ENABLE_OBJECT_NORMALIZATION</h5> | <h5>PEGASUS_ENABLE_OBJECT_NORMALIZATION</h5> |
|
|
|
| <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>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>Not Set<br> | <b>Recommended Value (Release Build): </b>Not Set<br> |
| <b>Required: </b>No</p> |
<b>Required: </b>No<p></p> |
| </ul> | </ul> |
| | |
| <h5>PEGASUS_ENABLE_SLP</h5> | <h5>PEGASUS_ENABLE_SLP</h5> |
|
|
|
| this variable is set to 'false' or not set, the SLP functionality | this variable is set to 'false' or not set, the SLP functionality |
| will not be included. All other values are considered | will not be included. All other values are considered |
| invalid and will result in a build error | invalid and will result in a build error |
| (e.g., "PEGASUS_ENABLE_SLP ($(PEGASUS_ENABLE_SLP)) invalid, |
(e.g., "PEGASUS_ENABLE_SLP ($(PEGASUS_ENABLE_SLP)) invalid, |
| must be true or false").<br> |
must be true or false").<br> |
| <b>Default Value: </b>'true' for Windows; 'false' for all other | <b>Default Value: </b>'true' for Windows; 'false' for all other |
| Platforms<br> | Platforms<br> |
| <b>Recommended Value (Development Build): </b>'true' for | <b>Recommended Value (Development Build): </b>'true' for |
|
|
|
| <b>Recommended Value (Release Build): </b> | <b>Recommended Value (Release Build): </b> |
| No Specific Recommendation<br> | No Specific Recommendation<br> |
| <b>Required: </b>Yes<br> | <b>Required: </b>Yes<br> |
| <b>Considerations: </b>The error "PEGASUS_HOME |
<b>Considerations: </b>The error "PEGASUS_HOME |
| environment variable undefined" is returned if the |
environment variable undefined" is returned if the |
| PEGASUS_HOME environment variable is not set. | PEGASUS_HOME environment variable is not set. |
| This variable is also used during runtime. Refer to the section | This variable is also used during runtime. Refer to the section |
| titled "Environment Variable Settings for Running OpenPegasus |
titled "Environment Variable Settings for Running OpenPegasus |
| 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> | <h5>PEGASUS_INDICATIONS_Q_THRESHOLD</h5> |
|
|
|
| following table describes the platforms documented in | following table describes the platforms documented in |
| this version of the document. <br> | this version of the document. <br> |
| <b>Default Value: </b>None<p> </p> | <b>Default Value: </b>None<p> </p> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="542"> |
| bordercolorlight="#CCCCCC" width=542 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="190">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="351">Recommended Value <br> |
| <th bgcolor="#CAE6CA" width="190">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=351>Recommended Value <br> |
|
| Development Build</th> | Development Build</th> |
| <th bgcolor="#CAE6CA" width=338>Recommended Value <br> |
<th bgcolor="#cae6ca" width="338">Recommended Value <br> |
| Release Build</th> | Release Build</th> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="190" align="left">Linux IA32</td> |
<td align="left" width="190">Linux IA32</td> |
| <td width="351">LINUX_IX86_GNU</td> | <td width="351">LINUX_IX86_GNU</td> |
| <td width="338">LINUX_IX86_GNU</td> | <td width="338">LINUX_IX86_GNU</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="190" align="left">Linux IA64</td> |
<td align="left" width="190">Linux IA64</td> |
| <td width="351">LINUX_IA64_GNU</td> | <td width="351">LINUX_IA64_GNU</td> |
| <td width="338">LINUX_IA64_GNU</td> | <td width="338">LINUX_IA64_GNU</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="190" align="left">Linux X86_64</td> |
<td align="left" width="190">Linux X86_64</td> |
| <td width="351">LINUX_X86_64_GNU</td> | <td width="351">LINUX_X86_64_GNU</td> |
| <td width="338">LINUX_X86_64_GNU</td> | <td width="338">LINUX_X86_64_GNU</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="190" align="left">HP-UX PA-RISC</td> |
<td align="left" width="190">HP-UX PA-RISC</td> |
| <td width="351">HPUX_PARISC_ACC</td> | <td width="351">HPUX_PARISC_ACC</td> |
| <td width="338">HPUX_PARISC_ACC</td> | <td width="338">HPUX_PARISC_ACC</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="190" align="left">HP-UX IPF</td> |
<td align="left" width="190">HP-UX IPF</td> |
| <td width="351">HPUX_IA64_ACC</td> | <td width="351">HPUX_IA64_ACC</td> |
| <td width="338">HPUX_IA64_ACC</td> | <td width="338">HPUX_IA64_ACC</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="190" align="left">OpenVMS Alpha</td> |
<td align="left" width="190">OpenVMS Alpha</td> |
| <td width="351">VMS_ALPHA_DECCXX</td> | <td width="351">VMS_ALPHA_DECCXX</td> |
| <td width="338">VMS_ALPHA_DECCXX</td> | <td width="338">VMS_ALPHA_DECCXX</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="190" align="left">OpenVMS IA64</td> |
<td align="left" width="190">OpenVMS IA64</td> |
| <td width="351">VMS_IA64_DECCXX</td> | <td width="351">VMS_IA64_DECCXX</td> |
| <td width="338"> VMS_IA64_DECCXX</td> | <td width="338"> VMS_IA64_DECCXX</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| <br><br> | <br><br> |
| <b>Required: </b>Yes<br> | <b>Required: </b>Yes<br> |
| <b>Considerations: </b>The error "PEGASUS_PLATFORM | <b>Considerations: </b>The error "PEGASUS_PLATFORM |
|
|
|
| <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 |
|
|
|
| do any validity checking on the specified value, either | do any validity checking on the specified value, either |
| to determine if it is a valid positive integer or if it | to determine if it is a valid positive integer or if it |
| exceeds some maximum value.<br> | exceeds some maximum value.<br> |
| </ul> |
</p></ul> |
| | |
| <h5>PEGASUS_SNIA_EXTENSIONS</h5> | <h5>PEGASUS_SNIA_EXTENSIONS</h5> |
| <ul> | <ul> |
|
|
|
| <ul> | <ul> |
| <b>Description: </b>This variable is only used for | <b>Description: </b>This variable is only used for |
| testing. If set to true, the IPv6-specific tests will | testing. If set to true, the IPv6-specific tests will |
| be run as part of the "alltests" OpenPegasus |
be run as part of the "alltests" OpenPegasus |
| TestMakefile test suite. If this variable is not set or set to | TestMakefile test suite. If this variable is not set or set to |
| false, the IPv6-specific tests will not be run. All | false, the IPv6-specific tests will not be run. All |
| other values are invalid.<br> | other values are invalid.<br> |
|
|
|
| PEGASUS_TEST_USER_ID and PEGASUS_TEST_USER_PASS variables | PEGASUS_TEST_USER_ID and PEGASUS_TEST_USER_PASS variables |
| defines a valid user/password pair and can be used for | defines a valid user/password pair and can be used for |
| certificate-based authentication testing. These tests | certificate-based authentication testing. These tests |
| also assumes that "invalidUser" is not a valid |
also assumes that "invalidUser" is not a valid |
| user.<br> | user.<br> |
| <b>Default Value: </b>Not Set<br> | <b>Default Value: </b>Not Set<br> |
| <b>Recommended Value (Development Build): </b>Set<br> | <b>Recommended Value (Development Build): </b>Set<br> |
|
|
|
| <b>Considerations: </b>Either the PEGASUS_USE_NET_SNMP or | <b>Considerations: </b>Either the PEGASUS_USE_NET_SNMP or |
| PEGASUS_USE_EMANATE variable must be set for the SNMP | PEGASUS_USE_EMANATE variable must be set for the SNMP |
| Handler to be supported.<br> | Handler to be supported.<br> |
| </ul> |
</p></ul> |
| | |
| | |
| <h5>PEGASUS_USE_NET_SNMP</h5> | <h5>PEGASUS_USE_NET_SNMP</h5> |
|
|
|
| <b>Considerations: </b>Either the PEGASUS_USE_NET_SNMP or | <b>Considerations: </b>Either the PEGASUS_USE_NET_SNMP or |
| PEGASUS_USE_EMANATE variable must be set for the SNMP | PEGASUS_USE_EMANATE variable must be set for the SNMP |
| Handler to be supported.<br> | Handler to be supported.<br> |
| </ul> |
</p></ul> |
| |
|
| |
<h5>PEGASUS_ENABLE_NET_SNMPV3</h5> |
| |
<ul> |
| |
<b>Description: </b>If this variable is defined, |
| |
then OpenPegasus SNMP Handler will build the SNMPV3 |
| |
features. This should be set to false if NET-SNMP 5.2 and lower |
| |
libraries are used.<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<p> |
| |
<b>Considerations: </b>PEGASUS_USE_NET_SNMP variable must |
| |
be set.<br> |
| |
</p></ul> |
| |
|
| | |
| <h5>PEGASUS_USE_OPENSLP</h5> | <h5>PEGASUS_USE_OPENSLP</h5> |
| <ul> | <ul> |
|
|
|
| <ul> | <ul> |
| <b>Description: </b>If set, OpenPegasus is built using | <b>Description: </b>If set, OpenPegasus is built using |
| 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 |
| vendor to easily toggle between two sets of configurations | vendor to easily toggle between two sets of configurations |
| options, a set of options tuned for the development/debug | options, a set of options tuned for the development/debug |
| ("Development Build") environment and a set of options |
("Development Build") environment and a set of options |
| tuned for the production environment ("Release Build"). | tuned for the production environment ("Release Build"). |
| Refer the section titled "Configuration Properties" for | Refer the section titled "Configuration Properties" for |
| additional detail. (2) For each configuration | additional detail. (2) For each configuration |
| variable, the "Recommended Value (Release Build)" |
variable, the "Recommended Value (Release Build)" |
| value defines the recommended settings to use for a | value defines the recommended settings to use for a |
| "Release Build". Please refer to the |
"Release Build". Please refer to the |
| description of each variable for additional information. | description of each variable for additional information. |
| </ul> | </ul> |
| | |
|
|
|
| <ul> | <ul> |
| <b>Description: </b>If set, OpenPegasus is built using | <b>Description: </b>If set, OpenPegasus is built using |
| the "Release Build" directory definitions. By default, | the "Release Build" directory definitions. By default, |
| OpenPegasus is built using the "Development Build" |
OpenPegasus is built using the "Development Build" |
| directory definitions.<br> | directory definitions.<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> |
|
|
|
| The PEGASUS_USE_RELEASE_DIRS variable allows a platform | The PEGASUS_USE_RELEASE_DIRS variable allows a platform |
| vendor to easily toggle between two sets of directory | vendor to easily toggle between two sets of directory |
| definitions, a set tuned for the development/debug | definitions, a set tuned for the development/debug |
| ("Development Build") environment and a set tuned for the |
("Development Build") environment and a set tuned for the |
| production environment ("Release Build"). Refer the section | production environment ("Release Build"). Refer the section |
| titled "Configuration Properties" for additional detail.<br> | titled "Configuration Properties" for additional detail.<br> |
| </ul> | </ul> |
| | |
| |
<h5>PEGASUS_FLAVOR</h5> |
| |
<ul> |
| |
<b>Description: </b> This variable is used for configuring Multi CIMOM |
| |
on same OS by eliminating single point for storage of PID's and configuration |
| |
files. Flavor is used in structuring the release dirs,configuration file names, |
| |
log identity and PAM config file. |
| |
If set, OpenPegasus is built using the flavor value. By default OpenPegasus is |
| |
built using "tog" as the flavor. RPMs are named using the flavor value. |
| |
<br> |
| |
<b>Default Value: </b>tog<br> |
| |
<b>Recommended Value (Development Build): </b>tog<br> |
| |
<b>Recommended Value (Release Build): </b>tog<br> |
| |
<b>Required: </b>No<br> |
| |
<b>Considerations: </b> |
| |
To build RPM using flavor, RPM spec file needs to be regenerated after setting the flavor value. |
| |
This can be done using the create_OpenPegasusRPMSpecFile target in the Makefile.Release. |
| |
Platforms have to define their own release dir structure using the flavor for release builds. |
| |
An error will be reported if both PEGASUS_FLAVOR and PEGASUS_USE_RELEASE_DIRS are set and |
| |
PEGASUS_OVERRIDE_DEFAULT_RELEASE_DIRS is not set. |
| |
RPM build on linux defines PEGASUS_OVERRIDE_DEFAULT_RELEASE_DIRS by default. |
| |
<br> |
| |
</ul> |
| |
|
| |
<h5>PEGASUS_PLATFORM_FOR_32BIT_PROVIDER_SUPPORT</h5> |
| |
<ul> |
| |
<b>Description: </b> Builds the Pegasus with 32-bit provider support for the specified platform. |
| |
If this option is set, the value MUST be one of the 32-bit supported platforms by Pegasus. |
| |
<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 option is used to run the 32-bit providers under 64-bit CIMserver. |
| |
To register the 32-bit providers, register the provider module by setting the |
| |
Bitness property value to "2". 32-bit Providers are always loaded out of process |
| |
irrespective of forceProviderProcesses config option. |
| |
<br> |
| |
</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> |
| |
|
| |
<h5>PEGASUS_INITIAL_THREADSTACK_SIZE</h5> |
| |
<ul> |
| |
<b>Description: </b>This environment variable sets the initial size |
| |
of the stack on new threads. Value is specified in number of bytes.<br> |
| |
<b>Default Value: </b>262144<br> |
| |
<b>Recommended Value (Development Build): </b>262144<br> |
| |
<b>Recommended Value (Release Build): </b>262144<br> |
| |
<b>Required: </b>No <p></p> |
| |
</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> |
|
|
|
| export PEGASUS_HOME=/home/pegasusbld/pegasus/build<br> | export PEGASUS_HOME=/home/pegasusbld/pegasus/build<br> |
| export PEGASUS_PLATFORM=LINUX_IX86_GNU<br> | export PEGASUS_PLATFORM=LINUX_IX86_GNU<br> |
| #export PEGASUS_PLATFORM=LINUX_IA64_GNU<br> | #export PEGASUS_PLATFORM=LINUX_IA64_GNU<br> |
| export PEGASUS_DISABLE_CQL=true <br> |
export PEGASUS_ENABLE_CQL=false<br> |
| export PEGASUS_PAM_AUTHENTICATION=true <br> | export PEGASUS_PAM_AUTHENTICATION=true <br> |
| export PEGASUS_USE_PAM_STANDALONE_PROC=true<br> | export PEGASUS_USE_PAM_STANDALONE_PROC=true<br> |
| export PEGASUS_HAS_SSL=yes<br> | export PEGASUS_HAS_SSL=yes<br> |
|
|
|
| However, CIM Client applications must rely on an alternative | However, CIM Client applications must rely on an alternative |
| mechanism to locate this directory.<br> | mechanism to locate this directory.<br> |
| <b>Default Value: </b>if $PEGASUS_HOME is set then | <b>Default Value: </b>if $PEGASUS_HOME is set then |
| "$PEGASUS_HOME/msg" else "."<br> |
"$PEGASUS_HOME/msg" else "."<br> |
| <b>Recommended Value (Development Build): </b>$PEGASUS_HOME/msg<br> | <b>Recommended Value (Development Build): </b>$PEGASUS_HOME/msg<br> |
| <b>Recommended Value (Release Build): </b>Not Set <br> | <b>Recommended Value (Release Build): </b>Not Set <br> |
| <b>Required: </b>No<br> | <b>Required: </b>No<br> |
|
|
|
| The PEGASUS_USE_RELEASE_CONFIG_OPTIONS variable allows a | The PEGASUS_USE_RELEASE_CONFIG_OPTIONS variable allows a |
| platform vendor to easily toggle between two sets of | platform vendor to easily toggle between two sets of |
| configurations options, a set of options tuned for the | configurations options, a set of options tuned for the |
| development/debug ("Development Build") environment |
development/debug ("Development Build") environment |
| and a set of options tuned for the production environment | and a set of options tuned for the production environment |
| ("Release Build"). The value of | ("Release Build"). The value of |
| <i>Recommended Value (Development Build)</i> | <i>Recommended Value (Development Build)</i> |
|
|
|
| for the following variables are platform | for the following variables are platform |
| and vendor dependent and not documented in this document.</p> | and vendor dependent and not documented in this document.</p> |
| | |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" height="228" width="148"> |
| bordercolorlight="#CCCCCC" width=148 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial' height="228"> |
<th bgcolor="#cae6ca" height="16" width="1"> </th> |
| <tr> |
|
| <th bgcolor="#CAE6CA" width=1 height="16"> </th> |
|
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="12">$LOGDIR</td> |
<td align="left" height="12" width="1">$LOGDIR</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14">$PROVIDERDIRS</td> |
<td align="left" height="14" width="1">$PROVIDERDIRS</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14"> |
<td align="left" height="14" width="1"> |
| $PROVIDERMANAGERDIRS</td> | $PROVIDERMANAGERDIRS</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14">$REPOSITORYDIR </td> |
<td align="left" height="14" width="1">$REPOSITORYDIR </td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14">$CERTIFICATEDIR |
<td align="left" height="14" width="1">$CERTIFICATEDIR |
| </td> | </td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14">$LOCALAUTHDIR</td> |
<td align="left" height="14" width="1">$LOCALAUTHDIR</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14">$TRACEDIR</td> |
<td align="left" height="14" width="1">$TRACEDIR</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14">$CONFIGDIR</td> |
<td align="left" height="14" width="1">$CONFIGDIR</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14">$PIDFILE</td> |
<td align="left" height="14" width="1">$PIDFILE</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14">$RANDOMDIR</td> |
<td align="left" height="14" width="1">$RANDOMDIR</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14">$SOCKETDIR</td> |
<td align="left" height="14" width="1">$SOCKETDIR</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td align="left" width="1" height="14">$MESSAGEDIR</td> |
<td align="left" height="14" width="1">$MESSAGEDIR</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h4>Definitions</h4> | <h4>Definitions</h4> |
|
|
|
| No/Yes<br> | No/Yes<br> |
| <b>Dynamic?: </b>No<p> <br> | <b>Dynamic?: </b>No<p> <br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350">Source Configuration File</th> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350>Source Configuration File</th> |
|
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168">Linux</td> | <td width="168">Linux</td> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> |
</p></ul> |
| | |
| <h5>enableAssociationTraversal</h5> | <h5>enableAssociationTraversal</h5> |
| <ul> | <ul> |
|
|
|
| Provider Registration issue that restricts the degree to | Provider Registration issue that restricts the degree to |
| which separate Providers can register for Associations.<br> | which separate Providers can register for Associations.<br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350">Source Configuration File</th> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350>Source Configuration File</th> |
|
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168">Linux</td> | <td width="168">Linux</td> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h5>enableAuditLog</h5> | <h5>enableAuditLog</h5> |
|
|
|
| <b>Considerations: </b>Repositories containing a mixture | <b>Considerations: </b>Repositories containing a mixture |
| of binary and XML objects are supported.<br> | of binary and XML objects are supported.<br> |
| <b>Source Configuration File: </b> | <b>Source Configuration File: </b> |
| Pegasus/Config/RepositoryPropertyOwner.cpp</p> |
Pegasus/Config/RepositoryPropertyOwner.cpp<p></p> |
| </ul> | </ul> |
| | |
| | |
|
|
|
| user names and passwords will be included in the text of the | user names and passwords will be included in the text of the |
| HTTP message.<br> | HTTP message.<br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350">Source Configuration File</th> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350>Source Configuration File</th> |
|
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168">Linux</td> | <td width="168">Linux</td> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h5>enableHttpsConnection</h5> | <h5>enableHttpsConnection</h5> |
|
|
|
| the environment variable PEGASUS_HAS_SSL must have | the environment variable PEGASUS_HAS_SSL must have |
| been set when CIM Server was built.<br> | been set when CIM Server was built.<br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350">Source Configuration File</th> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350>Source Configuration File</th> |
|
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168">Linux</td> | <td width="168">Linux</td> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h5>enableIndicationService</h5> | <h5>enableIndicationService</h5> |
|
|
|
| <b>Recommended Default Value (Release Build): </b>true<br> | <b>Recommended Default Value (Release Build): </b>true<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<p> <br> |
<b>Dynamic?: </b>Yes/No<br> |
| |
<b>Considerations: </b>When enableIndicationService is set to |
| |
false dynamically, delete subscription requests are sent to all |
| |
indication providers and indication related operations are |
| |
not supported until indication service is re-enabled. Dynamic |
| |
configuration facility is available only when Pegasus is compiled |
| |
with PEGASUS_ENABLE_DMTF_INDICATION_PROFILE_SUPPORT=true. Clients |
| |
who wants to utilize the IndicationService services MUST check for |
| |
CIM_IndicationService EnabledState and HealthState properties to know |
| |
the current indication service state. For example, User can enumerate |
| |
instances of CIM_IndicationService and there is exactly one instance |
| |
of CIM_IndicationService returned. (Ex. using cimcli command |
| |
'cimcli ei -n root/PG_InterOp CIM_IndicationService'). When requested state |
| |
change(Enabled/Disabled) cannot be made because of timeout or some |
| |
other exception IndicationService HealthState is set to "Degraded/Warning". |
| |
For example, if user requested for indication service disable (by setting |
| |
enableIndicationService=false), disable failed because of timeout or some |
| |
other exception. Now service health state is set to "Degraded/Warning" |
| |
and service EnabledState will remain enabled. User can now identify the |
| |
faulty provider causing the timeout or any other problem and can take |
| |
appropriate action. User can again request for service disable to recover |
| |
from degraded state. Similar sequence applies while enabling the indication |
| |
service. Only difference is that service EnabledState is set to Enabled |
| |
if exception or timeout happens. There is no automatic recovery from |
| |
degraded state is available at present.<br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350">Source Configuration File</th> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350>Source Configuration File</th> |
|
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168">Linux</td> | <td width="168">Linux</td> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h5>enableNamespaceAuthorization</h5> | <h5>enableNamespaceAuthorization</h5> |
|
|
|
| <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 |
|
|
|
| exception have an opportunity to handle the error. | exception have an opportunity to handle the error. |
| Otherwise, the exception is passed to the Provider Manager | Otherwise, the exception is passed to the Provider Manager |
| and becomes the response for that Provider. | and becomes the response for that Provider. |
| <li>Provider Modules that are listed on the |
</li><li>Provider Modules that are listed on the |
| excludeModulesFromNormalization | excludeModulesFromNormalization |
| configuration option are excluded from normalization. | configuration option are excluded from normalization. |
| <li>Since the concept of normalization is relatively new to |
</li><li>Since the concept of normalization is relatively new to |
| OpenPegasus and it establishes and enforces rules for | OpenPegasus and it establishes and enforces rules for |
| objects returned by providers, it should only | objects returned by providers, it should only |
| apply to providers written against the SDK in which it was | apply to providers written against the SDK in which it was |
|
|
|
| combination will be subject to normalization: | combination will be subject to normalization: |
| <ul> | <ul> |
| <li>'C++Default' / 2.5.0 or greater | <li>'C++Default' / 2.5.0 or greater |
| <li>'CMPI' / 2.0.0 or greater |
</li><li>'CMPI' / 2.0.0 or greater |
| <li>'JMPI' / 1.0.0 or greater |
</li><li>'JMPI' / 1.0.0 or greater |
| </ul> |
</li></ul> |
| </ul> |
</li></ul> |
| <b>Source Configuration File: </b> | <b>Source Configuration File: </b> |
| Pegasus/Config/NormalizationPropertyOwner.cpp<br> | Pegasus/Config/NormalizationPropertyOwner.cpp<br> |
| </ul> | </ul> |
|
|
|
| Pegasus/Config/SecurityPropertyOwner.cpp<p> </p> | Pegasus/Config/SecurityPropertyOwner.cpp<p> </p> |
| </ul> | </ul> |
| | |
| <h5>enableSSLExportClientVerification</h5> |
|
| <ul> |
|
| <b>Description: </b>If true, the CIM Server allows HTTPS |
|
| connection for CIMExport requests on the port specified by the |
|
| service name "wbem-exp-https".<br> |
|
| <b>Default Value: </b>false<br> |
|
| <b>Recommended Default Value (Development Build): </b>true<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 (Release Build): </b>No/No<br> |
|
| <b>Dynamic?: </b>No<br> |
|
| <b>Source Configuration File: </b> |
|
| Pegasus/Config/SecurityPropertyOwner.cpp</p> |
|
| </ul> |
|
| |
|
| |
|
| <h5>enableSubscriptionsForNonprivilegedUsers</h5> | <h5>enableSubscriptionsForNonprivilegedUsers</h5> |
| <ul> | <ul> |
| <b>Description: </b>If true, operations (create instance, | <b>Description: </b>If true, operations (create instance, |
|
|
|
| comma-separated Provider Module names (as specified in | comma-separated Provider Module names (as specified in |
| PG_ProviderModule.Name) to exclude from validation and | PG_ProviderModule.Name) to exclude from validation and |
| normalization.<br> | normalization.<br> |
| <b>Default Value: </b>""<br> |
<b>Default Value: </b>""<br> |
| <b>Recommended Default Value (Development Build):</b> | <b>Recommended Default Value (Development Build):</b> |
| ""<br> |
""<br> |
| <b>Recommended Default Value (Release Build): </b> | <b>Recommended Default Value (Release Build): </b> |
| ""<br> |
""<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>No<br> |
|
|
|
| Pegasus/Config/NormalizationPropertyOwner.cpp | Pegasus/Config/NormalizationPropertyOwner.cpp |
| </ul> | </ul> |
| | |
| |
|
| <h5><b>exportSSLTrustStore</b></h5> |
|
| <ul> |
|
| <b>Description: </b>Specifies the location of the OpenSSL |
|
| truststore for Indications. Consistent with the OpenSSL |
|
| implementation, a truststore can be either a file or directory. |
|
| If the truststore is a directory, all the certificates within |
|
| the directory are considered trusted.<br> |
|
| <b>Default Value: </b>indication_trust.pem<br> |
|
| <b>Recommended Default Value (Development Build): </b> |
|
| indication_trust.pem<br> |
|
| <b>Recommended Default Value (Release Build): </b> |
|
| $CERTIFICATEDIR/indication_trust.pem<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>Dynamic?: </b>No<br> |
|
| <b>Source Configuration File: </b> |
|
| Pegasus/Config/SecurityPropertyOwner.cpp</p> |
|
| </ul> |
|
| |
|
| <h5>forceProviderProcesses</h5> | <h5>forceProviderProcesses</h5> |
| <ul> | <ul> |
| <b>Description: </b>If true, the CIM Server runs Providers | <b>Description: </b>If true, the CIM Server runs Providers |
|
|
|
| message informing administrators of what happened and what | message informing administrators of what happened and what |
| corrective actions can be taken.<br> | corrective actions can be taken.<br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350"> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350> |
|
| Source Configuration File</th> | Source Configuration File</th> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h5>home</h5> | <h5>home</h5> |
|
|
|
| <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<p> <br> | <b>Dynamic?: </b>No<p> <br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350">Source Configuration File</th> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350>Source Configuration File</th> |
|
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168">Linux</td> | <td width="168">Linux</td> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| |
</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> | </ul> |
| | |
| <h5>httpPort</h5> | <h5>httpPort</h5> |
|
|
|
| IANA</a>. In a production environment, the recommendation is | IANA</a>. In a production environment, the recommendation is |
| to use /etc/services to configure the value of this port. (2) | to use /etc/services to configure the value of this port. (2) |
| With the release of OpenPegasus 2.5, the default values for | With the release of OpenPegasus 2.5, the default values for |
| httpPort was changed from 5988 to "". This |
httpPort was changed from 5988 to "". This |
| change was made to allow the OpenPegasus to differentiate | change was made to allow the OpenPegasus to differentiate |
| between a default setting of 5988 and a customer-defined | between a default setting of 5988 and a customer-defined |
| setting of 5988. With this change, if the port | setting of 5988. With this change, if the port |
|
|
|
| is specified, the server will continue to use the value in | is specified, the server will continue to use the value in |
| /etc/services.<br> | /etc/services.<br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350">Source Configuration File</th> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350>Source Configuration File</th> |
|
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168">Linux</td> | <td width="168">Linux</td> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h5>httpsPort</h5> | <h5>httpsPort</h5> |
|
|
|
| In a production environment, the recommendation is to use | In a production environment, the recommendation is to use |
| /etc/services to configure the value of this port.(2) | /etc/services to configure the value of this port.(2) |
| With the release of OpenPegasus 2.5, the default values for | With the release of OpenPegasus 2.5, the default values for |
| httpPort was changed from 5989 to "". This |
httpPort was changed from 5989 to "". This |
| change was made to allow the OpenPegasus to differentiate | change was made to allow the OpenPegasus to differentiate |
| between a default setting of 5989 and a customer-defined | between a default setting of 5989 and a customer-defined |
| setting of 5989. With this change, if the port number | setting of 5989. With this change, if the port number |
|
|
|
| the server will continue to use the value in /etc/services.<br> | the server will continue to use the value in /etc/services.<br> |
| <br> | <br> |
| | |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350">Source Configuration File</th> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350>Source Configuration File</th> |
|
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168">Linux</td> | <td width="168">Linux</td> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h5>idleConnectionTimeout</h5> | <h5>idleConnectionTimeout</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/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> |
| |
|
| |
<h5>maxFailedProviderModuleRestarts</h5> |
| |
<ul> |
| |
<b>Description: </b>If set to a positive integer, this value |
| |
specifies the number of times the failed provider module with |
| |
indications enabled are restarted automatically before being |
| |
moved to Degraded state. If set to zero, failed provider module |
| |
is not restarted with indications enabled automatically and |
| |
will be moved to Degraded state immediately.<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/No<br> |
| |
<b>Dynamic?: </b>Yes<br> |
| |
<b>Considerations: </b>This option controls the automatic |
| |
re-enabling of the failed provider module with indications |
| |
enabled. If the provider module with indications enabled fails |
| |
very frequently, it affects the CIMServer normal operations because |
| |
CIMServer would be busy with reloading the provider module every |
| |
time it fails. This option would be helpful if the long running |
| |
indication provider crashes and the management application want |
| |
to receive the indications from the provider while provider fix |
| |
is being delivered. In case of provider module grouping, if one of |
| |
the indication provider crashes, it affects all indication providers |
| |
in the provider modules of the group. Note that this is the facility |
| |
provided by the CIMServer for temporary recovery of the provider and |
| |
the ultimate goal SHALL be fixing the faulty provider. |
| |
</ul> |
| |
|
| |
<h5>maxIndicationDeliveryRetryAttempts</h5> |
| |
<ul> |
| |
<b>Description: </b> If set to a positive integer, this value |
| |
defines the number of times that the indication service will |
| |
try to deliver an indication to a particular listener destination. |
| |
This does not effect the original delivery attempt, thus if set to 0, |
| |
cimserver will only try to deliver the indication once.<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/No<br> |
| |
<b>Dynamic?: </b>No<br> |
| |
<b>Considerations: </b> This value is used to set the |
| |
CIM_IndicationService.DeliveryRetryAttempts property. See |
| |
CIM_IndicationService.DeliveryRetryAttempts property for more details. This |
| |
option is supported only when PEGASUS_ENABLE_DMTF_INDICATION_PROFILE_SUPPORT |
| |
is defined.<br> |
| |
<b>Source Configuration File: </b> |
| |
Pegasus/Config/IndicationServicePropertyOwner.cpp<br> |
| |
</ul> |
| |
|
| |
<h5>minIndicationDeliveryRetryInterval</h5> |
| |
<ul> |
| |
<b>Description: </b> If set to a positive integer, this value defines |
| |
the minimal time interval in seconds for the indication service to wait |
| |
before retrying to deliver an indication to a listener destination that |
| |
previously failed. Cimserver may take longer due to QoS or other processing.<br> |
| |
<b>Recommended Default Value (Development Build): </b>30<br> |
| |
<b>Recommended Default Value (Release Build): </b>30<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> This value is used to initialize the property |
| |
CIM_IndicationService.DeliveryRetryInterval. See |
| |
CIM_IndicationService.DeliveryRetryInterval property for more details. This |
| |
option is supported only when PEGASUS_ENABLE_DMTF_INDICATION_PROFILE_SUPPORT |
| |
is defined.<br> |
| |
<b>Source Configuration File: </b> |
| |
Pegasus/Config/IndicationServicePropertyOwner.cpp<br> |
| |
</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> | </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 bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350"> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350> |
|
| Source Configuration File</th> | Source Configuration File</th> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h5>messageDir</h5> | <h5>messageDir</h5> |
|
|
|
| $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 |
| 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 |
|
|
|
| <b>Considerations: </b><br> | <b>Considerations: </b><br> |
| <b>Source Configuration File: </b> | <b>Source Configuration File: </b> |
| Pegasus/Config/FileSystemPropertyOwner.cpp<p><br> | Pegasus/Config/FileSystemPropertyOwner.cpp<p><br> |
| </ul> |
</p></ul> |
| | |
| <h5>repositoryIsDefaultInstanceProvider</h5> | <h5>repositoryIsDefaultInstanceProvider</h5> |
| <ul> | <ul> |
|
|
|
| <li><b>Authorization.</b> The repository has no | <li><b>Authorization.</b> The repository has no |
| concept of which users (or components) are authorized to | concept of which users (or components) are authorized to |
| perform which operations.</li> | perform which operations.</li> |
| <li><b>Appearance of instrumentation.</b> A client application |
<li><b>Appearance of instrumentation.</b> A client application |
| cannot determine whether instrumentation exists for a | cannot determine whether instrumentation exists for a |
| given CIM class. For example, imagine a client | given CIM class. For example, imagine a client |
| issues a CreateInstance operation on a Disk class | issues a CreateInstance operation on a Disk class |
| for which no provider is registered. | for which no provider is registered. |
| The instance will be stored in the repository, and | The instance will be stored in the repository, and |
| the client gets a "success" response. Does that mean a |
the client gets a "success" response. Does that mean a |
| disk device has been created on the server? Even worse, | disk device has been created on the server? Even worse, |
| when another client issues an EnumerateInstances | when another client issues an EnumerateInstances |
| operation, the spurious Disk instance is returned. | operation, the spurious Disk instance is returned. |
| With repositoryIsDefaultInstanceProvider=false, the | With repositoryIsDefaultInstanceProvider=false, the |
| CreateInstance operation above would have returned a | CreateInstance operation above would have returned a |
| NOT_SUPPORTED error.</li> | NOT_SUPPORTED error.</li> |
| <li><b>Potential for inconsistent data.</b> Using the |
<li><b>Potential for inconsistent data.</b> Using the |
| repository as a data cache increases the probability | repository as a data cache increases the probability |
| that a client will see stale or incorrect data. A | that a client will see stale or incorrect data. A |
| provider can better control the correlation | provider can better control the correlation |
|
|
|
| <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<p> <br> | <b>Dynamic?: </b>No<p> <br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" height="80" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial' height="80"> |
<th bgcolor="#cae6ca" height="16" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" height="16" width="350"> |
| <th bgcolor="#CAE6CA" width="168" height="16">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350 height="16"> |
|
| Source Configuration File</th> | Source Configuration File</th> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168" height="14">Linux</td> |
<td height="14" width="168">Linux</td> |
| <td align="left" width="350" height="14"> |
<td align="left" height="14" width="350"> |
| Pegasus/Config/DefaultPropertyTableLinux.h</td> | Pegasus/Config/DefaultPropertyTableLinux.h</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168" height="14">HP-UX</td> |
<td height="14" width="168">HP-UX</td> |
| <td align="left" width="350" height="14"> |
<td align="left" height="14" width="350"> |
| Pegasus/Config/DefaultPropertyTableHpux.h</td> | Pegasus/Config/DefaultPropertyTableHpux.h</td> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
| <td width="168" height="16">OpenVMS</td> |
<td height="16" width="168">OpenVMS</td> |
| <td align="left" width="350" height="16"> |
<td align="left" height="16" width="350"> |
| Pegasus/Config/DefaultPropertyTableVms.h</td> | Pegasus/Config/DefaultPropertyTableVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </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> |
|
|
|
| 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> |
|
|
|
| Pegasus/Config/SecurityPropertyOwner.cpp | Pegasus/Config/SecurityPropertyOwner.cpp |
| </ul> | </ul> |
| | |
| |
<h5>sslCipherSuite</h5> |
| |
<ul> |
| |
<b>Description: </b>String containing OpenSSL cipher |
| |
specifications to configure the cipher suite the client is |
| |
permitted to negotiate with the server during the SSL |
| |
handshake phase.<br> |
| |
<b>Recommended Default Value (Development Build): </b> |
| |
DEFAULT (the default cipher list of OpenSSL)<br> |
| |
<b>Recommended Default Value (Release Build): </b> |
| |
DEFAULT (the default cipher list of OpenSSL)<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>The value should be mentioned between |
| |
single quotes since it can contain special characters like .+, |
| |
!, -.. For more details look at SSL ciphers.<br> |
| |
<b>Source Configuration File: </b> |
| |
Pegasus/Config/SecurityPropertyOwner.cpp |
| |
</ul> |
| |
|
| <h5>sslClientVerificationMode</h5> | <h5>sslClientVerificationMode</h5> |
| <ul> | <ul> |
| <b>Description: </b>Describes the desired level of support | <b>Description: </b>Describes the desired level of support |
| for certificate-based authentication. | for certificate-based authentication. |
| <ul style="MARGIN-TOP: 0in" type="circle"> |
<ul style="margin-top: 0in;" type="circle"> |
| <li>“<b>required</b>” – The server requires certificate-based |
<li>“<b>required</b>” – The server requires certificate-based |
| client authentication. A client MUST present a | client authentication. A client MUST present a |
| trusted certificate in order to access the CIM Server. | trusted certificate in order to access the CIM Server. |
| If the client fails to send a certificate or sends an | If the client fails to send a certificate or sends an |
| untrusted certificate, the connection will be rejected.</li> | untrusted certificate, the connection will be rejected.</li> |
| <li>“<b>optional</b>” – The server supports, but does not |
<li>“<b>optional</b>” – The server supports, but does not |
| require, certificate-based client authentication. The | require, certificate-based client authentication. The |
| server will request and attempt to validate a client | server will request and attempt to validate a client |
| certificate, however the connection will be accepted even | certificate, however the connection will be accepted even |
| if no certificate is sent or an untrusted certificate is | if no certificate is sent or an untrusted certificate is |
| sent. The server will then seek to authenticate the | sent. The server will then seek to authenticate the |
| client via an authentication header.</li> | client via an authentication header.</li> |
| <li>“<b>disabled</b>” – The server does not support |
<li>“<b>disabled</b>” – The server does not support |
| certificate-based client authentication.</li> | certificate-based client authentication.</li> |
| </ul> | </ul> |
| <b>Recommended Default Value (Development Build): </b> | <b>Recommended Default Value (Development Build): </b> |
|
|
|
| <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>No<br> |
| <b>Considerations: </b>(1) This property is only used if | <b>Considerations: </b>(1) This property is only used if |
| <b>enableHttpsConnection</b> is <b>"true"</b>. |
<b>enableHttpsConnection</b> is <b>"true"</b>. |
| (2) If the platform does not support PEGASUS_LOCAL_DOMAIN_SOCKET, | (2) If the platform does not support PEGASUS_LOCAL_DOMAIN_SOCKET, |
| OpenPegasus attempts to use either HTTPS or | OpenPegasus attempts to use either HTTPS or |
| HTTP to establish a local connection (connectLocal). | HTTP to establish a local connection (connectLocal). |
| For platforms that do not support PEGASUS_LOCAL_DOMAIN_SOCKET, | For platforms that do not support PEGASUS_LOCAL_DOMAIN_SOCKET, |
| Clients which use connectLocal, such as cimconfig -l -c, | Clients which use connectLocal, such as cimconfig -l -c, |
| cimprovider -l -s and cimserver -s, will not work if the | cimprovider -l -s and cimserver -s, will not work if the |
| "sslClientVerificationMode" variable is set to |
"sslClientVerificationMode" variable is set to |
| "required" and HTTP is disabled. For these |
"required" and HTTP is disabled. For these |
| platforms, the recommended course of action is to change the | platforms, the recommended course of action is to change the |
| property value to "optional."<br> |
property value to "optional."<br> |
| <b>Source Configuration File: </b> | <b>Source Configuration File: </b> |
| Pegasus/Config/SecurityPropertyOwner.cpp | Pegasus/Config/SecurityPropertyOwner.cpp |
| </ul> | </ul> |
|
|
|
| <h5>traceFacility</h5> | <h5>traceFacility</h5> |
| <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> |
|
|
|
| <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>Yes<br> | <b>Dynamic?: </b>Yes<br> |
| <b>Case Sensitive?: </b>No<br> | <b>Case Sensitive?: </b>No<br> |
| <b>Considerations: </b>If you specify "File", |
<b>Considerations: </b>If you specify "File", |
| 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> |
|
|
|
| | |
| <h5>traceLevel</h5> | <h5>traceLevel</h5> |
| <ul> | <ul> |
| <b>Description: </b></b>Defines the desired level of |
<b>Description: </b>Defines the desired level of |
| tracing. Valid values include: 0, 1, 2, 3, 4, 5.<br> | tracing. Valid values include: 0, 1, 2, 3, 4, 5.<br> |
| <b>Default Value: </b>0<br> | <b>Default Value: </b>0<br> |
| <b>Recommended Default Value (Development Build): </b>0<br> | <b>Recommended Default Value (Development Build): </b>0<br> |
| <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>Yes<br> | <b>Dynamic?: </b>Yes<br> |
|
|
|
| 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> |
|
|
|
| $CONFIGDIR/cimserver_current.conf<br> | $CONFIGDIR/cimserver_current.conf<br> |
| <b>Dynamic?: </b>No <br> | <b>Dynamic?: </b>No <br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350"> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350> |
|
| Source Configuration File</th> | Source Configuration File</th> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/ConfigFileDirVms.h</td> | Pegasus/Config/ConfigFileDirVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h5>static char PLANNED_CONFIG_FILE [] = </h5> | <h5>static char PLANNED_CONFIG_FILE [] = </h5> |
|
|
|
| $CONFIGDIR/cimserver_planned.conf<br> | $CONFIGDIR/cimserver_planned.conf<br> |
| <b>Dynamic?: </b>No<br> | <b>Dynamic?: </b>No<br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350"> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350> |
|
| Source Configuration File</th> | Source Configuration File</th> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/ConfigFileDirVms.h</td> | Pegasus/Config/ConfigFileDirVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h5>static char CIMSERVER_START_FILE [] = </h5> | <h5>static char CIMSERVER_START_FILE [] = </h5> |
|
|
|
| $PIDFILE<br> | $PIDFILE<br> |
| <b>Dynamic?: </b>No<br> | <b>Dynamic?: </b>No<br> |
| <br> | <br> |
| <table border="1" cellspacing="1" bordercolordark="#666666" |
<table bordercolordark="#666666" bordercolorlight="#CCCCCC" style="font-family: Arial;" border="1" cellspacing="1" width="531"> |
| bordercolorlight="#CCCCCC" width=531 |
<tbody><tr> |
| style='font-size=10.0pt;font-family:Arial'> |
<th bgcolor="#cae6ca" width="168">Platform</th> |
| <tr> |
<th bgcolor="#cae6ca" width="350"> |
| <th bgcolor="#CAE6CA" width="168">Platform</th> |
|
| <th bgcolor="#CAE6CA" width=350> |
|
| Source Configuration File</th> | Source Configuration File</th> |
| </tr> | </tr> |
| <tr align="center"> | <tr align="center"> |
|
|
|
| <td align="left" width="350"> | <td align="left" width="350"> |
| Pegasus/Config/ConfigFileDirVms.h</td> | Pegasus/Config/ConfigFileDirVms.h</td> |
| </tr> | </tr> |
| </table> |
</tbody></table> |
| </ul> | </ul> |
| | |
| <h3>Configuration Macros</h3> | <h3>Configuration Macros</h3> |
|
|
|
| each system.<br> | each system.<br> |
| <b>Source Configuration File: </b> | <b>Source Configuration File: </b> |
| Pegasus/Common/Constants.h<b><br> | Pegasus/Common/Constants.h<b><br> |
| </ul> |
</b></ul> |
| | |
| <h5>PEGASUS_LOCAL_AUTH_DIR</h5> |
<h5><b>PEGASUS_LOCAL_AUTH_DIR</b></h5> |
| <ul> | <ul> |
| <b>Description:</b> </b>For local connections (i.e., |
<b> <b>Description:</b> </b>For local connections (i.e., |
| connectLocal), OpenPegasus uses a file-based authentication | connectLocal), OpenPegasus uses a file-based authentication |
| mechanism.<br> | mechanism.<br> |
| <b>Recommended Default Value (Development Build): </b>/tmp<br> | <b>Recommended Default Value (Development Build): </b>/tmp<br> |
|
|
|
| </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></html> |
| |
|
| </body> |
|
| </html> |
|
Return to
BuildAndReleaseOptions.html
CVS log
Up to [Pegasus] / pegasus / doc