|
version 1.24, 2011/01/12 13:30:19
|
version 1.24.2.8, 2014/05/05 21:03:29
|
|
|
|
| <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_SH4_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>CIM236 (Note that this may change as newer versions of the CIM Schema are used as the default.<br> |
| <b>Recommended Value (Development Build): </b> | <b>Recommended Value (Development Build): </b> |
| No Specific Recommendation<br> | No Specific Recommendation<br> |
| <b>Recommended Value (Release Build): </b> | <b>Recommended Value (Release Build): </b> |
| 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> |
| | |
|
|
|
| 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_INTERNAL_BINARY</h5> |
|
| <ul> |
|
| <b>Description: </b>If true, OpenPegasus uses a faster binary |
|
| protocol between the CIM server and provider manager. If false, |
|
| OpenPegasus uses the older XML-based protocol instead. |
|
| <br> |
|
| <b>Default Value: </b>true<br> |
|
| <b>Recommended Value (Development Build): </b>true<br> |
|
| <b>Recommended Value (Release Build): </b>true<br> |
|
| <b>Required: </b>No<br> |
|
| <b>Considerations: </b>This option improves performance by optimizing the |
|
| serialization and deserialization of messages between the server and |
|
| out-of-process providers. |
|
| <br> |
|
| </ul> |
|
| |
|
| <h5>PEGASUS_ENABLE_PROTOCOL_BINARY</h5> | <h5>PEGASUS_ENABLE_PROTOCOL_BINARY</h5> |
| <ul> | <ul> |
| <b>Description: </b>If true, OpenPegasus uses a faster binary | <b>Description: </b>If true, OpenPegasus uses a faster binary |
| protocol between local clients (including the provider agent) and the |
protocol between local clients and the CIM server. If false, OpenPegasus |
| CIM server. If false, OpenPegasus uses the conventional XML-based protocol |
uses the conventional XML-based protocol instead. |
| instead. See PEP#340 for more details. |
See PEP#340 for more details. |
| <br> | <br> |
| <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> |
|
|
|
| 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> |
|
|
|
| releases. Also note the known limitations specified in PEP 311.<br> | releases. Also note the known limitations specified in PEP 311.<br> |
| </ul> | </ul> |
| | |
| |
<h5>PEGASUS_ENABLE_PROTOCOL_WEB</h5> |
| |
<ul> |
| |
<b>Description: </b>Enable pegasus to act as webserver capable |
| |
of serving webpages by comsuming the JSON output from CIM-RS.<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> When authentication is disabled, Anybody can |
| |
modify the pegasus cimserver. Please enable authentication when using |
| |
webadmin to prevent unauthorized access. <br> |
| |
</ul> |
| |
|
| |
|
| <h5>PEGASUS_ENABLE_REMOTE_CMPI</h5> | <h5>PEGASUS_ENABLE_REMOTE_CMPI</h5> |
| <ul> | <ul> |
| <b>Description: </b>If set, a version of OpenPegasus that | <b>Description: </b>If set, a version of OpenPegasus that |
|
|
|
| <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 |
|
|
|
| CIM_ERR_NOT_SUPPORTED.<br> | CIM_ERR_NOT_SUPPORTED.<br> |
| </ul> | </ul> |
| | |
| <h5>PEGASUS_ENABLE_SSLV2</h5> |
|
| <ul> |
|
| <b>Description: </b>By default, support for the SSLV2 protocol |
|
| is disabled in OpenPegasus. The option can be used to build a |
|
| version of OpenPegasus that supports SSLV2. This variable affects |
|
| how SSL contexts are constructed for both the CIM Server and CIM |
|
| Clients.<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> Unless SSLV2 is required for backward |
|
| compatibility, enabling this protocol is not recommended (SSLV3 |
|
| or later is preferred). |
|
| </ul> |
|
| |
|
| <h5>PEGASUS_ENABLE_USERGROUP_AUTHORIZATION</h5> | <h5>PEGASUS_ENABLE_USERGROUP_AUTHORIZATION</h5> |
| <ul> | <ul> |
| <b>Description: </b>Builds a version of OpenPegasus that | <b>Description: </b>Builds a version of OpenPegasus that |
|
|
|
| <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> |
|
| |
|
| <h5>PEGASUS_INDICATIONS_Q_THRESHOLD</h5> |
|
| <ul> |
|
| <b>Description: </b>Controls if indications providers are stalled |
|
| if the indications service queue is too large. It can be set |
|
| to any positive value. If not set providers are never |
|
| stalled. This implies that the indications service |
|
| queue may become as large as necessary to hold all the |
|
| indications generated. If set to any value then |
|
| providers are stalled by forcing them to sleep when they |
|
| try to deliver an indication and the indications service |
|
| queue exceeds this value. They are resumed when the queue |
|
| count falls 10 percent below this value. Stall and resume log |
|
| entries are made to inform the administrator the condition has |
|
| occurred.<br> |
|
| <b>Default Value: </b>Not Set<br> |
|
| <b>Recommended Value (Development Build): </b>Not Set<br> |
|
| <b>Recommended Value (Release Build): </b>Not Set<br> |
|
| <b>Required: </b>No<br> |
|
| <b>Considerations: </b>Use of this setting may have |
|
| unintended side-effects when using Out-of-Process Providers |
|
| including delayed processing of CIM Operation Requests. |
|
| </ul> | </ul> |
| | |
| <h5>PEGASUS_MAX_THREADS_PER_SVC_QUEUE</h5> | <h5>PEGASUS_MAX_THREADS_PER_SVC_QUEUE</h5> |
|
|
|
| <h5>PEGASUS_NOASSERTS</h5> | <h5>PEGASUS_NOASSERTS</h5> |
| <ul> | <ul> |
| <b>Description: </b>Defines the NDEBUG compilation macro, which | <b>Description: </b>Defines the NDEBUG compilation macro, which |
| causes the preprocessor to remove PEGASUS_ASSERT() statements.<br> |
causes the preprocessor to remove PEGASUS_ASSERT() and disables assertion |
| |
on PEGASUS_FCT_EXECUTE_AND_ASSERT statements.<br> |
| <b>Default Value: </b>Not Set<br> | <b>Default Value: </b>Not Set<br> |
| <b>Recommended Value (Development Build): </b>Not Set<br> | <b>Recommended Value (Development Build): </b>Not Set<br> |
| <b>Recommended Value (Release Build): </b>Set<br> | <b>Recommended Value (Release Build): </b>Set<br> |
|
|
|
| dependent on platform support for PAM.<br> | dependent on platform support for PAM.<br> |
| </ul> | </ul> |
| | |
| |
<h5>PEGASUS_PAM_SESSION_SECURITY</h5> |
| |
<ul> |
| |
<b>Description: </b>Enables support for PAM-(Pluggable |
| |
Authentication Modules) based authentication and authorization.<br> |
| |
When choosing this PAM method the PAM session started through pam_start |
| |
is kept open for the complete CIM request. |
| |
The PAM item PAM_RHOST will be set to the connection IP address. |
| |
This allows PAM modules to restrict number of concurrent connections |
| |
from a single host.<br> |
| |
If PEGASUS_PAM_SESSION_SECURITY is set, you cannot enable the Privilege |
| |
Separation feature (PEGASUS_ENABLE_PRIVILEGE_SEPARATION) or the |
| |
authentication-only PAM mechanism (PEGASUS_PAM_AUTHENTICATION).<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>Support for PAM in OpenPegasus is |
| |
dependent on platform support for PAM.<br> |
| |
</ul> |
| |
|
| <h5>PEGASUS_PLATFORM</h5> | <h5>PEGASUS_PLATFORM</h5> |
| <ul> | <ul> |
| <b>Description: </b>Describes the target platform for the | <b>Description: </b>Describes the target platform for the |
|
|
|
| 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 |
|
|
|
| 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> | <h5>PEGASUS_ENABLE_NET_SNMPV3</h5> |
| <ul> | <ul> |
|
|
|
| <b>Required: </b>No<p> | <b>Required: </b>No<p> |
| <b>Considerations: </b>PEGASUS_USE_NET_SNMP variable must | <b>Considerations: </b>PEGASUS_USE_NET_SNMP variable must |
| be set.<br> | be set.<br> |
| </ul> |
</p></ul> |
| | |
| | |
| <h5>PEGASUS_USE_OPENSLP</h5> | <h5>PEGASUS_USE_OPENSLP</h5> |
|
|
|
| <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>false<br> | <b>Default Value: </b>false<br> |
| <b>Recommended Value (Development Build): </b>false<br> | <b>Recommended Value (Development Build): </b>false<br> |
|
|
|
| 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> |
|
|
|
| <b>Default Value: </b>262144<br> | <b>Default Value: </b>262144<br> |
| <b>Recommended Value (Development Build): </b>262144<br> | <b>Recommended Value (Development Build): </b>262144<br> |
| <b>Recommended Value (Release Build): </b>262144<br> | <b>Recommended Value (Release Build): </b>262144<br> |
| <b>Required: </b>No </p> |
<b>Required: </b>No <p></p> |
| </ul> | </ul> |
| | |
| <h4>Examples Building a Linux IA32 (#IA64) Development/Debug Version</h4> | <h4>Examples Building a Linux IA32 (#IA64) Development/Debug Version</h4> |
|
|
|
| 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> |
<tr align="center"> |
| |
<td align="left" height="14" width="1">$WEBCONFDIR</td> |
| |
</tr> |
| |
|
| |
</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> |
|
|
|
| if exception or timeout happens. There is no automatic recovery from | if exception or timeout happens. There is no automatic recovery from |
| degraded state is available at present.<br> | 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> |
|
|
|
| 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> |
|
|
|
| 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> |
|
|
|
| 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> |
|
|
|
| the ultimate goal SHALL be fixing the faulty provider. | the ultimate goal SHALL be fixing the faulty provider. |
| </ul> | </ul> |
| | |
| |
<h5>maxIndicationDeliveryRetryAttempts</h5> |
| |
<ul> |
| |
<b>Description: </b> If set to a positive integer, value defines the number |
| |
of times indication service will enable the reliableIndication feature and try |
| |
to deliver an indication to a particular listener destination. |
| |
This does not effect the original delivery attempt. A value of disables |
| |
reliable indication feature completely, and cimserver will deliver the |
| |
indication once.This is in accord with DTMF Specification 1054, |
| |
Indication Profile, version 1.2.1.<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> |
| |
|
| <h5>logdir</h5> | <h5>logdir</h5> |
| <ul> | <ul> |
| <b>Description: </b>Specifies the name of the directory | <b>Description: </b>Specifies the name of the directory |
|
|
|
| four. In this case though new provider processes will not be created | four. In this case though new provider processes will not be created |
| but existing five will continue running<br> | 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> |
|
|
|
| <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> |
|
|
|
| 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>sslBackwardCompatibility</h5> |
| |
<ul> |
| |
<b>Description: </b> If set to true, OpenPegasus support |
| |
SSLv3 and TLSv1 protocol.If set to false OpenPegasus support |
| |
only TLS1.2 protocol for openssl 1.0.1+ <br> |
| |
<b>Recommended Default Value (Development 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 (Release Build): </b>No/No<br> |
| |
<b>Dynamic?: </b>No<br> |
| |
<b>Considerations: </b> For a more detailed look at SSL options |
| |
and their ramifications, please see the SSL guidelines.<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" |
| , "Log" and "Memory" .<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. If you specify Memory, the trace messages | OpenPegasus Log. If you specify Memory, the trace messages |
| are collected in a wrap-around memory buffer. | are collected in a wrap-around memory buffer. |
| If this memory is part of a dump the trace messages can be | If this memory is part of a dump the trace messages can be |
| found by the eye-catcher "PEGASUSMEMTRACE" at |
found by the eye-catcher "PEGASUSMEMTRACE" at |
| the top of the memory buffer. The trace is in clear text and | the top of the memory buffer. The trace is in clear text and |
| the last written message has the suffix "EOTRACE".<br> |
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>traceFileSizeKBytes</h5> |
| |
<ul> |
| |
<b>Description: </b>Defines the size of the tracefile in Kilo bytes. The trace file will be |
| |
rolled once its size exceeds the specified size. <br> |
| |
<b>Default Value: </b>1048576<br> |
| |
<b>Recommended Default Value (Development Build): </b>1048576<br> |
| |
<b>Recommended Default Value (Release Build): </b>1048576<br> |
| |
<b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br> |
| |
<b>Recommend To Be Fixed/Hidden (Release Build):</b> No/Yes<br> |
| |
<b>Dynamic?:</b> Yes<br> |
| |
<b>Considerations:</b>Minimum accepted value is 10240 KB,Maximum accepted value is 2097152 KB. <br> |
| |
<b>Source Configuration File:</b> Pegsus/Config/TracePropertyOwner.cpp<p> </p> |
| |
</ul> |
| |
|
| |
<h5>numberOfTraceFiles</h5> |
| |
<ul> |
| |
<b>Description: </b>Specifies the number of the tracefiles for rolling.<br> |
| |
<b>Default Value: </b>3<br> |
| |
<b>Recommended Default Value (Development Build): </b>3<br> |
| |
<b>Recommended Default Value (Release Build): </b>3<br> |
| |
<b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br> |
| |
<b>Recommend To Be Fixed/Hidden (Release Build):</b> No/Yes<br> |
| |
<b>Dynamic?:</b> Yes<br> |
| |
<b>Considerations:</b>Minimum accepted value is 3,Maximum accepted value is 20. <br> |
| |
<b>Source Configuration File:</b> Pegsus/Config/TracePropertyOwner.cpp<p> </p> |
| |
</ul> |
| |
|
| |
<h5>webRoot</h5> |
| |
<ul> |
| |
<b>Description: </b> Points to a location where the static web pages to |
| |
be served by the pegasus webserver are stored.<br> |
| |
<b>Default Value: </b>www<br> |
| |
<b>Recommended Default Value (Development Build): </b>www<br> |
| |
<b>Recommended Default Value (Release Build): </b>$WEBCONFDIR/www<br> |
| |
<b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br> |
| |
<b>Recommend To Be Fixed/Hidden (Release Build):</b> Yes/Yes<br> |
| |
<b>Dynamic?:</b> No<br> |
| |
<b>Considerations:</b> When not fixed and hidden, it can be modified to |
| |
point to a location having spurious pages. Please consider fixing this value. <br> |
| |
<b>Source Configuration File:</b> Pegsus/Config/DefaultPropertyOwner.cpp<p> </p> |
| |
</ul> |
| |
|
| |
<h5>indexFile</h5> |
| |
<ul> |
| |
<b>Description: </b> Specifies the name of index file used by pegasus webserver, |
| |
default to index.html. This file should be available at the webRoot path.<br> |
| |
<b>Default Value: </b>index.html<br> |
| |
<b>Recommended Default Value (Development Build): </b>index.html<br> |
| |
<b>Recommended Default Value (Release Build): </b>index.html<br> |
| |
<b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br> |
| |
<b>Recommend To Be Fixed/Hidden (Release Build):</b> Yes/Yes<br> |
| |
<b>Dynamic?:</b> No<br> |
| |
<b>Considerations:</b> Hide it and fixed in release build to prevent |
| |
using any file as index file<br> |
| |
<b>Source Configuration File:</b> Pegsus/Config/DefaultPropertyOwner.cpp<p> </p> |
| |
</ul> |
| |
|
| |
<h5>mimeTypesFile</h5> |
| |
<ul> |
| |
<b>Description: </b> Refers to the file which holds the mime types being |
| |
served by the pegasus webserver.<br> |
| |
<b>Default Value: </b>www/mimeTypes.txt<br> |
| |
<b>Recommended Default Value (Development Build): </b>www/mimeTypes.txt<br> |
| |
<b>Recommended Default Value (Release |
| |
Build): </b>$WEBCONFDIR/www/mimeTypes.txt<br> |
| |
<b>Recommend To Be Fixed/Hidden (Development Build): </b>No/No<br> |
| |
<b>Recommend To Be Fixed/Hidden (Release Build):</b> Yes/Yes<br> |
| |
<b>Dynamic?:</b> No<br> |
| |
<b>Considerations:</b> Fix and make it read only when to prevent |
| |
modification in deployment<br> |
| |
<b>Source Configuration File:</b> Pegsus/Config/DefaultPropertyOwner.cpp<p> </p> |
| |
</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> |
|
|
|
| TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE | TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE |
| SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p> | SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p> |
| <hr> | <hr> |
| </body> |
</body></html> |
| </html> |
|
Return to
BuildAndReleaseOptions.html
CVS log
Up to [Pegasus] / pegasus / doc