version 1.4, 2008/12/16 18:55:33
|
version 1.7.14.1, 2013/10/15 06:49:24
|
|
|
<meta name="ProgId" content="FrontPage.Editor.Document"> | <meta name="ProgId" content="FrontPage.Editor.Document"> |
<meta http-equiv="Content-Type" | <meta http-equiv="Content-Type" |
content="text/html; charset=windows-1252"> | content="text/html; charset=windows-1252"> |
<title>OpenPegasus 2.6 README</title> |
<title>OpenPegasus 2.14 README</title> |
<link rel="stylesheet" | <link rel="stylesheet" |
href="http://www.opengroup.org/stylesheets/info1+margins.css"> | href="http://www.opengroup.org/stylesheets/info1+margins.css"> |
<style> | <style> |
|
|
</head> | </head> |
<body> | <body> |
<hr> | <hr> |
<p><b>Abstract:</b> Installation, build, and operation |
<p><b>Abstract:</b> Installation, build, |
|
and operation |
information on | information on |
the OpenPegasus Version 2.8.0 |
the OpenPegasus Version 2.14.0 |
Release. Note that if this readme | Release. Note that if this readme |
conflicts with the documentation in the release notes or interface | conflicts with the documentation in the release notes or interface |
definition documents for a particular release, those documents should | definition documents for a particular release, those documents should |
be considered authoritative. This is a simplified | be considered authoritative. This is a simplified |
overview to act as an | overview to act as an |
introduction to OpenPegasus.</p> | introduction to OpenPegasus.</p> |
|
|
<hr> | <hr> |
<p align="center"><b><font size="5">OpenPegasus - A Manageability |
<p align="center"><b><font size="5">OpenPegasus |
|
- A Manageability |
Services Broker for the DMTF CIM/WBEM Standards | Services Broker for the DMTF CIM/WBEM Standards |
</font></b></p> | </font></b></p> |
<p align="left"><b>Tagline:</b> OpenPegasus is an object manager for |
<p align="left"><b>Tagline:</b> OpenPegasus is |
|
an object manager for |
DMTF CIM objects written in C++ | DMTF CIM objects written in C++ |
and hosted by The Open Group </p> | and hosted by The Open Group </p> |
<a href="#Overview">OpenPegasus Overview</a> | <a href="#Overview">OpenPegasus Overview</a> |
|
|
about Building on Linux</a><br> | about Building on Linux</a><br> |
<a href="#bld_peg_win">Notes about Building | <a href="#bld_peg_win">Notes about Building |
on Windows</a><br> | on Windows</a><br> |
<blockquote style="margin-top: 0pt; margin-bottom: 0pt;"> <a |
<blockquote style="margin-top: 0pt; margin-bottom: 0pt;"> |
href="#mu_utility">The MU Utility</a><br> |
<a href="#mu_utility">The MU Utility</a><br> |
</blockquote> | </blockquote> |
<a href="#note_bld_peg_ssl">Notes about | <a href="#note_bld_peg_ssl">Notes about |
Building with SSL</a><br> | Building with SSL</a><br> |
|
|
href="#test_icu">Testing with ICU enabled</a><br> | href="#test_icu">Testing with ICU enabled</a><br> |
</blockquote> | </blockquote> |
<hr> | <hr> |
<h1><a name="Overview">OpenPegasus Overview</a> </h1> |
<h1><a name="Overview">OpenPegasus Overview</a> |
<div style="margin-left: 40px;"><b>OpenPegasus </b>(also referred to |
</h1> |
as <b>Pegasus</b>) is an open-source CIM Server for DMTF CIM objects. |
<div style="margin-left: 40px;"><b>OpenPegasus </b>(also |
|
referred to |
|
as <b>Pegasus</b>) is an open-source CIM Server for DMTF |
|
CIM objects. |
It is | It is |
written | written |
in C++ and includes the Object manager (CIMOM), a set of defined | in C++ and includes the Object manager (CIMOM), a set of defined |
|
|
exceptions | exceptions |
noted in the documentation.<br> | noted in the documentation.<br> |
<br> | <br> |
<span class="norm"></span>OpenPegasus includes components for: <br> |
<span class="norm"></span>OpenPegasus includes |
|
components for: <br> |
</div> | </div> |
<blockquote> | <blockquote> |
<ol style="margin-left: 40px;"> | <ol style="margin-left: 40px;"> |
<li>A DMTF compliant CIM Server that processes CIM operations, CIM |
<li>A DMTF compliant CIM Server that processes CIM |
|
operations, CIM |
Indications, and | Indications, and |
includes class and instance repositories and interfaces for creating | includes class and instance repositories and interfaces for creating |
CIM | CIM |
Providers and CIM Clients.</li> | Providers and CIM Clients.</li> |
<li>Provider interfaces so that providers may be build in multiple |
<li>Provider interfaces so that providers may be build in |
|
multiple |
languages (i.e. | languages (i.e. |
C++, C, Java).</li> | C++, C, Java).</li> |
<li>A number of CIM Providers.</li> | <li>A number of CIM Providers.</li> |
<li>A MOF compiler.</li> | <li>A MOF compiler.</li> |
<li>A number of CIM Clients to provide usage examples, CIM Server |
<li>A number of CIM Clients to provide usage examples, CIM |
|
Server |
test functions, | test functions, |
and administrative | and administrative |
functions.</li> | functions.</li> |
<li>More complete information on the exact functions | <li>More complete information on the exact functions |
and their functional state is available from the Release Notes | and their functional state is available from the Release Notes |
(pegasus/ReleaseNotes.htm) and the OpenPegasus |
(pegasus/ReleaseNotes.htm) and the OpenPegasus <a |
<a |
|
href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&ggid=799">Feature | href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&ggid=799">Feature |
Status Page</a>.</li> | Status Page</a>.</li> |
</ol> | </ol> |
</blockquote> | </blockquote> |
<div style="margin-left: 40px;">OpenPegasus is open source and is |
<div style="margin-left: 40px;">OpenPegasus is open source |
|
and is |
covered under the MIT open-source | covered under the MIT open-source |
license. | license. |
</div> | </div> |
<p style="margin-left: 40px;">OpenPegasus is being developed and |
<p style="margin-left: 40px;">OpenPegasus is being |
|
developed and |
maintained under the auspices of | maintained under the auspices of |
The | The |
Open | Open |
Group. OpenPegasus is maintained under the license defined in the |
Group. OpenPegasus is maintained under the license defined in |
|
the |
doc | doc |
directory of this release. The specific file is: <font | directory of this release. The specific file is: <font |
style="color: rgb(0, 0, 0);">pegasus/doc/license.txt</font>. | style="color: rgb(0, 0, 0);">pegasus/doc/license.txt</font>. |
|
|
wide a | wide a |
distribution as possible with minimal demands on the users. | distribution as possible with minimal demands on the users. |
</p> | </p> |
<p style="margin-left: 40px;">More information on this project, access |
<p style="margin-left: 40px;">More information on this |
|
project, access |
to the CVS, and | to the CVS, and |
documentation<span style="color: rgb(255, 0, 0);"><span | documentation<span style="color: rgb(255, 0, 0);"><span |
style="text-decoration: line-through;"></span></span> is available |
style="text-decoration: line-through;"></span></span> |
|
is available |
from the Ope<span style="color: rgb(255, 0, 0);"><span | from the Ope<span style="color: rgb(255, 0, 0);"><span |
style="text-decoration: line-through;"></span></span>nPegasus web |
style="text-decoration: line-through;"></span></span>nPegasus |
|
web |
site. | site. |
</p> | </p> |
<p style="margin-left: 40px;"> <a target="blank" |
<p style="margin-left: 40px;"> |
href="http://www.openpegasus.org/">http://www.openpegasus.org</a><br> |
<a target="blank" href="http://www.openpegasus.org/">http://www.openpegasus.org</a><br> |
</p> | </p> |
<p style="margin-left: 40px;">Note | <p style="margin-left: 40px;">Note |
that all references in this readme to files in the OpenPegasus source | that all references in this readme to files in the OpenPegasus source |
tree are of the form pegasus/..., where "pegasus" is the top-level | tree are of the form pegasus/..., where "pegasus" is the top-level |
directory and also the name of the OpenPegasus module in the Pegasus CVS |
directory and also the name of the OpenPegasus module in the Pegasus |
repository. There are also other CVS modules for the OpenPegasus Java client (pegasus-JavaCIMClient) |
CVS |
and for unsupported components and utilities for Pegasus that may be checked out |
repository. There are also other CVS modules for the |
|
OpenPegasus Java client (pegasus-JavaCIMClient) |
|
and for unsupported components and utilities for Pegasus that may be |
|
checked out |
separately. You can use | separately. You can use |
<a href="http://cvs.opengroup.org/cgi-bin/viewcvs.cgi/">viewCVS</a> to view the |
<a href="http://cvs.opengroup.org/cgi-bin/viewcvs.cgi/">viewCVS</a> |
|
to view the |
Pegasus CVS tree<br> | Pegasus CVS tree<br> |
</p> | </p> |
<h2><a name="avail_of_peg">Availability</a></h2> | <h2><a name="avail_of_peg">Availability</a></h2> |
<div style="margin-left: 40px;">OpenPegasus is distributed as open |
<div style="margin-left: 40px;">OpenPegasus is distributed |
|
as open |
source under the MIT open-source | source under the MIT open-source |
license. The distribution is available via CVS, and as snapshot images | license. The distribution is available via CVS, and as snapshot images |
in | in |
|
|
(<a href="mailto:%28k.m.kirk@opengroup.org">m.kirk@opengroup.org</a>) | (<a href="mailto:%28k.m.kirk@opengroup.org">m.kirk@opengroup.org</a>) |
</p> | </p> |
<h2><a name="peg_sup_plat">Supported Platforms</a></h2> | <h2><a name="peg_sup_plat">Supported Platforms</a></h2> |
<p style="margin-left: 40px;">OpenPegasus is regularly tested against a |
<p style="margin-left: 40px;">OpenPegasus is regularly |
|
tested against a |
variety of platforms by the | variety of platforms by the |
development group. The results of the nightly tests can be found |
development group. The results of the nightly tests can be |
|
found |
here on our <a | here on our <a |
href="http://cvs.opengroup.org/cgi-bin/pegasus-build-status.cgi">Nightly | href="http://cvs.opengroup.org/cgi-bin/pegasus-build-status.cgi">Nightly |
Build and Test Status</a> page. The Release Notes |
Build and Test Status</a> page. The Release Notes for each |
|
release |
(pegasus/ReleaseNotes.htm) provide additional details | (pegasus/ReleaseNotes.htm) provide additional details |
regarding the platforms for the current release.<br> |
regarding the platforms, compilers, etc. for the current release.<br> |
</p> | </p> |
<h2><a name="peg_dep">Dependencies</a></h2> | <h2><a name="peg_dep">Dependencies</a></h2> |
<p style="margin-left: 40px;"> | <p style="margin-left: 40px;"> |
We have worked to minimize the dependence of OpenPegasus on other | We have worked to minimize the dependence of OpenPegasus on other |
software | software |
packages and tools. Currently OpenPegasus has the following | packages and tools. Currently OpenPegasus has the following |
dependencies: |
dependencies. Note that all of the dependencis listed below are |
|
required only if selected options are enabled except for GNUMAKE which |
|
is the required make tool: |
</p> | </p> |
<ol style="margin-left: 40px;"> | <ol style="margin-left: 40px;"> |
<li><b>GNUMAKE</b> - To simplify the building of OpenPegasus across |
<li><b>GNUMAKE</b> - To simplify the building of |
|
OpenPegasus across |
multiple platforms we | multiple platforms we |
have standardized on a set of build tools including: GNUMAKE. We are | have standardized on a set of build tools including: GNUMAKE. We are |
using GNUMAKE 3.79.1 successfully both in Windows and Linux | using GNUMAKE 3.79.1 successfully both in Windows and Linux |
environments. It is available from <a href="http://www.gnu.org">http://www.gnu.org</a>. | environments. It is available from <a href="http://www.gnu.org">http://www.gnu.org</a>. |
The windows version of GNUMAKE is available on the Pegasus web site |
The windows version of GNUMAKE is available on the Pegasus |
<a href="http://www.openpegasus.org/pb/protected/index.tpl?CALLER=index.tpl"> |
web site <a |
|
href="http://www.openpegasus.org/pb/protected/index.tpl?CALLER=index.tpl"> |
tools page</a>.</li> | tools page</a>.</li> |
<li><b>FLEX</b> and <b>BISON</b> - These tools were used to develop the MOF |
<li><b>FLEX</b> and <b>BISON</b> - |
compiler and WQL and CQL parsers. These tools are required <b>ONLY</b> for |
These tools were used to develop the MOF |
development of the parsers, not for building OpenPegasus. Bison |
compiler and WQL and CQL parsers. These tools are required <b>ONLY</b> |
|
for |
|
development of the parsers, not for building OpenPegasus. |
|
Bison |
version 2.3 or later and flex version 2.5.4 or later are required.</li> | version 2.3 or later and flex version 2.5.4 or later are required.</li> |
<li><b>Doxygen </b>- The OpenPegasus documentation is taken from a combination |
<li><b>Doxygen </b>- The OpenPegasus documentation |
of text files and header files themselves. This documentation is formatted |
is taken from a combination of text files and header files themselves. |
with Doxygen and GAWK. This is required <b>ONLY</b> if you want to |
This documentation is formatted with Doxygen and GAWK. This |
build documentation from the source tree. <span class="norm"></span><font |
is required <b>ONLY</b> if you want to build documentation |
style="color: rgb(0, 0, 0);">These tools are required to build the |
from the source tree. <span class="norm"></span><font |
|
style="color: rgb(0, 0, 0);">These tools are required to |
|
build the |
interface documentation set.</font> </li> | interface documentation set.</font> </li> |
<li><b>ICU Internationalization libraries</b> - These libraries are |
<li><b>ICU Internationalization libraries</b> - |
|
These libraries are |
used as the basis for message catalogs for message | used as the basis for message catalogs for message |
internationalization. See the ICU website | internationalization. See the ICU website |
(<a href="http://icu.sourceforge.net/">http://icu.sourceforge.net</a>) | (<a href="http://icu.sourceforge.net/">http://icu.sourceforge.net</a>) |
for more information on these | for more information on these |
libraries.<span style="color: rgb(255, 0, 0);"> These libraries are use ONLY if |
libraries.<span style="color: rgb(255, 0, 0);"> These |
you set the requisite environment variable ( PEGASUS_HAS_ICU) to use ICU</span><br> |
libraries are used ONLY if you set the requisite environment variable ( |
|
PEGASUS_HAS_ICU) to use ICU</span><br> |
</li> | </li> |
<li><span style="font-weight: bold;"></span><b>OpenSSL </b>- If it |
<li><b>OpenSSL |
|
</b>- If it |
is intended to use SSL on the | is intended to use SSL on the |
communication protocol, the OpenSSL libraries are required (<a | communication protocol, the OpenSSL libraries are required (<a |
href="http://www.openssl.org">http://www.openssl.org</a>).</li> | href="http://www.openssl.org">http://www.openssl.org</a>).</li> |
<li><span style="font-weight: bold;">OpenSLP</span> - If you choose |
<li><span style="font-weight: bold;">OpenSLP</span> |
|
- If you choose |
to use | to use |
OpenSLP as your choice of SLP implementations, then it will need to be | OpenSLP as your choice of SLP implementations, then it will need to be |
installed and available to OpenPegasus. Refer to the | installed and available to OpenPegasus. Refer to the |
PEGASUS_USE_OPENSLP and PEGASUS_OPENSLP_HOME build variables in PEP |
PEGASUS_USE_OPENSLP and PEGASUS_OPENSLP_HOME build variables in the |
292, and the OpenSLP web site (<a href="http://www.openslp.org">http://www.openslp.org</a>).</li> |
doc/BuildAndReleaseOptions.html file, and the OpenSLP web site (<a |
<li><span style="font-weight: bold;">zlib</span> - If you choose to |
href="http://www.openslp.org">http://www.openslp.org</a>).</li> |
|
<li><span style="font-weight: bold;">zlib |
|
</span>- If you choose to |
enable the compressed repository feature with the | enable the compressed repository feature with the |
PEGASUS_ENABLE_COMPRESSED_REPOSITORY build variable, you will need to | PEGASUS_ENABLE_COMPRESSED_REPOSITORY build variable, you will need to |
install the gzip (GNU zip) compression utility. Refer to | install the gzip (GNU zip) compression utility. Refer to |
readme.compressed_repository in OpenPegasus source tree, and the gzip | readme.compressed_repository in OpenPegasus source tree, and the gzip |
web site (<a style="color: rgb(204, 51, 204);" | web site (<a style="color: rgb(204, 51, 204);" |
href="http://www.gzip.org">http://www.gzip.org</a>).<br> |
href="http://www.gzip.org">http://www.gzip.org</a>).</li> |
</li> |
<li><span style="font-weight: bold;">sqlite</span> |
|
- If you choose to enable the use of sqlite for the repository, refer |
|
to the doc/BuildAndReleaseOptions.html file for the defintion of the |
|
build variables and the sqlite implementation which may be obtained |
|
either as part of a standard distribution or from <a |
|
href="http://www.sqlite.org">http://www.sqlite.org</a>.</li> |
</ol> | </ol> |
<p style="margin-left: 40px;"><span style="font-weight: bold;">NOTE</span>: | <p style="margin-left: 40px;"><span style="font-weight: bold;">NOTE</span>: |
A set of the required | A set of the required |
|
|
</p> | </p> |
<h2><a name="cmnd">Commands</a></h2> | <h2><a name="cmnd">Commands</a></h2> |
<p style="margin-left: 40px;"> | <p style="margin-left: 40px;"> |
Pegasus includes the server which can be controlled from the command line and a |
Pegasus includes the server which can be controlled from the command |
|
line and a |
set of clients that provide adminstrative functions</p> | set of clients that provide adminstrative functions</p> |
<p style="margin-left: 40px;"> | <p style="margin-left: 40px;"> |
The manpages for each of the commands are in the pegasus/rpm/manLinux/ | The manpages for each of the commands are in the pegasus/rpm/manLinux/ |
directory (from CVS). </p> | directory (from CVS). </p> |
<p style="margin-left: 40px;">To see simple help for each command, |
<p style="margin-left: 40px;">To see simple help for each |
|
command, |
invoke it with the "--help" option.<br> | invoke it with the "--help" option.<br> |
</p> | </p> |
<div style="margin-left: 40px;"><span |
<div style="margin-left: 40px;"><span style="font-weight: bold;">Some |
style="font-family: times new roman;"></span><span |
of |
style="font-weight: bold;" class="norm"></span><span |
|
style="font-family: times new roman; font-weight: bold;"><span |
|
class="norm"></span></span><span style="font-weight: bold;">Some of |
|
the basic commands:</span> | the basic commands:</span> |
<br> | <br> |
</div> | </div> |
<ul> | <ul> |
<ul> | <ul> |
<li>cimserver (Start the server |
<li><span style="font-family: monospace;">cimserve</span>r |
|
(Start the server |
cimserver)</li> | cimserver)</li> |
<li>cimserver -s (Shuts down the cimserver)</li> |
<li><span style="font-family: monospace;">cimserver |
<li>cimserver traceLevel=4 traceComponents=ALL (Starts server |
-s</span> (Shuts down the cimserver)</li> |
|
<li><span style="font-family: monospace;">cimserver |
|
traceLevel=4 traceComponents=ALL</span> |
|
(Starts server |
with | with |
config flags)</li> | config flags)</li> |
</ul> | </ul> |
<ul> | <ul> |
<li>cimprovider -l -s (Lists providers and their status)</li> |
<li><span style="font-family: monospace;">cimprovider |
<li>cimprovider -e -m OperatingSystemModule (Enables the |
-l -s</span> (Lists providers and their |
|
status)</li> |
|
<li><span style="font-family: monospace;">cimprovider |
|
-e -m OperatingSystemModule</span> |
|
(Enables the |
OperatingSystem provider)</li> | OperatingSystem provider)</li> |
<li>cimuser -a -u guest _w <ThePassword> (Adds the user |
<li><span style="font-family: monospace;">cimuser |
<span |
-a -u guest -w <ThePassword></span> (Adds |
style="font-style: italic;">guest</span> with specified password)<br></li> |
the user <span style="font-style: italic;">guest</span> |
<li>cimuser -l (Lists the users )</li> |
with specified password)<br> |
<li>cimconfig -l -c (Lists the |
</li> |
current config options and their current values)<br></li> |
<li><span style="font-family: monospace;">cimuser |
|
-l</span> (Lists the users )</li> |
|
<li><span style="font-family: monospace;">cimconfig |
|
-l -c</span> (Lists the |
|
current config options and their current values)<br> |
|
</li> |
</ul> | </ul> |
</ul> | </ul> |
<div style="margin-left: 40px;"><span style="font-weight: bold;">NOTES</span>: | <div style="margin-left: 40px;"><span style="font-weight: bold;">NOTES</span>: |
|
|
</div> | </div> |
<blockquote> | <blockquote> |
<ol style="margin-left: 40px;"> | <ol style="margin-left: 40px;"> |
<li>Refer to the admin guide in pegasus/doc/Admin_Guide_Release.pdf |
<li>Refer to the admin guide in |
|
pegasus/doc/Admin_Guide_Release.pdf |
for | for |
more information about administering the OpenPegasus CIM Server.</li> | more information about administering the OpenPegasus CIM Server.</li> |
<li>There are some differences between Windows and other |
<li>There are differences between Windows and other |
platforms in | platforms in |
starting the server as a daemon/service. Whereas most supported |
starting the CIMserver as a daemon/service. Whereas most supported |
platforms use | platforms use |
the OpenPegasus <span style="font-weight: bold;">daemon</span> | the OpenPegasus <span style="font-weight: bold;">daemon</span> |
configuration option to start the CIM Server as a daemon, on | configuration option to start the CIM Server as a daemon, on |
|
|
started as a service (cimserver -start). The cimserver --help option | started as a service (cimserver -start). The cimserver --help option |
explains the | explains the |
exact format of the start and stop options.</li> | exact format of the start and stop options.</li> |
<li>The cimuser command is used to manage OpenPegasus users only when |
<li>The cimuser command is used to manage OpenPegasus users |
the CIM Server is compiled without the PEGASUS_PAM_AUTHENTICATION environment |
only when |
variable defined. See |
the CIM Server is compiled without the PEGASUS_PAM_AUTHENTICATION |
<a href="http://www.openpegasus.org/pp/uploads/40/16781/PEP308_RecommendedReleaseOptions.htm"> |
environment variable defined. See <a |
PEP 308</a> for more information on these configuration options.<br></li> |
href="http://www.openpegasus.org/pp/uploads/40/16781/PEP308_RecommendedReleaseOptions.htm"> |
|
PEP 308</a> for more information on these configuration options.<br> |
|
</li> |
</ol> | </ol> |
</blockquote> | </blockquote> |
<font><font color="RED"><span style="color: rgb(0, 0, 0);"></span></font></font><span |
<a name="docs">Documentation</a> |
style="font-family: monospace;"></span> |
<p style="margin-left: 40px;">Much |
<h2><a name="docs">Documentation</a></h2> |
|
<p style="margin-left: 40px;"><span |
|
style="color: rgb(255, 0, 0); text-decoration: line-through;"></span>Much |
|
of | of |
OpenPegasus | OpenPegasus |
is documented in the <a | is documented in the <a |
href="http://www.openpegasus.org/pp/index.tpl?CALLER=index.tpl">Pegasus | href="http://www.openpegasus.org/pp/index.tpl?CALLER=index.tpl">Pegasus |
Enhancement Process (PEPs)</a> which are the basis for approval of |
Enhancement Process (PEPs)</a> which are the basis for approval |
OpenPegasus functionality, changes, plans, etc. The approved PEPs |
of |
|
OpenPegasus functionality, changes, plans, etc. The approved |
|
PEPs |
are publicly available on the OpenPegasus web site.<span | are publicly available on the OpenPegasus web site.<span |
style="color: rgb(255, 0, 0);"><br> | style="color: rgb(255, 0, 0);"><br> |
</span></p> | </span></p> |
|
|
from the | from the |
source tree, see pegasus/doc/apidoc) and other miscellaneous | source tree, see pegasus/doc/apidoc) and other miscellaneous |
documentation | documentation |
in the doc directory. Also, there is a set of Release Notes for each |
in the CVS doc directory and the pegasus CVS root as readme files. |
|
Also, there is a set of Release Notes for each |
release in the OpenPegasus root | release in the OpenPegasus root |
source directory of CVS.</p> |
source directory of CVS and as a Pegasus PEP.</p> |
<p style="margin-left: 40px;">The <a |
|
href="http://www.openpegasus.org/">OpenPegasus web |
|
site</a> will be the source |
|
of most |
|
documentation in the future, and today is the source of most discussion |
|
and |
|
design documentation. </p> |
|
<h2><a name="part">How to Participate</a></h2> | <h2><a name="part">How to Participate</a></h2> |
<p style="margin-left: 40px;"><span class="norm"></span><font |
<p style="margin-left: 40px;"><font style="color: rgb(0, 0, 0);">Contributors |
style="color: rgb(0, 0, 0);">Contributors |
|
are welcome to participate in the OpenPegasus development effort. Join | are welcome to participate in the OpenPegasus development effort. Join |
the mailing list by going to the <a | the mailing list by going to the <a |
href="http://www.openpegasus.org/mailinglists.tpl?CALLER=index.tpl">Mailing | href="http://www.openpegasus.org/mailinglists.tpl?CALLER=index.tpl">Mailing |
|
|
<p style="margin-left: 40px;">Refer to the <a href="#avail_of_peg">Availability</a> | <p style="margin-left: 40px;">Refer to the <a href="#avail_of_peg">Availability</a> |
section for instructions on obtaining source code.<br> | section for instructions on obtaining source code.<br> |
</p> | </p> |
<p style="margin-left: 40px;">If you want to install pre-built Pegasus |
<p style="margin-left: 40px;">If you want to install |
|
pre-built Pegasus |
executables instead of building from source code, then refer to the <a | executables instead of building from source code, then refer to the <a |
href="http://www.openpegasus.org/pr/">RPM installation instructions</a>.<br> |
href="http://www.openpegasus.org/pr/">RPM installation |
|
instructions</a>.<br> |
</p> | </p> |
<h2><strong><strong><a name="vfy_req_sw"></a>Verify Dependencies</strong></strong><strong><strong><span |
<h2><strong><strong><a name="vfy_req_sw"></a>Verify |
|
Dependencies</strong></strong><strong><strong><span |
style="font-weight: normal;"></span></strong></strong></h2> | style="font-weight: normal;"></span></strong></strong></h2> |
<p style="margin-left: 40px;"><strong><strong><span | <p style="margin-left: 40px;"><strong><strong><span |
style="font-weight: normal;">Be</span></strong></strong>fore | style="font-weight: normal;">Be</span></strong></strong>fore |
|
|
the complete list.<br> | the complete list.<br> |
</p> | </p> |
<strong></strong> | <strong></strong> |
<h2><a name="set_envt_var"><strong>Set the Environment |
<h2><a name="set_envt_var"><strong>Set the |
|
Environment |
Variables</strong></a></h2> | Variables</strong></a></h2> |
<p style="margin-left: 40px;">Before building, installing, or running |
<p style="margin-left: 40px;">Before building, installing, |
|
or running |
OpenPegasus, some environment variables may | OpenPegasus, some environment variables may |
have to be defined or updated. See PEP 292 for the full list of |
have to be defined or updated. See PEP 292 for the full list |
|
of |
environment variables and configuration options for OpenPegasus. The | environment variables and configuration options for OpenPegasus. The |
minimum set is:<br> | minimum set is:<br> |
</p> | </p> |
|
|
that will contain all output from building and running OpenPegasus, it | that will contain all output from building and running OpenPegasus, it |
can be the same as PEGASUS_ROOT if desired.</li> | can be the same as PEGASUS_ROOT if desired.</li> |
<li>PEGASUS_PLATFORM -- The | <li>PEGASUS_PLATFORM -- The |
platform on which OpenPegasus is being built.<br> |
platform on which OpenPegasus is being built.</li> |
</li> |
|
</ul> | </ul> |
</ul> | </ul> |
|
<div style="margin-left: 40px;">There are a significant number of |
|
environment variables that control the compile and test of features in |
|
the OpenPegasus package in addition to the 3 variables described above. |
|
These variables are documented in the Pegasus documentation in CVS (see |
|
the pegasus/doc directory).</div> |
<h2><a name="bld_peg"></a>Build the Executables<br> | <h2><a name="bld_peg"></a>Build the Executables<br> |
</h2> | </h2> |
<div style="margin-left: 40px;">OpenPegasus | <div style="margin-left: 40px;">OpenPegasus |
is compiled and linked using a make structure that recurses through the |
is compiled and linked using a make structure that recurses through |
OpenPegasus source tree.<br> |
the OpenPegasus source tree.<br> |
<font><font color="RED"><span | <font><font color="RED"><span |
style="color: rgb(0, 0, 0); font-weight: bold;"><br> | style="color: rgb(0, 0, 0); font-weight: bold;"><br> |
Makefile commands | Makefile commands |
</span></font></font><br> | </span></font></font><br> |
<div style="margin-left: 40px;"><font><font color="RED"><span |
|
style="color: rgb(0, 0, 0); font-weight: bold;"></span></font></font></div> |
|
<br> | <br> |
Open<font><font color="RED"><span |
OpenPegasus |
style="color: rgb(0, 0, 0); font-weight: bold;"></span></font></font>Pegasus |
|
includes several Makefiles that enable | includes several Makefiles that enable |
you to quickly build or | you to quickly build or |
refresh files for the server, clients, providers, test cases, and | refresh files for the server, clients, providers, test cases, and |
|
|
<li>alltests - Builds the | <li>alltests - Builds the |
repository entries and other resources required by the tests, and then | repository entries and other resources required by the tests, and then |
executes all automated tests.</li> | executes all automated tests.</li> |
|
<li>world - Builds the complete environment and runs the test suite.</li> |
</ul> | </ul> |
<font><font color="RED"><span |
For a comprehensive |
style="color: rgb(0, 0, 0); font-weight: bold;"></span><span |
|
style="color: rgb(0, 0, 0);">For a comprehensive</span></font></font> |
|
list of the | list of the |
make targets, refer to pegasus/Makefile |
make targets, refer to <big><span |
at the top of the OpenPegasus source directory.<font><font color="RED"><span |
style="font-family: Courier New,Courier,monospace;">pegasus/Makefile</span></big> |
style="color: rgb(0, 0, 0);"></span></font></font><font |
at the top of the OpenPegasus source directory.<br> |
style="text-decoration: line-through; color: rgb(204, 51, 204);"><span |
|
style="font-weight: bold;"></span></font><br> |
|
</div> | </div> |
<ul> | <ul> |
</ul> | </ul> |
<h2><a name="pop_peg_rep">Populate the Repository</a> </h2> |
<h2><a name="pop_peg_rep">Populate the Repository</a> |
|
</h2> |
<p style="margin-left: 40px;"> | <p style="margin-left: 40px;"> |
Before using OpenPegasus you must populate the repository. Typically, | Before using OpenPegasus you must populate the repository. Typically, |
this | this |
is done during the build process by the 'make repository' target<span |
is done during the build process by the 'make repository' target. |
style="color: rgb(255, 0, 0);"><span |
However, |
style="text-decoration: line-through;"></span></span>. However, |
|
you | you |
can also compile MOF (Managed Object Format) code manually with the | can also compile MOF (Managed Object Format) code manually with the |
cimmof compiler.<br> | cimmof compiler.<br> |
</p> | </p> |
<p style="margin-left: 40px;">The 'make repository' target in pegasus<span |
<p style="margin-left: 40px;">The 'make repository' target |
style="color: rgb(255, 0, 0);"><span |
in the makefile <big><span |
style="text-decoration: line-through;"></span></span>/Makefile doe<span |
style="font-family: Courier New,Courier,monospace;">pegasus/Makefile</span></big> |
style="color: rgb(255, 0, 0);"><span |
performs several functions including: |
style="text-decoration: line-through;"></span></span>s several things: |
|
</p> | </p> |
<ul> | <ul> |
<ul> |
<li><span style="color: rgb(0, 0, 0);">Removes |
<li><span style="color: rgb(0, 0, 0);">Removes the existing |
the existing |
repository (if one exists).</span><br> | repository (if one exists).</span><br> |
</li> | </li> |
<li>Generates the default | <li>Generates the default |
CIM Schema (defined in pegasus/mak/config.mak) | CIM Schema (defined in pegasus/mak/config.mak) |
in the repository (skeleton of CIM | in the repository (skeleton of CIM |
objects). Refer to PEGASUS_CIM_SCHEMA environment variable in |
objects). Refer to PEGASUS_CIM_SCHEMA environment |
Pegasus PEP 308 to set alternate schema versions.<br> |
variable in Pegasus PEP 308 to |
|
set alternate schema versions.<br> |
</li> | </li> |
<li>Loads | <li>Loads |
schema for CIM Server functions (shutdown, add users, etc) and | schema for CIM Server functions (shutdown, add users, etc) and |
|
|
(SNMP, Events, Alert, Threshold, etc) | (SNMP, Events, Alert, Threshold, etc) |
internal to Pegasus. </li> | internal to Pegasus. </li> |
<li>Registers included CIM Providers (libOSProvider.so, | <li>Registers included CIM Providers (libOSProvider.so, |
libDNSProvider.so, … ) in OpenPegasus (which are located in |
libDNSProvider.so, … ) in OpenPegasus (which are located in |
src/Providers) <br> | src/Providers) <br> |
</li> | </li> |
</ul> | </ul> |
</ul> |
|
<h2><a name="reg_prov">Register | <h2><a name="reg_prov">Register |
Providers</a></h2> | Providers</a></h2> |
<p style="margin-left: 40px;">OpenPegasus registers Providers using a |
<p style="margin-left: 40px;">OpenPegasus registers |
|
Providers using a |
set of provider registration classes | set of provider registration classes |
encoded in MOF. This set of classes is close |
encoded in MOF. This classes are proprietary to OpenPegasus |
to, but not |
today. </p> |
exactly the same as, the experimental DMTF definition (See the DMTF |
|
Interop |
|
schema, experimental versions starting with 2.6). This will be |
|
harmonized in the future when the DMTF schema is moved to final |
|
status. </p> |
|
<p style="margin-left: 40px;">Registration | <p style="margin-left: 40px;">Registration |
is performed by creating instances of the | is performed by creating instances of the |
registration classes that represent the provider module, providers, | registration classes that represent the provider module, providers, |
capabilities, etc. to be | capabilities, etc. to be |
registered. The easiest way to create a new | registered. The easiest way to create a new |
registration today is to copy from one of the existing registration | registration today is to copy from one of the existing registration |
MOFs. See the src/Providers/sample/Load directory for examples of |
MOFs. See the <big><span |
|
style="font-family: Courier New,Courier,monospace;">pegasus/src/Providers/sample/Load</span></big> |
|
directory for examples of |
several registration instance implementations that do work with | several registration instance implementations that do work with |
OpenPegasus | OpenPegasus |
today.</p> | today.</p> |
|
<p style="margin-left: 40px;">Registration may be performed by creating |
|
compiling the registration mof with either the on-line or off-line |
|
Pegasus mof compiler. It is recommended that providers be |
|
registered with the on-line compiler because this allows pegasus to |
|
validate the registration information.</p> |
<h2><a name="note_bld_peg_lnx">Notes about | <h2><a name="note_bld_peg_lnx">Notes about |
Building on Linux </a></h2> | Building on Linux </a></h2> |
<p style="margin-left: 40px;"> | <p style="margin-left: 40px;"> |
To build OpenPegasus on Linux, ensure that you you have the necessary | To build OpenPegasus on Linux, ensure that you you have the necessary |
environment | environment |
variables set (eg. PEGASUS_HOME, PEGASUS_ROOT, PEGASUS_PLATFORM). |
variables set (eg. PEGASUS_HOME, PEGASUS_ROOT, |
|
PEGASUS_PLATFORM). |
For | For |
32 bit Linux, the definition of PEGASUS_PLATFORM is normally | 32 bit Linux, the definition of PEGASUS_PLATFORM is normally |
LINUX_IX86_GNU. For 64 bit IX86 Linux the definition of |
LINUX_IX86_GNU. For 64 bit IX86 Linux the |
|
definition |
|
of |
PEGASUS_PLATFORM is normally LINUX_IX86_64_GNU. Use the g++ | PEGASUS_PLATFORM is normally LINUX_IX86_64_GNU. Use the g++ |
compiler to compile and link the executables. All of the supported platform |
compiler to compile and link the executables. All of the supported |
definitions are defined in pegasus/mak as make files with the definition |
platform |
platform_<operatingSystem>_<architecture>_<compiler>. The <operatingSystem>_<architecture>_<compiler> |
definitions are defined in <big><span |
component is what forms the PEGASUS_PLATFORM environment variable so that the |
style="font-family: Courier New,Courier,monospace;">pegasus/mak</span></big> |
|
as make files with the |
|
definition:</p> |
|
<p style="margin-left: 40px;"> <span |
|
style="font-family: monospace;"> |
|
platform_<operatingSystem>_<architecture>_<compiler></span></p> |
|
<p style="margin-left: 40px;">The |
|
<operatingSystem>_<architecture>_<compiler> |
|
component is what forms the PEGASUS_PLATFORM environment variable so |
|
that the |
appropriate platform make file can be found during the build process.<br> | appropriate platform make file can be found during the build process.<br> |
</p> | </p> |
<h2><a name="bld_peg_win">Notes | <h2><a name="bld_peg_win">Notes |
about Building on Windows </a></h2> | about Building on Windows </a></h2> |
<p style="margin-left: 40px;"> | <p style="margin-left: 40px;"> |
Use of Windows 2000 SP3 or later is recommended. OpenPegasus is |
Use of Windows 2000 SP3 or later is recommended. OpenPegasus |
regularly tested on both Windows 2000 and Windows XP using the |
is |
Microsoft Visual C++ compilers.</p> |
regularly tested on mulitple windows platforms.</p> |
<p style="margin-left: 40px;">Today we build OpenPegasus on Windows |
<p style="margin-left: 40px;">We build OpenPegasus |
|
on Windows |
using a set of Makefiles | using a set of Makefiles |
contained | contained |
in the source distribution, the Microsoft compilers (DevStudio 5.x is | in the source distribution, the Microsoft compilers (DevStudio 5.x is |
not supported, Visual Studio 6.0 (SP5) or later is supported) and the | not supported, Visual Studio 6.0 (SP5) or later is supported) and the |
GNUMAKE | GNUMAKE |
make utility. Note that you MUST have the OpenPegasus <a | make utility. Note that you MUST have the OpenPegasus <a |
href="#mu_utility">mu.exe </a>utility compiled and available |
href="#mu_utility">mu.exe </a>utility compiled and |
before trying to compile OpenPegasus on the normal windows platform. |
available |
|
before trying to compile OpenPegasus on the normal windows platform |
|
(This utility allows use of unix command line semantics for certain |
|
operations in windows). |
The | The |
following is the basic setup steps for the environment. | following is the basic setup steps for the environment. |
</p> | </p> |
<p style="margin-left: 40px;">Setup the environment variables and path |
<p style="margin-left: 40px;">Setup the environment |
|
variables and path |
for the Micrososft Visual C | for the Micrososft Visual C |
compiler. | compiler. |
Typically this can be done by running the VCVARS32.BAT file supplied | Typically this can be done by running the VCVARS32.BAT file supplied |
with Microsoft Visual C++. (contained in the same directory as cl.exe). | with Microsoft Visual C++. (contained in the same directory as cl.exe). |
</p> | </p> |
<p style="margin-left: 40px;">For Windows, try the following for an |
<p style="margin-left: 40px;">For Windows, try the |
|
following for an |
example environment: </p> | example environment: </p> |
<blockquote> | <blockquote> |
<pre style="margin-left: 40px;">REM call the standard Microsoft .bat for VC 6 setup. <br>call 'C:/Program Files\Microsoft Visual Studio\VC98\Bin\Vcvars32.bat' <br>REM Set debug to something if you want to compile in debug mode <br>set PEGASUS_DEBUG=true <br>REM set PEGASUS_ROOT to top of source tree <br>set PEGASUS_ROOT=C:/cimom/pegasus (Note: <span |
<pre style="margin-left: 40px;"><span style="font-family: monospace;">REM call the standard Microsoft .bat for VC 6 setup. </span><br |
class="norm">The '/' characters are intentional and required by the OpenPegasus build system)</span><br>REM set PEGASUS_HOME to where you want repository and executables, it can be the same as PEGASUS_ROOT<br>set PEGASUS_HOME=%PEGASUS_ROOT% <br>REM set PEGASUS_PLATFORM for Windows<br |
style="font-family: monospace;"><span style="font-family: monospace;">call 'C:/Program Files\Microsoft Visual Studio\VC98\Bin\Vcvars32.bat' </span><br |
style="color: rgb(255, 0, 0);">set PEGASUS_PLATFORM=WIN32_IX86_MSVC<br>REM setup the path to the runtime files. <br>set path=%path%;%PEGASUS_HOME%\bin <br></pre> |
style="font-family: monospace;"><span style="font-family: monospace;">REM Set debug to something if you want to compile in debug mode </span><br |
|
style="font-family: monospace;"><span style="font-family: monospace;">set PEGASUS_DEBUG=true </span><br |
|
style="font-family: monospace;"><span style="font-family: monospace;">REM set PEGASUS_ROOT to top of source tree </span><br |
|
style="font-family: monospace;"><span style="font-family: monospace;">set PEGASUS_ROOT=C:/cimom/pegasus </span><br |
|
style="font-family: monospace;"><span style="font-family: monospace;">REM (Note: </span><span |
|
style="font-family: monospace;" class="norm">The '/' characters are intentional and required by the OpenPegasus build system). <br>REM Also the disk designator (C:) is required for at least some newer versions of the Microsoft<br>REM compilers to avoid confusion between options and paths<br></span><span |
|
style="font-family: monospace;">REM set PEGASUS_HOME to where you want repository and executables, it can be the same as PEGASUS_ROOT</span><br |
|
style="font-family: monospace;"><span style="font-family: monospace;">set PEGASUS_HOME=%PEGASUS_ROOT% </span><br |
|
style="font-family: monospace;"><span style="font-family: monospace;">REM set PEGASUS_PLATFORM for Windows</span><br |
|
style="color: rgb(255, 0, 0); font-family: monospace;"><span |
|
style="font-family: monospace;">set PEGASUS_PLATFORM=WIN32_IX86_MSVC</span><br |
|
style="font-family: monospace;"><span style="font-family: monospace;">REM setup the path to the runtime files. </span><br |
|
style="font-family: monospace;"><span style="font-family: monospace;">set path=%path%;%PEGASUS_HOME%\bin </span><br></pre> |
</blockquote> | </blockquote> |
<h3> | <h3> |
<a name="mu_utility">The MU Utility </a></h3> | <a name="mu_utility">The MU Utility </a></h3> |
|
|
commands. For example: | commands. For example: |
</p> | </p> |
<p style="margin-left: 40px;"><font face="Courier New"> | <p style="margin-left: 40px;"><font face="Courier New"> |
C:\> mu rm myfile.cpp yourfile.cpp </font> |
</font><span style="font-family: monospace;">C:\> |
</p> |
mu rm myfile.cpp yourfile.cpp</span> </p> |
<p style="margin-left: 40px;">You may type "mu" to get a list of valid |
<p style="margin-left: 40px;">You may type "mu" to get a |
|
list of valid |
commands. Here are some | commands. Here are some |
of them: | of them: |
</p> | </p> |
<p style="margin-left: 40px;"> | <p style="margin-left: 40px;"> |
rm, rmdirhier, mkdirhier, echo, touch, pwd, copy, move, compare depend | rm, rmdirhier, mkdirhier, echo, touch, pwd, copy, move, compare depend |
</p> | </p> |
<p style="margin-left: 40px;">The MU utility supports globing |
<p style="margin-left: 40px;">The MU utility supports |
|
globing |
(expansion of wildcards) so | (expansion of wildcards) so |
you can do things like this: | you can do things like this: |
</p> | </p> |
<p style="margin-left: 40px;"><font face="Courier New"> |
<p style="margin-left: 40px;"><font face="Courier New"> </font><span |
C:\> mu rm *.obj *.exe </font> |
style="font-family: monospace;"> |
</p> |
C:\> mu rm *.obj *.exe</span> </p> |
<p style="margin-left: 40px;">MU is required to build under the Windows |
<p style="margin-left: 40px;">MU is required to build |
|
under the Windows |
environment. MU is | environment. MU is |
available as part | available as part |
of the distribution of OpenPegasus.<br> | of the distribution of OpenPegasus.<br> |
</p> | </p> |
<div style="margin-left: 40px;">NOTE: The binary for MU.EXE is not |
<div style="margin-left: 40px;"><span style="font-weight: bold;">NOTE:</span> |
|
The binary for |
|
MU.EXE is not |
distributed in the OpenPegasus bin | distributed in the OpenPegasus bin |
directory. | directory. |
You must build it separately. MU source code is part of the | You must build it separately. MU source code is part of the |
|
|
for more details on build variables).<br> | for more details on build variables).<br> |
</p> | </p> |
<p style="margin-left: 40px;">You | <p style="margin-left: 40px;">You |
must also have the PEGASUS_HAS_SSL environment variable defined. Then when you |
must also have the PEGASUS_HAS_SSL environment variable defined. Then |
|
when you |
build | build |
OpenPegasus, it | OpenPegasus, it |
will include the SSL support. | will include the SSL support. |
</p> | </p> |
<div style="margin-left: 40px;">Refer to the OpenPegasus SSL Guide |
<div style="margin-left: 40px;">Refer to the OpenPegasus |
|
SSL Guide |
(found in doc/PegasusSSLGuidelines.htm) | (found in doc/PegasusSSLGuidelines.htm) |
for details on | for details on |
using OpenPegasus with SSL, | using OpenPegasus with SSL, |
|
|
CVS | CVS |
environment, including: | environment, including: |
</p> | </p> |
|
<div style="margin-left: 40px;"> |
<ul> | <ul> |
<ul> |
<li><b>Test Clients</b> - There are several |
<li><b>Test Clients</b> - There are several clients that have been |
clients that have been |
built specifically to test OpenPegasus, or parts of OpenPegasus, | built specifically to test OpenPegasus, or parts of OpenPegasus, |
including | including |
TestClient, Client, cimcli, ipinfo, | TestClient, Client, cimcli, ipinfo, |
|
|
these tests use classes and instances that are only installed with the | these tests use classes and instances that are only installed with the |
"make testrepository" target including: test namespaces, extra | "make testrepository" target including: test namespaces, extra |
classes and instances in those namespaces, and additional sample and | classes and instances in those namespaces, and additional sample and |
test providers.<span |
test providers.</li> |
style="color: rgb(255, 0, 0); text-decoration: line-through;"></span> </li> |
</ul> |
<li><b>Sample and Test Providers</b> - Test providers exist |
</div> |
|
<div style="margin-left: 40px;"> |
|
<ul> |
|
<li><b>Sample and Test Providers</b> - |
|
Test providers exist |
for | for |
the major provider types in the src/Providers/sample | the major provider types in the src/Providers/sample |
and src/Providers/TestProviders directories. </li> | and src/Providers/TestProviders directories. </li> |
<li><b>Unit Tests</b> - Most OpenPegasus functions include unit |
</ul> |
|
</div> |
|
<ul> |
|
<ul> |
|
</ul> |
|
</ul> |
|
<div style="margin-left: 40px;"> |
|
<ul> |
|
<li><b>Unit Tests</b> - Most OpenPegasus |
|
functions include unit |
tests | tests |
for | for |
the functions. These are normally executed with the "make | the functions. These are normally executed with the "make |
|
|
directory). Unit tests are executed with the CIM Server shutdown and | directory). Unit tests are executed with the CIM Server shutdown and |
normally do not require the existence of class definitions in the | normally do not require the existence of class definitions in the |
repository. </li> | repository. </li> |
<li><b>End-to-end Test Suite</b> - the directory "test" contains |
</ul> |
|
</div> |
|
<ul style="margin-left: 40px;"> |
|
<li><b>End-to-end Test Suite</b> - the directory |
|
"test" contains |
a | a |
set of operatio<span |
set of operation |
style="color: rgb(255, 0, 0); text-decoration: line-through;"></span>n |
tests that cover the major CIM Operations. See |
tests that cover the major CIM Operations. See<span |
|
style="color: rgb(255, 0, 0); text-decoration: line-through;"></span> |
|
TestMakefile in the PEGASUS_ROOT directory to execute | TestMakefile in the PEGASUS_ROOT directory to execute |
these tests. This set of tests executes an extensive set of fixed |
these tests. This set of tests executes an extensive set of |
|
fixed |
tests and compares the results against predefined results.</li> | tests and compares the results against predefined results.</li> |
</ul> | </ul> |
</ul> |
<p> |
<p> Once OpenPegasus is |
Once OpenPegasus is |
successfully built, the tests can be executed through the root Makefile |
successfully built, the tests can be executed through the |
|
root Makefile |
with targets such as:</p> | with targets such as:</p> |
<blockquote> | <blockquote> |
<blockquote> |
|
<ul> | <ul> |
<li><b>make unittests </b>- Execute the unit tests. These do not depend |
</ul> |
on having a running server or repository installed. They test |
<ul> |
components of the OpenPegasus code. These tests run to completion if |
<li><b>make unittests </b>- Execute the unit |
successful but normally stop on the first error found by a test |
tests. These do not depend on having a running server or repository |
program.</li> |
installed. They test components of the OpenPegasus code. |
<li><b>make servertests</b> - Executes the OpenPegasus end-to-end test |
These tests run to completion if successful but normally stop on the |
suite against a running OpenPegasus server starting and stopping the |
first error found by a test program.</li> |
server as required to modify configuration parameters. The |
<ul> |
repository must be installed for these tests to execute and they are |
</ul> |
tested against the default repository as part of regular OpenPegasus |
|
development and release testing. These tests will run to successful |
|
completion if there are not errors detected but will normally stop |
|
on the first error. There is a subset of these tests that can |
|
be run in an environment that does not have root privileges but root |
|
privileges are required to run the complete suite.</li> |
|
<li><b>make alltests</b> - execute both the unit and end-to-end tests.</li> |
|
</ul> | </ul> |
</blockquote> | </blockquote> |
|
<blockquote> |
|
<ul> |
|
<li><b>make servertests</b> - Executes the |
|
OpenPegasus end-to-end test suite against a running OpenPegasus server |
|
starting and stopping the server as required to modify configuration |
|
parameters. The repository must be installed for these tests to execute |
|
and they are tested against the default repository as part of regular |
|
OpenPegasus development and release testing. These tests will run to |
|
successful completion if there are not errors detected but will |
|
normally stop on the first error. There is a subset of these |
|
tests that can be run in an environment that does not have root |
|
privileges but root privileges are required to run the complete suite.</li> |
|
</ul> |
</blockquote> | </blockquote> |
|
<ul> |
|
</ul> |
|
<ul style="margin-left: 40px;"> |
|
<li><b>make alltests</b> - execute both the |
|
unit and end-to-end tests.</li> |
|
</ul> |
<h2><a name="test_icu">Testing with ICU enabled</a></h2> | <h2><a name="test_icu">Testing with ICU enabled</a></h2> |
<p style="margin-left: 40px;">ICU (International Components for |
<p style="margin-left: 40px;">ICU (International |
|
Components for |
Unicode) refers to the set of | Unicode) refers to the set of |
libraries that OpenPegasus uses to run with globalization support. For | libraries that OpenPegasus uses to run with globalization support. For |
example, these | example, these |
|
|
pegasus/docs | pegasus/docs |
directory for details.<br> | directory for details.<br> |
</p> | </p> |
<p style="margin-left: 40px;">When users run "make servertests" |
<p style="margin-left: 40px;">When users run "make |
|
servertests" |
to verify the integrity of an OpenPegasus download, a series of tests | to verify the integrity of an OpenPegasus download, a series of tests |
are | are |
run that | run that |
|
|
for PEGASUS_MSG_HOME.<font style="color: rgb(0, 0, 0);"><br> | for PEGASUS_MSG_HOME.<font style="color: rgb(0, 0, 0);"><br> |
</font></p> | </font></p> |
<hr> | <hr> |
<p><br> |
<p>Licensed to The Open Group (TOG) under one or more contributor |
Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;<br> |
license |
EMC Corporation; Symantec Corporation; The Open Group.<br> |
agreements. Refer to the OpenPegasusNOTICE.txt file distributed with |
<br> |
this work for additional information regarding copyright ownership. |
Permission is hereby granted, free of charge, to any person obtaining a |
Each contributor licenses this file to you under the OpenPegasus Open |
copy<br> |
Source License; you may not use this file except in compliance with the |
of this software and associated documentation files (the "Software"), to<br> |
License.</p> |
deal in the Software without restriction, including without limitation |
<p>Permission is hereby granted, free of charge, to any person |
the<br> |
obtaining a |
rights to use, copy, modify, merge, publish, distribute, sublicense, |
copy of this software and associated documentation files (the |
and/or<br> |
"Software"), |
sell copies of the Software, and to permit persons to whom the Software |
to deal in the Software without restriction, including without |
is<br> |
limitation |
furnished to do so, subject to the following conditions:<br> |
the rights to use, copy, modify, merge, publish, distribute, |
<br> |
sublicense, |
THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED |
and/or sell copies of the Software, and to permit persons to whom the |
IN<br> |
Software is furnished to do so, subject to the following conditions:</p> |
ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS |
<p>The above copyright notice and this permission notice shall be |
PROVIDED<br> |
included |
"AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING |
in all copies or substantial portions of the Software.</p> |
BUT NOT<br> |
<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY |
LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR<br> |
KIND, EXPRESS |
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT<br> |
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN |
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
AN<br> |
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY |
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN |
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, |
CONNECTION<br> |
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE |
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> |