pegasus/Attic/readme.html - diff

Return to readme.html CVS log

Up to [Pegasus] / pegasus / Attic

Diff for /pegasus/Attic/readme.html between version 1.1 and 1.5

version 1.1, 2003/11/13 16:02:37

version 1.5, 2004/03/10 19:24:13

Line 13

PEP #: 103

Title: OpenPegasus Version 2.3

Release Readme file

Version: 1.0

Version: 1.1

Created: 12 November 2003

Authors: Karl Schopmeyer

Authors: Karl Schopmeyer, Konrad Rzeszutek

Status:  draft

Version History:

<table border="1" cellspacing="1" bordercolordark="#666666"

Line 29

</tr>

<tr>

<td align="center">12 Novemberl 2003</td>

<td align="center">12 November 2003</td>

<td align="center">Karl Schopmeyer</td>

<td>Update from 2.2 Release notes. Converted to HTML</td>

</tr>

<tr>

<td align="center">March 10 2004</td>

<td align="center">Konrad Rzeszutek</td>

<td>Added sections describing SSL and PAM configuration</td>

</tr>

<tr>

Line 43

Line 49

<hr>

Abstract:  Installation, build, operation information on the

Pegasus Platform Version 2.3 Release. Note that if this readme conflicts with

the documentation in the release notes or interface defintion documents for a

the documentation in the release notes or interface definition documents for a

particular release, those documents should be considered authorative. This is a

simplified overview to act as an introduction to Pegasus.

<hr>

Line 59

Line 65

STATUS: Revised October 2003 for  Pegasus release version 2.3.

STATUS: Revised November 2003 for  Pegasus release version 2.3.0

Line 108

Line 114

<a href="#Commands">Commands</a>

<a href="#Creating SSL certifications">Creating SSL certifications</a>.

<a href="#Creating SSL certifications">Creating SSL certifications</a>

<a href="#Configuring SSL">Configuring Pegasus to use SSL</a>

<a href="#Configuring PAM">Configuring Pegasus to use PAM</a>

<a href="#Testing with ICU enabled">Testing with ICU enabled </a>

Line 121

Line 133

<h1><a name="Overview">Overview</a> </h1>

OpenPegasus (also referred to as Pegasus):

OpenPegasus (also referred to as Pegasus):

Pegasus is an open-source object manager (CIMOM) for DMTF CIM objects. It is written

Pegasus is an open-source CIM Server for DMTF CIM objects. It is written

in C++ and includes the Object manager, a set of defined interfaces, and

in C++ and includes the Object manager (CIMOM), a set of defined interfaces, an

implemenation of the CIMOperations over HTTP operations and their cimxml HTTP

encodings, and

Interface libraries

for both client and providers. It is maintained

consistent with the DMTF CIM and WBEM specifications except for  exceptions

noted in the documentation.

Pegasus is open source and is covered under the MIT open-source license.

Pegasus is open source and is covered under the MIT open-source license.

Pegasus is being developed and maintained under the auspices of The Open

Group. Pegasus is maintained under the license defined in the doc directory

(LICENSE) of this release. This licensing is intended to support as wide a

Line 141

Line 154

Pegasus are available from the OpenGroup WEB site.

<a href="http://www.opengroup.org">http://www.openpegaus.org</a>

There are separate documents

There are a number of separate documents representing the status and each

release of Pegasus

<ul>

<li>What's new for this release - WHATSNEW and the release notes for each

<li>What's new for this release - See the PEPs (Pegasus Enhancement Procedures)

release.<li>What's Broken - BUGS - See the ReleaseNotes for this release in the CVS and

release notes on the Pegasus web site and duplicated in the source top level

the web site as a Pegasus PEP.<li>Release Notes for each released version</ul>

directory<li>What's Broken - BUGS - See the ReleaseNotes for this release in the CVS and

the web site as a Pegasus PEP.</ul>

The release notes are available on the WEB site as Pegasus PEP documents and

in the CVS for each release.

<tr>

<td width="42%">Release</td>

<td width="42%">Release</td>

<td width="58%">Release Notes PEP</td>

<td width="58%">Release Notes PEP</td>

</tr>

<tr>

Line 177

Line 192

<h1><a name="Availability of Pegasus">Availability of Pegasus</a></h1>

Pegasus is distributed as open source under the MIT open-source license. The distribution is available via

CVS and snapshot images in tar and zip file formats.

CVS and snapshot images in tar and zip file formats on the web site.

The source code from CVS can be found at the following Open Group CVS server;

Line 233

Line 248

interfacing with Pegasus.

</li>

<li>Pegasus Test Clients - Simple test clients being developed as part of the

Pegasus development process

Pegasus development process. These can be seen in the src/Clients directory and

its subdirectories

</li>

<li>Pegasus HTML Test Client - To aid in testing we created a test client for

Pegasus that uses a WEB server (ex. Apache) with a set of CGI modules and

Line 413

Line 429

</li>

<li>Config Pegasus Configuration

functions</li>

<li>Consumer TBD </li>

<li>Consumer Indication Consumer class

header</li>

<li>ControlProviders Implementation of Pegasus internal providers

</li>

<li>ExportClient TBD

<li>ExportClient Client connect code

</li>

for export of indications</li>

<li>ExportServer TBD

<li>ExportServer Server code for

</li>

import of indications</li>

<li>Handler TBD </li>

<li>Handler Indication handlers. Today

<li>HandlerService TBD

this includes cimxml, SNMP and email handlers</li>

</li>

<li>HandlerService Common code for

<li>IndicationService TBD

indication handler service</li>

</li>

<li>IndicationService Common service

<li>Listener TBD </li>

functions for indication subscription processing</li>

<li>Listener Common code that allows

CIM Listeners to be created and connected.</li>

<li>Protocol Pegasus Client HTTP/XML Protocol Modules

depends </li>

<li>Provider Pegasus Provider interface functions

Line 443

Line 462

</li>

</ul>

</li>

<li>Security TBD </li>

<li>Security Authentication and user

support functions.</li>

<li>Server Pegasus Server Modules

</li>

<li>WQL TBD

<li>WQL the WQL query language

</li>

interpreter.</li>

</ul>

</li>

</ul>

Line 455

Line 475

<li>Providers Pegasus test and required providers

<ul>

<li>generic TBD this and following IndicationConsumer

<li>generic A number of

cross-platform providers

</li>

<li>Linux </li>

<li>IndicationConsumer - Provider that

consumes indications</li>

<li>Linux - A number of linux

providers</li>

<li>ManagedSystem Providers

associated with managing the Pegasus System</li>

<li>slp -  Provider for slp

service agent support</li>

<li>statistic - Providers for

Pegasus statistics.</li>

<li>sample Sample providers for the

Line 470

Line 495

</li>

<li>Server Pegasus executable build

</li>

<li>Standard Includes - TBD</li>

<li>Standard Includes - </li>

<li>test - Directory of end-end

tests that are regularly conducted on Pegasus</li>

<li>tools MU and other utilities written for Pegasus support

</li>

<li>Unsupported Code that is made available but is not supported or included

in the normal make. </li>

<li>WMIMapper Pegasus implementation that implements mapping to Microsoft

<li>WMIMapper Pegasus implementation that

WMI objects.

provides mapping to Microsoft WMI objects.

</li>

</ul>

Line 514

Line 539

<h1>

<a name="Pegasus Installation">Pegasus Installation</a> </h1>

Pegasus today is provided only as a source distribution.

Pegasus today is provided only as a source distribution.  Note that there

is code for a Linux RPM distribution but the project is not yet releasing

binaies.

To install Pegasus, you must check it out using CVS (Common Version System)

or download a snapshot. You download, compile, and use it.

Line 546

Line 572

(e.g., set it to $HOME/pegasus_home). Then the output will go into

$HOME/pegasus_home/bin and $HOME/pegasus_home/lib

</li>

<li>PEGASUS_PLATFORM - this must be set to a supported platform identifier.

<li>PEGASUS_PLATFORM - this must be set to a supported

</li>

platform identifier.</li>

</ul>

Line 559

Line 585

For example (Linux on IA32 platform using the GNU Compiler):

LINUX_IX86_GNU

For a complete list of platforms supported and platform support keywords, refer to the platform_ make files found in directory 

For a complete list of platforms supported and platform support keywords, refer to the platform make files found in directory 

pegasus/mak

</blockquote>

Line 580

Line 606

Place $PEGASUS_HOME/lib on your LD_LIBRARY_PATH (for Unix only).

For RedHat/SuSE/UL, edit /etc/ld.so.conf and add $PEGASUS_HOME/lib

4. Change to the root of the Pegasus distrubution and type "make"

4. Change to the root of the Pegasus distribution and type "make"

(where make refers to GNU make).

5. Then create the repository, which is needed to serve data.

Line 814

Line 840

any WEB browser and that uses a WEB browser, CGI scripts and HTML pages for

the formatting and connections. It requires a WEB server, etc. The

instructions for setting up this environment are maintained in a separate readme in the CGI directory. <h1><a name="Development with Pegasus and Pegasus Tools">Development with Pegasus and Pegasus Tools</a></h1>

ATTN: This section needs to be completed. It should reference the more

ATTN: This section needs to be completed. It should reference the more complete

complete documentation

documentation.<h1><a name="Commands">Commands</a></h1>

ATTN: Write about providers? <h1><a name="Commands">Commands</a></h1>

The manpages for each of the commands are in rpm/manLinux/man1.Z directory (on

CVS)

To see simple help for each of the commands, use the "-h" flag. <blockquote><pre>Examples:

Line 829

Line 854

bin/tomof CIM_Config (extract CIM_Config from repository and present it in MOF type)

</pre>

</blockquote><h1><a name="Creating SSL certifications">Creating SSL certifications </a></h1>

Type these commands in your shell to create the SSL certifications. The PEGASUS_ROOT and PEGASUS_HOME have to be set to your respective installation and source

Please follow section <a href="#Notes about Building Pegasus with SSL">Notes on building Pegasus with SSL</a> before embarking on this endeavour.

directory. <blockquote><pre>CN="Common Name"

Type these commands in your shell to create the SSL certifications. The PEGASUS_ROOT

and PEGASUS_HOME have to be set to your respective installation and source directory.

<blockquote><pre>CN="Common Name"

EMAIL="test@email.address"

HOSTNAME=`uname -n`

sed -e "s/$CN/$HOSTNAME/" \

Line 847

Line 876

cat $PEGASUS_HOME/key.pem $PEGASUS_HOME/cert.pem > $PEGASUS_HOME/server.pem

rm $PEGASUS_HOME/key.pem $PEGASUS_HOME/cert.pem

cp $PEGASUS_HOME/cert.pem $PEGASUS_HOME/client.pem

</pre></blockquote><h1><a name="Testing with ICU enabled">Testing with ICU enabled</a></h1>

</pre></blockquote>

<h1><a name="Configuring SSL">Configuring Pegasus to use SSL</a></h1>

Please follow section <a href="#Notes about Building Pegasus with SSL">Notes on building Pegasus with SSL</a> and <a href="#Creating SSL certifications">Creating SSL certifications</a>

before embarking on this endeavour.

To configure Pegasus to take advantage of SSL, configure

CIMServer to have the following configuration options set to:

sslTrustFilePath=client.pem

sslCertificateFilePath=server.pem

sslKeyFilePath=file.pem

httpsPort=5989

enableHttpsConnection=true

</pre></blockquote>

using the cimconfig utility:

cimconfig -p -s enableHttpsConnection=true

</pre></blockquote>

(The client.pem and server.pem are the certifications

files created per the steps in the earlier section).

For good riddance you might consider closing down

the cleartext 5988 port. Modify your CIMServer configuration

to include:

enableHttpConnection=false

</pre></blockquote>

using cimconfig.

<h1><a name="Configuring PAM">Configuring Pegasus to use PAM</a></h1>

In order to use PAM Authentication you have to compile Pegasus

with one extra enviroment flags:

PEGASUS_PAM_AUTHENTICATION=1

</blockquote></pre>

You can also set the PEGASUS_ALWAYS_USE_PAM=1 flag to disable

Pegasus password authentication using a flag text-file (recommended).

After compiling (refer to section <a href="#Building Pegasus">Building Pegasus </a>

for details), follow these two important steps:

<ul>

<ul>a). Copy the rpm/wbem file in-to /etc/pam.d directory.

This notifies PAM what kind of libraries to use when authenticating

Pegasus.</uL>

<ul>

b). Modify CIMServer configuration options:

usePAMAuthentication=true

enableAuthentication=true

</blockquote></pre>

And if you want to allow 'root' to login (*not recommended*)

enableRemotePrivilegedUserAccess=true

</blockquote></pre>

using the cimconfig utility, such as:

cimconfig -p -s usePAMAuthentication=true

</pre></blockquote>

</ul>

The user is authenticated using HTTP Basic method, thererfore it is

strongly suggested you use SSL connection instead of normal HTTP connection.

Refer to section

<a href="#Configuring SSL">Configuring Pegasus to use SSL</a> for more details on creating and using SSL keys.

<h1><a name="Testing with ICU enabled">Testing with ICU enabled</a></h1>

ICU (International Components for Unicode) refers to the set of libraries that

Pegasus uses to run globalized. For example: these libraries are used to

load messages in different languages, format currency and numbers according to

Line 874

Line 973

using ICU resource bundles. <h1><a name="Pegasus Documentation">Pegasus Documentation</a></h1>

The documentation is currently in preparation.  Much of Pegasus is

documented in the PEGASUS PEPs which are the basis for approval of Pegasus

functioanlity, changes, plans, etc.  These documents are openly available

functionality, changes, plans, etc.  These documents are openly available

on the PEGASUS web site.  The preliminary documentation

is not provided with this release. The current documentation is maintained both as a manual created

under the tool DOC++ in the runtime subdirectory manual/html (see doc/devManual

Legend:

Removed from v.1.1
changed lines
	Added in v.1.5

No CVS admin address has been configured