pegasus/ReleaseNotes.htm - diff

Return to ReleaseNotes.htm CVS log

Up to [Pegasus] / pegasus

Diff for /pegasus/ReleaseNotes.htm between version 1.3 and 1.8

version 1.3, 2005/08/26 16:13:44

version 1.8, 2006/03/28 20:27:53

Line 1

<html xmlns:v="urn:schemas-microsoft-com:vml"

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<head>

<style>

st1\:*{behavior:url(#ieooui) }

Line 598

{mso-level-tab-stop:2.0in;

mso-level-number-position:left;

text-indent:-.25in;}

@list l5:level5

{mso-level-tab-stop:2.5in;

mso-level-number-position:left;

Line 960

Line 959

font-size:10.0pt;

font-family:"Times New Roman"}

</style>

href="PEP_150_ReleaseNotesPegasus2.3.2V1_1_files/editdata.mso">

href="http://www.openpegasus.org/pp/uploads/40/6165/PEP_150_ReleaseNotesPegasus2.3.2V1_1_files/editdata.mso">

<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"

<o:smarttagtype

name="City"/>

namespaceuri="urn:schemas-microsoft-com:office:smarttags" name="City"></o:smarttagtype>

<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"

<o:smarttagtype

name="place"/>

namespaceuri="urn:schemas-microsoft-com:office:smarttags" name="place"></o:smarttagtype><o:smarttagtype

<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"

namespaceuri="urn:schemas-microsoft-com:office:smarttags" name="date"></o:smarttagtype><!--[if gte mso 9]><xml>

name="date"/>

<!--[if gte mso 9]><xml>

<o:DocumentProperties>

<o:Author>IBM_User</o:Author>

<o:LastAuthor> </o:LastAuthor>

Line 996

Line 993

<w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>

</w:WordDocument>

</xml><![endif]-->

</head>

<div class="MsoNormal" style="text-align: center;" align="center"><span

style="color: black;">

<div class=MsoNormal align=center style='text-align:center'><span

<hr align="center" color="#009900" noshade="noshade" size="2"

style='color:black'>

width="100%"></div>

<p class="MsoNormal" style="margin-bottom: 12pt; text-align: center;"

align="center">Pegasus

Enhancement Proposal (PEP)<o:p></o:p>

</div>

<span

style="color: black;">

<span

style='font-size:13.5pt;color:black'>Pegasus Enhancement Proposal (PEP)<o:p></o:p>

PEP #: 150<o:p></o:p>

Title: Release Notes Pegasus 2.3.2

Version: 1.5

Created: <st1:date Year="2004" Day="23" Month="3">23 March 2004</st1:date>

Authors: <st1:City><st1:place>Warren</st1:place></st1:City> <span

class=SpellE>Grunbok

                Karl

Schopmeyer

Status:  draft

Version History:

<table class=MsoNormalTable border=1 cellspacing=1 cellpadding=0 width="100%"

style='width:100.0%;mso-cellspacing:.6pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>

<span

style='font-family:Arial;color:black'><o:p> </o:p>

</td>

<span

style='font-family:Arial;color:black'><o:p> </o:p>

</td>

<span

style='font-family:Arial;color:black'><o:p> </o:p>

</td>

<span

style='font-family:Arial;color:black'><o:p> </o:p>

</td>

</tr>

<span

style='font-family:Arial;color:black'> 1.0<o:p></o:p>

</td>

<st1:date

Year="2004" Day="23" Month="3">

23

March 2004</st1:date><o:p></o:p>

</td>

<span

style='font-family:Arial;color:black'><o:p> </o:p>

</td>

Initial

Submission<o:p></o:p>

</td>

</tr>

<span

style='font-family:Arial;color:black'>1.1<o:p></o:p>

</td>

<st1:date

Year="2004" Day="4" Month="4">

4

April 2004</st1:date><o:p></o:p>

</td>

<span

style='font-family:Arial;color:black'><o:p> </o:p><span style='font-family:Arial;

mso-fareast-font-family:"Times New Roman";color:black'><o:p>K

Schopmeyer</o:p>

</td>

Incorporate comments

from� review<o:p></o:p>

</td>

</tr>

<o:p>

1.2/3</o:p>

</td>

<o:p>

15

April 2004</o:p>

</td>

<o:p>

</o:p><span style='font-family:Arial;

mso-fareast-font-family:"Times New Roman";color:black'><o:p>K

Schopmeyer</o:p>

</td>

<o:p>

Incorporate

comments from Second review</o:p>

</td>

</tr>

<span style='font-family:Arial;

mso-fareast-font-family:"Times New Roman";color:black'><o:p>

1.4</o:p>

</td>

<span style='font-family:Arial;

mso-fareast-font-family:"Times New Roman";color:black'><o:p> 20

April 2004</o:p>

</td>

<span style='font-family:Arial;

mso-fareast-font-family:"Times New Roman";color:black'><o:p> K

Schopmeyer</o:p>

</td>

<span style='font-family:Arial;

mso-fareast-font-family:"Times New Roman";color:black'><o:p> Incorporate

review comments from third Review</o:p>

</td>

</tr>

<span style='font-size:9.0pt;font-family:Verdana;

mso-fareast-font-family:"Times New Roman";color:black'><o:p> 1.5</o:p>

</td>

<span style='font-size:9.0pt;font-family:Verdana;

mso-fareast-font-family:"Times New Roman";color:black'><o:p> 28 April

2004</o:p>

</td>

<span style='font-size:9.0pt;font-family:Verdana;

mso-fareast-font-family:"Times New Roman";color:black'><o:p> K.

Schopmeyer</o:p>

</td>

<span style='font-size:9.0pt;font-family:Verdana;

mso-fareast-font-family:"Times New Roman";color:black'><o:p> Add

Bug 1400 to bug list.</o:p>

</td>

</tr>

</table>

<o:p> </o:p>

<div class=MsoNormal align=center style='text-align:center'><span

style='color:black'>

</div>

Abstract: This document defines the release notes that support

release 2.3.2 of the Pegasus platform.  This release notes document incorporates

the Pegasus version 2.3.0 and 2.3.1 release notes plus a delta for 2.3.2.  Comments made

to these release notes have also been incorporated.<span

style='font-size:9.0pt'><a

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=632&file=Pegasus2_3_1ReleaseNotes.html&tag=35"

target="_self">

</a>

<div class=MsoNormal align=center style='text-align:center'><span

style='color:black'>

</div>

<o:p> </o:p>

<h2>Availability of the Release</h2>

This release is available as a source release in both ZIP and TAR formats.

The release can be downloaded from the OpenPegsaus Web

site at <a href="../Application%20Data/Microsoft/Word/www.openpegasus.org">www.openpegasus.org.</a>

In addition, this release is available through Pegasus CVS. The CVS tag for the

snapshot representing this release is RELEASE_2_3_2-snapshot_1 and the

branch tag representing the current state of version 2_3_2 is

RELEASE_2_3_2-branch.  This branch defines the current released version of

the Pegasus major

release 2.3.  RELEASE_2_3_2-root defines the initial release point

where Pegasus 2.3 branched from the trunk..  This snapshot release and any

subsequent updates to version 2.3.2 will be announced on the web site and

the Pegasus mailing list.� Specific

additinal snapshots to this release will be marked in the CVS as

RELEASE_2_3_2-snapshot_x, where x is the number of the snapshot and these will correspond to equivalent

zip and tar files made available on the web site.

The instructions for acquiring the released code are on the WEB site.

Installation instructions are part of the README in the root of the source

tree.

The OpenPegasus project is currently not providing binary releases.

PEP #: 230

There may be additional point releases to the Pegasus 2.3 release and these

Title: Release

will be announced on the <a href="http://www.openpegasus.org">Pegasus web site</a>. <span

Notes for OpenPegasus 2.5

style='font-size:9.0pt'> <a

Version: 1.8

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=632&file=Pegasus2_3_1ReleaseNotes.html&tag=47"

Created: <st1:date

target="_self">

year="2004" day="23" month="3">1 April 2005</st1:date>

</a>

Authors: Warren

Grunbok, Karl Schopmeyer

<h2>Functionality of This Release</h2>

Status:  draft

The overall level of functionality in the Pegasus environment effective with

Version History:

this release is as follows:

<table class="MsoNormalTable" style="width: 100%;" border="1"

cellpadding="0" cellspacing="1" width="100%">

CIM Server

<tbody>

<td

style="padding: 0.75pt; background: rgb(202, 230, 202) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">

CIM Operations over HTTP support

<span

style="font-family: Arial; color: black;"><o:p> </o:p>

<li class=MsoNormal style='color:black;mso-list:l13 level1 lfo3;tab-stops:

list .5in'>Class Operations (getClass, <span

class=SpellE>deleteClass, modifyClass, <span

class=SpellE>enumerateClass, enumerateClassNames)

- Operational<a

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=536&file=PEP098Pegasus2_3ReleaseNotes.htm&tag=40"

target="_self"></a><o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l13 level1 lfo3;tab-stops:

list .5in'>Qualifier Operations getQualifier, setQualifier, deleteQualifier)

- Operational</li>

<li class=MsoNormal style='color:black;mso-list:l13 level1 lfo3;tab-stops:

list .5in'>Instance Operations (getInstance, <span

class=SpellE>deleteInstance, modifyInstance,

enumerateInstance, enumerateInstanceNames,

getProperty, setProperty)

-   Operational<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l13 level1 lfo3;tab-stops:

list .5in'>Association Operations (references, referencenames,

associators, associatornames)

- Operational <a

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=536&file=PEP098Pegasus2_3ReleaseNotes.htm&tag=43"

target="_self"></a><o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l13 level1 lfo3;tab-stops:

list .5in'>Methods- Operational<span

style='font-size:9.0pt'><a

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=536&file=PEP098Pegasus2_3ReleaseNotes.htm&tag=44"

target="_self"></a><o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l13 level1 lfo3;tab-stops:

list .5in'>Query operation (Not Operational) <o:p></o:p></li>

</ol>

<span

style='font-size:9.0pt'><a

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=536&file=PEP098Pegasus2_3ReleaseNotes.htm&tag=45"

target="_self">

</a><o:p></o:p>

Indications

Process indications are operational in the Server.  This includes support

for subscriptions, filters, and indication handlers, the provider API for

indications and the CIMXML indication handler. The Pegasus server can be used as

an Indication client.  The Client indication  API support is complete,

but the interfaces are marked experimental for version 2.3 because

this is the first major release version of Pegasus in which these APIs were

available.

Query Language

The query language today is based on WQL and is implemented and used for

filters.  However, the executeQuery operation

has not been implemented pending the availability of a standard DMTF Query

language.

Class Repository

XML based file/directory Class repository. All class and qualifier operations

access this repository.

Instance Repository

XML based file/directory Instance repository.  The instance repository

is used as the default repository unless a flag is set disabling this

repository for client operations.

Security

<li class=MsoNormal style='color:black;mso-list:l14 level1 lfo6;tab-stops:

list .5in'>Basic Security (Note that Digest based security is not

implemented) <o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l14 level1 lfo6;tab-stops:

list .5in'>SSL support - SSL is implemented in Pegasus using the <span

class=SpellE>OpenSSL libraries. Pegasus does not provide the <span

class=SpellE>OpenSSL libraries but SSL can be used on any platform

supported by OpenSSL.  Minimum level known

to work is  0.9.6c .   This release of Pegasus was tested

with 0.9.6k.  See <a

href="../Application%20Data/Microsoft/Word/www.openssl.org">openssl.org</a>

for OpenSSL release information<o:p></o:p></li>

</ol>

Platform Management Functions

<li class=MsoNormal style='color:black;mso-list:l11 level1 lfo9;tab-stops:

list .5in'>Configuration through the defined configuration parameters (cimconfig)

and server command line options. <o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l11 level1 lfo9;tab-stops:

list .5in'>Daemon operation on all supported platforms<o:p>.</o:p></li>

</ol>

SLP Discovery<a name="comtag_61">

</a>SLP support is included but is conditionally compiled with the default to

not compile it.  This code can be enabled by setting the compile

environment variable PEGASUS_ENABLE_SLP. Note that this release differs from

2.3.1 in that the SLP functions have been completed and tested in an

interoperable environment.� Also, the

provider for the interop classes (CIM_ObjectManager,

CIM_Namespace,

etc.) is enabled along with the SLP discovery.

If the SLP discovery is not enabled, these interop

classes are also not available.

CMPI Provider Manager<o:p></o:p>

Pegasus 2.3.2 includes as a compilable option a

new set of code that allows multiple provider managers and also a second

provider manager for the CMPI C interfaces.

This C interface is the result of a project by the IBM SBLIM team (<span

class=GramE>see� <a

href="http://www-124.ibm.com/sblim/)">http://www-124.ibm.com/sblim/)</a> and

also the working draft of the Open Group specification for these interfaces

which is in review now within the WBEMSource

Initiative (<a href="http://www.wbemsource.org/">http://www.wbemsource.org</a>).

This provides a standardized C level interface for creating providers that can

be registered with the Pegasus CIM Server in the same manner as the current C++

providers.

Today, the CMPI provider manager and interfaces are considered experimental

and are subject to change in future versions of Pegasus.

The CMPI provider manager, sample providers and the hooks into Pegasus are

all conditionally compiled with the environment variables ENABLE_CMPI_PROVIDER_MANAGER

and ENABLE_PROVIDERMANAGER_2. See PEP 144 for details.

</blockquote>

Providers

There are a number of standard providers available in the Pegasus release.

This includes providers in the following categories:

Internal (control) Providers

<li class=MsoNormal style='color:black;mso-list:l18 level1 lfo12;tab-stops:

list .5in'>__Namespace provider - Serves the __Namespace class to allow

manipulation of namespaces.<a

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=536&file=PEP098Pegasus2_3ReleaseNotes.htm&tag=65"

target="_self"></a><o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l18 level1 lfo12;tab-stops:

list .5in'>Subscription Classes Providers - These provide subscription,

filter, and indication handler processing.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l18 level1 lfo12;tab-stops:

list .5in'>Provider registration Providers - This provide registration of

providers using the PG_Provider classes.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l18 level1 lfo12;tab-stops:

list .5in'>ConfigProvider - Manages Pegasus <span

class=SpellE>configuraton information.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l18 level1 lfo12;tab-stops:

list .5in'>UserAuthProvider - Manages password,

etc.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l18 level1 lfo12;tab-stops:

list .5in'>ShutdownProvider - Provides support

for Pegasus shutdown.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l18 level1 lfo12;tab-stops:

list .5in'>Interop Provider - Supports many of

the DMTF Interop Schema Classes including <span

class=SpellE>CIM_Namespace, CIM_ObjectManager,

CIM_CommunicationMechanism, etc.. (Note that

this provider is part of the SLP work package so is not compiled as part

of the default compile. The environment variable PEGASUS_ENABLE_SLP must

be set to enable this option.)<o:p></o:p></li>

</ul>

Generic Providers

Generic OperatingSystem provider. See the

directory src/Providers/generic.

Test/Sample Providers

See the directories src/Providers/TestProviders

and src/Providers/Sample for more information about test and

sample providers.

Managed System Providers

ComputerSystem, DNSAdmin,

DNSService, Operating System, Process, Processor. For

more information on these providers see the documentation for each provider in

the directory src/Providers/ManagedSystem

CIMOM Statistics Providers

IBMStatisticalData - This is an early version of

the work that became CIM_StatisticalData. It is

similar to CIM_StatisticalData and provides the same

data but the structure of the Classes is slightly different. This will be

standardized to the DMTF definition in a future version of Pegasus.

</blockquote>

CIM_Schema

The default CIM_Schema loaded with this release is

the DMTF CIM 2.7 Final release.  In addition, Pegasus includes a number of

local classes defined for Pegasus.  These are visible in the Schemas

directory.   CIM 2.8� schema is

also available in the CVS but is not the default schema for compile.

The mechanism to switch to the the 2.8 schema is via

environment variable: PEGASUS_CIM_SCHEMA = (See Config.mak).

export PEGASUS_CIM_SCHEMA=CIM28

NOTE: the CIM 2.5 schema is maintained in the

CVS repository because it remains the basis for parts of the Pegasus test

environment.

Pegasus MOF Compiler

Pegasus implements a MOF compiler that can operate either at the client

interface to the Pegasus CIM Server (cimmof) or directly interfacing with a CIM

repository (cimmofl).

The direct interface compiler is used primarily to provide an initial

class/instance repository. WARNING:

the use of cimmofl

to manipulate instances in the repository bypasses any provider that is

registered to serve these  instances and simply installs the instances in the

instance repository; this may result in 1) bad data in the repository if there

are registered providers, 2) corruption of the repository if the CIM Server is

running or, 3) MOF data that is loaded but not available until the server is

stopped and restarted in some cases.  Use of cimmofl in

general is discouraged and particularly  to manipulate

instances served by a registered providers (ex.

Provider registration). Use of <span

class=SpellE>cimmof rather that cimmofl

wherever possible.

Client Tools

Pegasus CIM Server Adminstration

<li class=MsoNormal style='color:black;mso-list:l8 level1 lfo15;tab-stops:

list .5in'>cimuser - Manage Pegasus CIM server

Users.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l8 level1 lfo15;tab-stops:

list .5in'>cimconfig - Manage the Pegasus CIM

Server configuration parameters.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l8 level1 lfo15;tab-stops:

list .5in'>cimauth - Manage the CIM Server

authorization characteristics. Today this is authorizing users to

namespaces.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l8 level1 lfo15;tab-stops:

list .5in'>cimprovider - Manage information

about the providers .<o:p></o:p></li>

</ol>

Information client tools

These tools provide information on the objects managed by the server.

<li class=MsoNormal style='color:black;mso-list:l4 level1 lfo18;tab-stops:

list .5in'>tomof - output Classes and/or

instance information in MOF or XML format.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l4 level1 lfo18;tab-stops:

list .5in'>dnsinfo - Generate a set of standard

information on the Dmain Name System (DNS)

configuration from CIM Classes. Note that the information generated is dependent

on the information available from providers and differs from system to

system.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l4 level1 lfo18;tab-stops:

list .5in'>ipinfo - Generates a set of standard

information from the Network Schema.  Information generated varies by

system because of the level of provider support.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l4 level1 lfo18;tab-stops:

list .5in'>osinfo - Generate a set of standard

information on the Operating System from CIM Classes. Note that the

information generated is dependent on the information available from

providers and differs from system to system<o:p></o:p></li>

</ol>

Test support Tools

<li class=MsoNormal style='color:black;mso-list:l0 level1 lfo21;tab-stops:

list .5in'>Pegasus Unit tests (available through the "tests"

option on the Pegasus make files       

<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l0 level1 lfo21;tab-stops:

list .5in'>The Pegasus Test Suite (see the tests directory and the

Pegasus/TestBuildMakeFile)<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l0 level1 lfo21;tab-stops:

list .5in'>TestClient - Basic client for overall

platform operation testing. <o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l0 level1 lfo21;tab-stops:

list .5in'>wbemexec - Test tool that

sends/receives XML from XML input.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l0 level1 lfo21;tab-stops:

list .5in'>CLI - Command line interface for Client commands.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l0 level1 lfo21;tab-stops:

list .5in'>Benchmark Test - Introduced with Pegasus 2.3, a benchmark test

environment is not provided which includes both a client and provider component.

See src/clients/benchmarkTest for more

information.<o:p></o:p></li>

</ol>

Pegasus Interface APIs

Details of the Pegasus public interfaces for release 2.3 are listed in PEP 96

available from the web site(<a

href="../Administrator/My%20Documents/processes/www.openpegasus.org">www.openpegasus.org</a>).

This document is the authorative source for the list

of publicly supported Pegasus APIs.   The Client and Provider API were

originally frozen at the Pegasus version 2.1 release. The interfaces in the

release of Pegasus 2.1 are forward compatible to release 2.3 Well-behaved

clients and providers compiled to the Pegasus 2.1 or 2.2 interfaces should be

compatible with Pegasus 2.3 without compilation.  There have been

extensions and new interfaces added for release 2.3 and these are shown as

experimental.   The Pegasus public

interfaces includes the following major functions

<li class=MsoNormal style='color:black;mso-list:l5 level1 lfo24;tab-stops:

list .5in'>Client APIs<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l5 level1 lfo24;tab-stops:

list .5in'>Provider APIs<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l5 level1 lfo24;tab-stops:

list .5in'>CIM Object and System function APIs</li>

<li class=MsoNormal style='color:black;mso-list:l5 level1 lfo24;tab-stops:

list .5in'>CIM Listener

(experimental for Pegasus 2.3.2)<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l5 level1 lfo24;tab-stops:

list .5in'>SLP Client (experimental for Pegasus 2.3.2)<o:p></o:p></li>

</ol>

<o:p> </o:p>

The APIs are documented in

their respective header files and  in HTML documentation based on the information

in the header files extracted with the doc++ tool will be available on the

OpenPegasus web site. <o:p></o:p>

WMI Mapper

The WBEM to WMI Mapper provides a way to access

WMI data from Windows platform systems. It converts incoming XML/CIM requests

to Microsoft WMI requests, executes the requests, converts the results to

XML/CIM and returns the results to the client. WMI Mapper

receives an HTTP message containing the XML/CIM request. It decodes the XML

message and extracts from the HTTP message header the user credentials provided

on the connection (username and password). The WMI Mapper

authenticates these credentials, verifying if the provided credentials have

access to the desired WMI data. This is done because the WMI <span

class=SpellE>Mapper runs as a service, logged on using an account with

administrative rights (which has all access to WMI data). Because of this, the

WMI Mapper impersonates the user credentials provided

on the HTTP message to ensure that the calling user has rights to browse WMI

data. Hence, ALL requests made to the WMI Mapper MUST

contain user credentials.

<a

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=632&file=Pegasus2_3_1ReleaseNotes.html&tag=132"

target="_self">

</a>Supported Platforms

<a

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=632&file=Pegasus2_3_1ReleaseNotes.html&tag=134"

target="_self">

</a>Each Pegasus release lists as supported platforms those

hardware/software platforms that have recognized ports for the Pegasus code

base including a maintainer for the platform that will be willing to regularly

assure that the port is maintained as the Pegasus code base is changed. 

Pegasus may be operable on other platforms (ex. Windows 98) but without a group

to provide the role of test and maintenance, the Pegasus project cannot assure

operation. The supported platforms for Pegasus release 2.3.2 are:

<table class=MsoNormalTable border=1 cellspacing=1 cellpadding=0 width=504

style='width:302.25pt;mso-cellspacing:.6pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>

Platform and OS<span

style='color:black'><o:p></o:p>

</td>

<td

Compilers<span

style="padding: 0.75pt; background: rgb(202, 230, 202) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">

style='color:black'><o:p></o:p>

<span

style="font-family: Arial; color: black;"><o:p> </o:p>

</td>

</tr>

<td

style="padding: 0.75pt; background: rgb(202, 230, 202) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">

<span

AIX 5.2<o:p></o:p>

style="font-family: Arial; color: black;"><o:p> </o:p>

</td>

<td

VisualAge<span

style="padding: 0.75pt; background: rgb(202, 230, 202) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">

style='color:black'> C++ Version 5.0.2.3<o:p></o:p>

<span

style="font-family: Arial; color: black;"><o:p> </o:p>

</td>

</tr>

HP-UX<o:p></o:p>

<span

style="font-family: Arial; color: black;"> 1.0<o:p></o:p>

</td>

HP aC++

<span

B3910B<o:p></o:p>

style="font-family: Arial; color: black;"><o:p>  1,April

2005

</o:p>

</td>

</tr>

<span

style="font-family: Arial; color: black;"><o:p>Warren Grunbok

PowerLinux<span

</o:p>

style='color:black'><o:p></o:p>

</td>

gcc<span

<span

style='color:black'><o:p></o:p>

style="font-family: Arial; color: black;">Initial

Submission<o:p>

</o:p>

</td>

</tr>

zLinux<span

<td style="padding: 0.75pt;" align="center">26, June 2005

style='color:black'><o:p></o:p>

</td>

gcc<span

style='color:black'><o:p></o:p>

</td>

</tr>

<td style="padding: 0.75pt;">Warren Grunbok

Linux Itanium<o:p></o:p>

</td>

<td style="padding: 0.75pt;">revisions based on Comments

gcc<span

style='color:black'><o:p></o:p>

</td>

</tr>

<tr>

<td style="vertical-align: top;">1.2

Linux IA-32<o:p></o:p>

</td>

<td style="vertical-align: top;">22, July 2005

gcc<span

style='color:black'> (versions 2.9x and 3.xx)<o:p></o:p>

</td>

</tr>

<td style="vertical-align: top;">Warren Grunbok

Windows 2000<o:p></o:p>

</td>

<td style="vertical-align: top;">fixed some broken links, added

Microsoft

security notes.

Visual C++ Ver 6 and Microsoft .Net compiler Version.   <span

style='color:black'>Works on VC .NET 2003 (aka

v7.1)<o:p></o:p>

</td>

</tr>

<tr>

<td style="vertical-align: top;">1.3

Windows XP<o:p></o:p>

</td>

Microsoft

Visual C++ Ver. 6 and Microsoft .Net compiler Version <span

style='color:red'>7.1<span lang=NL style='color:black;mso-ansi-language:

NL'><o:p></o:p>

</td>

</tr>

<td style="vertical-align: top;">23, Aug 2005

</table>

Further information regarding Pegasus support on IBM platforms can be found at:<a

href="http://publib.boulder.ibm.com/eserver/v1r1/en_US/index.html" target="_"> http://publib.boulder.ibm.com/eserver/v1r1/en_US/index.html.</a>

Further information regarding Pegasus support on HP platforms can be found at: <a

href="http://www.hp.com/large/infrastructure/management/wbem" target="_">http://www.hp.com/large/infrastructure/management/wbem</a>/.

<o:p> </o:p>

<h2>Conformance with DMTF Specifications</h2>

Pegasus tries to conform to the CIM specifications.  It is a major goal

of the OpenPegasus project to both drive and utilize the DMTF CIM/WBEM

specifications.  However, today there are a number of known differences. 

As of Pegasus 2.3.2, some of the differences include the following:

1. Provider Registration - Pegasus supports registration through a set of

Provider registration classes and does not support the DMTF defined Provider

Qualifier. See the readme for more information on provider registration.

2. Indications. Today Pegasus supports process indications but does not

include any specific support for lifecycle indications.

3. Interop Schema implementation differences.

Today Pegasus provides alternatives to some of the classes in the <span

class=SpellE>Interop Schema including CIM_StatisticalData.

Note that the CIM_ObjectManager and other similar

classes are only compiled with the SLP option.

4. Today Pegasus does not support the execQuery pending the availability of

a standard for the query language.  Pegasus is expected to support

execQuery in a future release with the new CQL query language and possibly WQL.

5. Instance qualifiers and class

qualifiers on some Operations -

The DMTF specifications are unclear regarding the inclusion of qualifiers on

CIM instances.  Some CIM Client implementations expect instances returned

from the CIM Server to include the qualifiers defined in the class definition

(such as KEY qualifiers on properties).  Pegasus is based on the

interpretation that class-defined qualifiers are not included in instances, so

incompatibilities may exist with clients that rely on these qualifiers.<o:p></o:p>

<o:p> </o:p>

6. HTTP Chunking � Today the Pegasus

implementation defines itself as supporting HTTP 1.1 but does NOT support

chunking. This is a high priority for a future version.

7. CIM MOF compiler functions for instance aliasing - The

Pegasus compiler does not today support thi functions.  This function is

planned for a future version.

8. MultiRequest Oprations - Pegasus does not support the DMTF defined MultiRequest

Operation option.

9. LocalOnly option on some instance Operations - Because of

incompatible changes made between CIM Operation specification versions, the DMTF

has determined that there is confusion in the use of the LocalOnly parameter on

instance operations and the

results it will return.  The definition changed between version 1.0 and

version 1.1 of the CIM Operations

over HTTP Specification  so that the information provided to

the requestor may be different between a CIM Operations version 1.0 specification

implementation and a version 1.1 implementation.  Therefore, the Pegasus

community discourages the use of this parameter on any operations. NOTE:

We recommend that client users always set localOnly to False (remember that the

default is true) on instance

operations to avoid the confusion of different information from different CIM

Server implementations.

NOTE: This problem does not apply to the class

operations such as getClass, etc.

<h2>Changes in Release 2.3</h2>

The development and release of each version of Pegasus is defined and

controlled through Pegasus PEP documents.  PEP 57 is the controlling document

this release and lists the original set of changes proposed and the status of

each of those changes. Note that not all of the originally defined

functionality was completed for this release.

In general, the changes implemented for this release were:

<li class=MsoNormal style='color:black;mso-list:l21 level1 lfo27;tab-stops:

list .5in'>

Introduction of platform globalization.</li>

<li class=MsoNormal style='color:black;mso-list:l21 level1 lfo27;tab-stops:

list .5in'>

Introduction of a listener API.</li>

<li class=MsoNormal style='color:black;mso-list:l21 level1 lfo27;tab-stops:

list .5in'>

Introduction of SLP (still experimental and by default not

compiled in the 2.3.2 release).</li>

<li class=MsoNormal style='color:black;mso-list:l21 level1 lfo27;tab-stops:

list .5in'>

Introduction of a new pluggable Provider Manager (still

experimental and by default not compiled in the 2.3.2 release).</li>

<li class=MsoNormal style='color:black;mso-list:l21 level1 lfo27;tab-stops:

list .5in'>

Introduction of extensive changes to the HTTP monitor (still

experimental and not compiled in the 2.3.2 release).</li>

<li class=MsoNormal style='color:black;mso-list:l21 level1 lfo27;tab-stops:

list .5in'>

Inclusion of Pluggable

CMPI provider manager.  Note: This makes use of the PPM item

described below.  This is an optional compile.</li>

</ol>

Note that there were a number of objectives that were not completely achieved

including: <o:p></o:p>

<li class=MsoNormal style='color:black;mso-list:l10 level1 lfo30;tab-stops:

list .5in'>SLP integration - This code is in place but is compiled only

with a conditional compile flag. This code can be enabled by setting the

environment variable PEGASUS_SLP_ENABLE and recompiling Pegasus.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l10 level1 lfo30;tab-stops:

list .5in'>Pluggable

provider manager - This was a major objective but because the code changes

were extensive and released very late in the development

cycle of 2.3, both the old and the new provider managers are maintained in

the release AND the old provider manager is defined as the default

compile.  To compile and run with the new pluggable provider manager

functions the user must set a compile flag (TBD).  NOTE: It is the

intention of the Pegasus project to move to the new provider manager as

soon as possible.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l10 level1 lfo30;tab-stops:

list .5in'>HTTP Monitor enhancements - As with the Pluggable Provider

Manager, it was the intention to incorporate a number of enhancements to

the HTTP monitor.  Again because the time in the development phase

when they were submitted, the project team elected to release 2.3.2 with

the existing monitor as the default compile but with the code for both

monitors. It is the intention to move to the new monitor as soon as

possible and users are free to work with either implementation.  To

compile and run with the new monitor use the flag PEGASUS_MONITOR2.<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l10 level1 lfo30;tab-stops:

list .5in'>CMPI Pluggable Provider Mgr - The CMPI Provider manager was

added as a PEP to release 2.3.2 and uses the same flag as the Pluggable

provider manager to control its compilation. Without setting this flag before

the build process this provider manager and its sample providers are NOT

compiled.  <o:p></o:p></li>

</ol>

The set of PEPs defined for release 2.3 is below

along with the final implementation status. Note that release 2.3.2 introduced no new <span

class=SpellE>PEPs beyond what was in release 2.3.0. All of these PEPS are

available on the OpenPegasus web site.

<table class=MsoNormalTable border=1 cellspacing=1 cellpadding=0 width="74%"

style='width:74.98%;mso-cellspacing:.6pt;mso-padding-alt:0in 5.4pt 0in 5.4pt'>

<td width="20%" style='width:20.26%;background:#00CC99;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

PEP #<span

style='color:black'><o:p></o:p>

</td>

<td width="46%" style='width:46.22%;background:#00CC99;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

PEP Description<span

style='color:black'><o:p></o:p>

</td>

<td width="33%" style='width:33.2%;background:#00CC99;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Status<span

style='color:black'><o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

56<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Unicode Support in

Infrastructure<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

<o:p> </o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

58<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Unicode Support in

Infrastructure<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

<a

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=536&file=PEP098Pegasus2_3ReleaseNotes.htm&tag=168"

target="_self">

</a><o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

68<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Provider Manager Interface -

Multiple provider support<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Implemented - but requires

compile flag to integrate.<o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

84<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Provider Manager Interface,

Pluggable provider manager configuration<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Implemented - see above.<o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

86<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Provider Manager Interface,

pluggable provider manager.<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Implemented - see above.<o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

60<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Secure connections between CIM

Listener and CIM server<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Implemented<o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

62<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

SNMP Mapper

Indication Handler<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

Implemented<o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

67<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">Warren Grunbok

height:13.5pt'>

Indication Consumer registration<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">Revisions based on comments

height:13.5pt'>

<o:p> </o:p>

</td>

</tr>

<tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">1.4

height:13.5pt'>

76<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:13.5pt'>

CIM Listener Client API,

Libraries, SDK<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">30.Aug 2005

height:13.5pt'>

Implemented - Experimental<o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

75<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">Warren Grunbok

height:10.5pt'>

Indication Subscription

Performance Enhancements<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">More revisions based on Aug 26

height:10.5pt'>

review in Architecture meeting

Implemented<o:p></o:p>

</td>

</tr>

<tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">1.5

height:10.5pt'>

30<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">12, Sept 2005

height:10.5pt'>

SLP support<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

Implemented - Optional compile<o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

52<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">Warren Grunbok

height:10.5pt'>

Interop<span

style='color:black'> Schema provider support<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">Minor comment updates from 1.4

height:10.5pt'>

version  (balloted version)

Implemented - Optional compile<o:p></o:p>

</td>

</tr>

<tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">1.6

height:10.5pt'>

88<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">14,Sept 2005

height:10.5pt'>

Polling design socket change.<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">Warren Grunbok

height:10.5pt'>

<o:p> </o:p>

</td>

</tr>

<td style="vertical-align: top;">additional comments from review

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

64<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

Java implementation of CIM

Client and Listener Interface<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

Included in Pegasus based SNIA <span

class=SpellE>OpenCimom Java Classes.<o:p></o:p>

</td>

</tr>

<tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">1.7

height:10.5pt'>

65<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">20, Sept 2005

height:10.5pt'>

Benchmark test utility<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

Implemented<o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

74<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">Warren Grunbok

height:10.5pt'>

SSL certificate verification

callback enhancement<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">Added Solaris back in, corrected

height:10.5pt'>

Provider security statement, and clarified Solaris support for 2.5

Implemented<o:p></o:p>

</td>

</tr>

<tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">1.8

height:10.5pt'>

73<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">21, Sept 2005

height:10.5pt'>

Support CIM Schema 2.8

preliminary<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

<td style="vertical-align: top;">Warren Grunbok

height:10.5pt'>

<o:p> </o:p>

</td>

</tr>

<td style="vertical-align: top;">Clarified SLP enablement

Paragraph and correction of Power on Linux in platform table

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

79<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

WMI Mapper

- local connection enhancements<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

<o:p> </o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

77<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

Default instance provider<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

Implemented<o:p></o:p>

</td>

</tr>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

85<o:p></o:p>

</td>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

Configuration Property Table

Enhancement<o:p></o:p>

</td>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

Implemented<o:p></o:p>

</td>

</tr>

</tbody>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

</table>

height:10.5pt'>

<o:p> </o:p>

90<o:p></o:p>

<div class="MsoNormal" style="text-align: center;" align="center"><span

</td>

style="color: black;">

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

<hr align="center" color="#009900" noshade="noshade" size="2"

height:10.5pt'>

width="100%"></div>

Add

Abstract: This document defines the release notes for the 2.5

IO trace diagnostics to CIMClient<o:p></o:p>

version of the Pegasus CIM Server. <span

</td>

style="font-size: 9pt;"><a

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=632&file=Pegasus2_3_1ReleaseNotes.html&tag=35"

height:10.5pt'>

target="_self">

Implemented<o:p></o:p>

</a>

</td>

<div class="MsoNormal" style="text-align: center;" align="center"><span

</tr>

style="color: black;">

<hr align="center" color="#009900" noshade="noshade" size="2"

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

width="100%"></div>

height:10.5pt'>

<o:p> Contents

89<o:p></o:p>

</o:p>

</td>

<ol>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

<li><a href="#Availability_of_this_Release_">Availability of

height:10.5pt'>

this Release</a></li>

SLP Client Integration<o:p></o:p>

<li><a href="#Functionality_of_This_Release">Functionality of

</td>

This Release</a></li>

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

<li><a href="#Relationship_to_CIMWBEM_Standards">Relationship

height:10.5pt'>

to CIM/WBEM Standards</a></li>

Implemented but not compiled by

<li><a href="#Supported%20Platforms">Supported

default<o:p></o:p>

Platforms</a></li>

</td>

<li><a href="#Conformance%20with%20DMTF%20Specifications">Conformance

with DMTF Specifications</a></li>

<li><a href="#Changes%20in%20This%20Release">Changes

in This Release</a></li>

<li><a href="#PEGASUS%20Bugs">PEGASUS

Bugs</a></li>

<li> <a

href="#Pegasus%20Release%20Control%20and%20Version%20Definition%20Documentation">Pegasus

Release Control and Version Definition Documentation</a></li>

<li><a href="#General%20Documentation">General

Documentation</a></li>

</ol>

<h2><a name="Availability_of_this_Release_"></a><span

style="color: black;"><a name="Availability_of_this_Release"></a>Availability

of this Release</h2>

This release is available in a number of forms including:

<ul>

<li>Source release in both ZIP and TAR formats. These can be

downloaded from the OpenPegasus Web

site at <a

href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&ggid=392">www.openpegasus.org.</a></li>

<li>OpenPegasus 2.5 binaries are available for Red Hat Enterprise

Linux 3.0 and 4.2 and SUSE LINUX Enterprise Server 9.0. A Source RPM is

also available that can be used to build binaries for most

LSB-compliant RPM-based Linux distributions and versions.</li>

<li>The Pegasus CVS. The CVS tags representing this release and

subsequent snapshots that are made available in the Pegasus CVS are

defined on the OpenPegasus CVS repository web page (see the <a

href="http://cvs.opengroup.org/cgi-bin/viewcvs.cgi/">OpenPegasus

CVS page</a> for information) using the tags defined on the <a

href="http://www.openpegasus.org/page.tpl?CALLER=cvs.tpl&ggid=392">release

snapshots page</a>.</li>

</ul>

<>The instructions for acquiring the released code are on the <a

href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&ggid=392">Pegasus

WEB site</a>.

Installation instructions are part of the README in the root of the

Pegasus source

tree.

Instructions for building the Linux RPMs: <span

style="color: rgb(255, 0, 0);">

</>

<ol>

<li>Download

tog-pegasus-2.5.0-1.src.rpm. </li>

<li>rpm

-ih tog-pegasus-2.5.0-1.src.rpm </li>

<li>

<span

class="norm">Build

the rpms:

</li>

</ol>

<table

style="margin-left: auto; margin-right: auto; text-align: left; width: 712px; height: 116px;"

border="1" cellpadding="2" cellspacing="2">

<tbody>

<tr>

<td

style="vertical-align: top; text-align: center; background-color: rgb(204, 204, 204);">Distro</td>

<td

style="vertical-align: top; text-align: center; background-color: rgb(204, 204, 204);">Command

</td>

</tr>

<tr>

<td style="vertical-align: top; text-align: center;">RHEL3

</td>

<td style="vertical-align: top; text-align: center;"><span

class="norm">rpmbuild -bb /usr/src/redhat/SPECS/tog-pegasus-

2.5.0-1.spec</td>

</tr>

<tr>

<td style="vertical-align: top; text-align: center;">RHEL4

</td>

<td style="vertical-align: top; text-align: center;"><span

class="norm">rpmbuild -bb /usr/src/redhat/SPECS/tog-pegasus-

2.5.0-1.spec</td>

</tr>

<tr>

<td style="vertical-align: top; text-align: center;">SLES 9

</td>

<td style="vertical-align: top; text-align: center;"><span

class="norm"> rpmbuild -bb /usr/src/packages/SPECS/tog-pegasus-

2.5.0-1.spe</td>

</tr>

</tbody>

<td width="20%" style='width:20.26%;padding:.75pt .75pt .75pt .75pt;

</table>

height:10.5pt'>

<a

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=536&file=PEP098Pegasus2_3ReleaseNotes.htm&tag=306"

target="_self">99</a><span

<li style="font-weight: bold;">After

style='color:black'> <o:p></o:p>

the build the rpms will be in the

</td>

following locations:</li>

<td width="46%" style='width:46.22%;padding:.75pt .75pt .75pt .75pt;

height:10.5pt'>

<table style="width: 100%; text-align: left;" border="1"

<a

cellpadding="2" cellspacing="2">

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=536&file=PEP098Pegasus2_3ReleaseNotes.htm&tag=307"

<tbody>

target="_self">Restructure of CIMRequest

<tr>

Message</a> <o:p></o:p>

<td

</td>

style="vertical-align: top; text-align: center; background-color: rgb(204, 204, 204);">Distro

<td width="33%" style='width:33.2%;padding:.75pt .75pt .75pt .75pt;

</td>

height:10.5pt'>

<td

<a

style="vertical-align: top; text-align: center; background-color: rgb(204, 204, 204);">Location

href="http://www.openpegasus.org/pp/protected/doc_edit.tpl?grid=536&file=PEP098Pegasus2_3ReleaseNotes.htm&tag=308"

of RPMs after the build is complete

target="_self">Implemented but not compiled by

</td>

default</a> <o:p></o:p>

</tr>

</td>

<tr>

<td style="vertical-align: top; text-align: center;">RHEL3

</td>

<td style="vertical-align: top; text-align: center;"><span

class="norm">/usr/src/redhat/RPMS/[arch]/tog-pegasus-

2.5.0-1.[arch].rpm

/usr/src/redhat/RPMS/[arch]/tog-pegasus-sdk- 2.5.0-1.[arch].rpm.<span

style="font-family: "times new roman";"><span

style="font-family: "times new roman";"><span

class="norm">     </td>

</tr>

<tr>

<td style="vertical-align: top; text-align: center;">RHEL4

</td>

<td style="vertical-align: top; text-align: center;"><span

class="norm">/usr/src/redhat/RPMS/[arch]/tog-pegasus-

2.5.0-1.[arch].rpm

/usr/src/redhat/RPMS/[arch]/tog-pegasus-sdk- 2.5.0-1.[arch].rpm.</td>

</tr>

<tr>

<td style="vertical-align: top; text-align: center;">SLES9

</td>

<td style="vertical-align: top; text-align: center;"><span

class="norm">/usr/src/packages/RPMS/[arch]/tog-pegasus-

2.5.0-1.[arch].rpm

/usr/src/packages/RPMS/[arch]/tog-pegasus-sdk- 2.5.01-.[arch].rpm.</td>

</tr>

</tbody>

</table>

102<o:p></o:p>

</td>

</ol>

CMPI Pluggable Provider <o:p></o:p>

</td>

<h2><a name="Functionality_of_This_Release"></a><span

style="color: black;">Functionality of This Release</h2>

Implemented but not compiled by

New for the Pegasus 2.5 release is a Feature Maturity Dashboard. 

default <o:p></o:p>

This document shows the Pegasus users and developers the maturity of

</td>

the various features found in Pegasus using a simple color coded

key.  That document can be found here:  <a

href="http://www.openpegasus.org/page.tpl?ggid=799">Feature

Maturity Link</a>

The overall level of functionality in the Pegasus environment

effective with

this release is as follows:

<h3>CIM Server Functionality</h3>

The following paragraphs list the functions in this release.

All functions are considered community tested and operational unless

specifically noted below. Features that are marked alpha or beta are

not generally of the quality or completeness for production

usage.  Interfaces that are part of the Pegasus public

interface definitions but that the Pegasus team feels may change are

marked experimental. In many cases these features  and interfaces

are conditionally compiled with special environment variables. <a

href="http://www.openpegasus.org/pp/protected/doc.tpl?CALLER=index.tpl&gdid=8502"><span

style="color: rgb(255, 0, 0);"><span

style="text-decoration: underline;">PEP 200 </a>

provides more detailed information on how to enable

functionality that is conditionally compiled in this release.

<h4>CIM Operations over HTTP support</h4>

<ol>

<li>Class Operations (getClass, <span

class="SpellE">deleteClass, modifyClass,

enumerateClass, enumerateClassNames)</li>

<li>Qualifier Operations (getQualifier, setQualifier,

deleteQualifier) </li>

<li>Instance Operations (getInstance, <span

class="SpellE">deleteInstance, modifyInstance,

enumerateInstance, <span

class="SpellE">enumerateInstanceNames, getProperty,

setProperty)</li>

<li>Association Operations (references, referencenames,

associators, associatornames)</li>

<li>Methods Operations (invokeMethod)</li>

<li>Query operation - Support for ExecQuery was added in 2.4 with

WQL as query language and is defined in PEP 119. This feature is

considered at alpha quality because it has only been contributor

tested.  Additional tests have been added in 2.5 for ExecQuery.

</li>

</ol>

</blockquote>

</div>

<h4>Indications</h4>

<ul>

<li>Process indications - Process indications are operational in

the

Server.  This includes support

for subscriptions, filters, and indication handlers, the provider API

for

indications and the CIMXML indication handler.</li>

<li>Lifecycle indications - With the support for embedded objects,

lifecycle indications (ie. those

classes of indications derived from CIM_ClassIndication and

CIM_InstIndication) can now be created. Pegasus 2.5 provides some

enablement for the generation of lifecycle indications. For more

details, refer to

</ul>

<h4>Indication Listener</h4>

The generic components for a CIM Listener and a

listener API are operational.  This includes the functions for

HTTP, XML indication input and response, and consumers of indications.

This code can be used to define a separate listener package and is used

as an indication listener in the Pegasus server.

Pegasus 2.5

includes a new standalone listener that is separate

from the current standalone CIMListener and the ExportServer listener

in the CIM server.

The use model that this listener fits is the following:

<ul>

<li> The listener may be packaged as

part of the CIMOM or it may be packaged independently as part of

another application. </li>

<li> Consumers

are developed independently of the listener and may be shipped with the

listener or added to an installed listener at a future time. </li>

</ul>

<span

style="color: rgb(0, 0, 0);"> <span

style="color: rgb(0, 0, 0);">This

new "Dynamic Listener" provides a solution for the above use model. It

is essentially a lightweight, pluggable listener that

provides a small set of management features. The DynamicListener can be

run inside a daemon or a service. It is easily configurable and

bypasses traditional registration procedures.  See <a

href="http://www.openpegasus.org/pp/protected/upreviews/20/1303/PEP195_CIMListenerEnhancementsv1_6.htm"><span

style="color: rgb(51, 51, 255); text-decoration: underline;">PEP 195</a> <span

style="color: rgb(255, 0, 0);"> for

details.

<h4>Object Normalization</h4>

The Object Normalizer is an entity introduced in Pegasus 2.4 that

ensures

objects delivered from providers are complete and accurate. Two major

issues were identified with the initial implementation: 1) the Object

Normalizer drops instances it considers bad, and 2) the Object

Normalizer code slows performance. These issues are now addressed by

moving the Object Normalizer from the Dispatcher to the Response

Handler (or equivalent) and optimizing the existing implementation. The

move allows errors to be reported to the provider at the point of

delivery and ensures that only a single copy is made to preserve the

CIMOM/provider boundary.

Two new configuration properties were added to control object

normalization.

<ol>

<li>enableNormalization (true|false) - Enables or disables object

normalization for provider objects.</li>

<li>excludeModulesFromNormalization (colon delimited list of

provider modules) - List the provider modules by name (as specified in

PG_ProviderModule.Name) to exclude from normalization. Keep in mind

that all objects managed by all providers will be excluded from

normalization if its module name appears in this list.

</li>

</ol>

<h4>Embedded Object support</h4>

Pegasus 2.5 now provides embedded object support. The proposed solution

is restricted to the following:

The only representation for embedded objects supported by this

PEP is CIM-XML.

CIMObject is implemented as a new CIMValue type. This type will be used

internally to represent embedded objects. When externalized (via

CIM-XML) these objects will be converted to strings representing valid

INSTANCE or CLASS elements, in accordance with the CIM Infrastructure

Specification.  Embedded instances will also carry the

EmbeddedObject attribute with

the value "object", as specified by CR Interop-00217.001.

</blockquote>

<h4>Query Language</h4>

The query language today is based on WQL and is implemented and

used for filters and in 2.4 for execQuery.

CQL Stage 1 has been included for Pegasus 2.5.  PEPs 138,

193, 205 combine to describe the function submitted.

<h4>Schema Repository</h4>

By default, Pegasus uses an XML-based

schema repository. A binary encoding option is also available.<span

style="font-family: "times new roman";">

To use the binary encoding feature a new configuration

properties was

added:

enableBinaryRepository (true|false) - Enables

disables binary repository.

<div style="margin-left: 40px;"> In addition to the binary

repository, the compressed repository

functionality has

been added as a build time conditional compile. It defaults to not

support

compression. When enabled the zlib library, used for the compression

algorithims, must be installed on the build and target systems. With

compression enabled records are always written compressed but both

compressed

and non-compressed records can be read allowing an easy migration path.

Note:  <span

class="norm">Note:

Users may experience an incompatibility moving a binary repository from

Pegasus 2.4 to 2.5. In Pegasus 2.5, measures have been taken to improve

the ability to maintain compatibility with subsequent releases. (See

bugzilla 3642 for details.) <span

style="color: rgb(51, 102, 255);">See bugzilla 3642 for details.

</div>

<h4>Compressed Repository</h4>

<div style="margin-left: 40px;"><font

style="color: rgb(0, 0, 0);" color="RED">A compressed repository

feature has been added for

pegasus 2.5 that compresses the repository written to disk. This allows

the

repository to be as much as 50% smaller on disk. It uses an external

compression library (zlib) and has been tested with zlib 1.2.2. This

feature is

documented in PEP 214 and also in a Readme

(readme.compressed_repository). It is

considered experimental today because it is not in the automated tests.

Note

that the tests for this feature are in the test suite but not

activiated for

automatic tests.

</div>

<h4>Instance Repository</h4>

The

Pegasus schema repository may also be configured to hold instance

data.  <font

style="color: rgb(0, 0, 0);">Although instances may be place in the

repository

it was not designed as a

high volume data store.

<h4>Security Considerations

</h4>

OpenPegasus 2.5 (and

prior) contains several mechanisms to perform authorization, but none

of these authorization checks are performed by default.

By registering any provider which fails to do appropriate authorization

checks, the consequences may include information leakage, data

corruption, or unintended elevation of privilege. Please ensure that

one of the following mechanisms is used to ensure appropriate access to

your systems and data:

1. Only install/register providers which perform authorization

appropriate for your environment.

<div style="margin-left: 40px;"><font style="color: rgb(0, 0, 0);"

color="RED">a. For providers, this may include registering to

'Run-as-requestor' (not available prior to Pegasus 2.5) and/or

performing authorization checks within the provider.

b. For administrators, ensure that the providers you have registered in

your environment have performed sufficient authorization checks. Also,

monitor announcements of security defects in those providers and follow

the recommendations in those announcements as soon as possible.

c. For distributors of Pegasus or providers, ensure that the providers

you are shipping have performed appropriate authorization checks, and

relay announcements of discovered security defects to your users.

</div>

2. Restrict users with

access to Pegasus to a specific authorized user group of trusted

individuals.

3. Namespace authorization is also available.

For administration issues please refer to

the SSL Admin Guide found at:   pegasus/doc/PegasusSSLGuidelines.htm

<h4>Server Security</h4>

<li class="MsoNormal" style="color: black;">Basic Authentication

(Note that Digest based security is not implemented)</li>

<li class="MsoNormal" style="color: black;">PAM authentication <o:p></o:p></li>

<li class="MsoNormal" style="color: black;">SSL support - SSL is

implemented in Pegasus using the OpenSSL

libraries. Pegasus does not provide the OpenSSL

libraries but SSL can be used on any platform supported by <span

class="SpellE">OpenSSL.  Minimum level known to work

is  0.9.6c .   This release of Pegasus was tested with

0.9.6k.  See <a

href="http://www.openpegasus.org/pp/uploads/40/Application%20Data/Microsoft/Word/www.openssl.org">openssl.org</a>

for OpenSSL release information<o:p>.</o:p></li>

<li class="MsoNormal" style="color: black;">SSL levels

SSLv3

and TLSv1 by default. SSLv2 is

disabled by default and only enabled by a compile time option.

See<a

href="http://www.openpegasus.org/pp/protected/doc.tpl?CALLER=index.tpl&gdid=8502">

PEP 200</a> for details on

configuration.

</li>

</ol>

<h4>Client Security<span

style="font-style: italic;"></h4>

Certificate management 

and User-based certificate authentication . A new control provider and

CLI for certificate management tasks. It expands upon the existing SSL

client verification support by providing a robust solution to managing

client certificates and certificate revocation lists via standard CIM

operations. It allows certificates to be associated with particular

system users for enhanced authorization capabilities.

CN/ Host

name checks are not performed as a function of SSL or client libraries

and are the responsibility of the client to implement on their

own.  See the SSL guide found in the /pegasus/doc directory for

more details on client security.

Note: <span

style="color: rgb(0, 0, 0);">WBEM clients are responsible for SSL

certificate verification using Pegasus and/or SSL libraries as

appropriate. Consequences of not doing so include leakage of

authentication credentials to unauthorized parties.

<h4>Platform Management Functions</h4>

<li class="MsoNormal" style="color: black;">Configuration through

the defined configuration parameters (cimconfig) and server command

line options.<font

style="color: rgb(0, 0, 0);" color="RED">  NOTE: When installed

as a service on Windows, setting the run-time config option

enableAuthentication to true can result in improper operation of the

SLP

provider and other providers. In order to circumvent this defect, an

Administrator should change the user that the service runs under from

the Local

System user to a local, privileged user (e.g. Administrator).

See bugzilla 4142 for details. <o:p></o:p></li>

<li class="MsoNormal" style="color: black;">Daemon/service

operation of the Pegasus CIM Server on all supported platforms<o:p>

with the exception of HP OpenVMS.

</o:p></li>

<li class="MsoNormal" style="color: black;">Operation statistics

capture using the <font

style="color: rgb(0, 0, 0);">CIM_StatisticalData classes in

the DMTF Interop model. This

function is considered alpha quality and conditionally compiled.

</li>

<li class="MsoNormal" style="color: black;">Multiple

pluggable provider managers.  Provider managers are provided for

the Pegasus C++ provider interface, the CMPI C provider interface and

an alpha quality Java provider interface (JMPI).</li>

<li class="MsoNormal" style="color: black;">Platform Globalization

- Pegasus includes support for unicode data transfers and includes a

mechanism for message support in multiple languages using the open

source ICU libraries (<a href="http://oss.software.ibm.com/icu/">http://oss.software.ibm.com/icu/</a>).

Note that this is still marked experimental.</li>

<li class="MsoNormal" style="color: black;">Out-of-process

providers (Experimental) - See PEP 072 for more information on use of

this feature </li>

<li class="MsoNormal" style="color: black;">Shared class namespaces

(Experimental) - See PEP 129 for more information on use of this feature</li>

<li class="MsoNormal" style="color: black;">Remote providers for

the CMPI provider interface (Experimental) - See PEP 130 for more

information on use of this feature</li>

</ol>

<h4>SLP Discovery</h4>

SLP support is included but is conditionally compiled in or out on

a platform basis. <a

href="http://www.openpegasus.org/pp/uploads/40/8502/PEP200_RecommendedReleaseOptions.htm">

PEP 200</a> describes the use of proper environment variable use to

enable or disable this code.  PEGASUS_DISABLE_SLP and

PEGASUS_ENABLE_SLP are the environment variables that control inclusion

of this feature.  Once compiled, SLP

support is enabled with the slp configuration parameter (slp=true). SLP

support includes an SLP service agent in the Pegasus CIM sever and

generates SLP advertisements compatible with the DMTF slp template

specification. The SLP support also includes  extensions to the

CIM Client libraries to execute SLP User Agent requests and analyze the

results (note that these interfaces are not yet part of the Pegasus

public SDK).

Note: Pegasus on Windows is built with SLP support on by default and to

exclude it from the build, then PEGASUS_DISABLE_SLP must be set.

<h4>Provider Managers</h4>

Pegasus is designed to support multiple Provider Managers to allow

multiple provider interfaces to the CIMOM.  The two default

provider managers are the Pegasus C++ Interface and Common

Manageability Programming Interface (CMPI) Interface.

<h5>CMPI C interface Provider Manager<o:p></o:p></h5>

Pegasus 2.5 includes

a provider manager for the CMPI C interfaces. This C interface is the

result of a project by the IBM SBLIM team (see 

http://sblim.sourceforge.net) and is written to the Common

Manageability Programming Interface, which is an OpenGroup standard.

The CMPI

specification is available at:

http://www.opengroup.org/bookstore/catalog/c051.htm. This provides a

standardized C level interface for creating providers that can be

registered with the Pegasus CIM Server in the same manner as the

current C++ providers.  <span

style="font-family: "times new roman";">The

ability for CMPI providers to do user authorization is now available in

Pegasus 2.5.

Information on writing providers with the CMPI interface is available

in the specification today (see above) and in the following documents

(http://sblim.sourceforge.net/whitepaper.html and

http://sblim.sourceforge.net/presentations.html) and readme.cmpi in the

Pegasus source root directory.

<h5>JMPI Java Interface Provider Manager</h5>

Pegasus includes an experimental provider manager for Java

provider interfaces based on the SNIA provider interface

definitions.  This provider manager is  considered alpha

quality and is not compiled in the default build.   See

readme.jmpi in the Pegasus source root directory for more information.

</blockquote>

<h3>    Providers</h3>

<div style="margin-left: 40px;">New for 2.5 is the ability of Providers

to run out of process at

request user- level and running CMPI providers remotely or out of

process space.

Administrators should check the providers to

ensure that the provider vendor

has made use of available authorization capability.

</div>

There are a number of providers available

in the Pegasus release.

This includes providers in the following categories:

<h4>Pegasus Internal Providers</h4>

Pegasus provides a set of "internal" providers that have direct

access to the CIMOM for information and provide information and

services to support the CIMOM and its administration.    The

providers in this category are mostly defined in the directory

src/pegasus/controlproviders and include support for the following

classes:

<ul>

<li>DMTF Interop classes including __Namespace,  <span

class="SpellE">CIM_Namespace, CIM_ObjectManager,

CIM_CommunicationMechanism, and

CIMOMStatistics.</li>

</ul>

<h4>CMPI Remote</h4>

Pegasus includes an experimental support for

running CMPI providers to be run on remote systems without the need for

an extra CIMOM. It uses a special proxying provider to relay requests

to a remote location using so-called communication layers. The remote

side has to start a CMPIRDaemon process, which accepts remote requests

and passes them on to CMPI style providers.

<h4>Generic Providers</h4>

Generic OperatingSystem provider. See

the

directory src/Providers/generic.

<h4>Test/Sample Providers</h4>

See the directories src/Providers/TestProviders

and src/Providers/Sample for more

information about test and

sample providers.

<h4>Managed System Providers</h4>

ComputerSystem, DNSAdmin,

DNSService, Operating System, Process,

Processor. For

more information on these providers see the documentation for each

provider in

the directory src/Providers/ManagedSystem

<h4>Server Statistics

</h4>

CIM Server statistics, based on the DMTF 'CIM_StatisticalData' class,

are implemented in this release. The statistics gathering is disabled

by default. It may be enabled or disabled by performing a

ModifyInstance operation on the singleton 'CIM_ObjectManager' instance

in the 'PG_InterOp' namespace to set the GatherStatisticalData property

to 'true' or 'false'. This property setting is persistent across CIM

Server restarts. A statistics display test tool, cimperf, is available

from the Pegasus CVS repository.

<h4>

</h4>

<h4>SLP Provider</h4>

This provider acts as the definer of

SLP information for SLP registration and also controls the Pegasus SLP

Service Agent. It is treated as a normal provider rather than a control

provider because it does not use internal functions of the CIMOM to

generate any of its information today. (conditionally compiled today)

</blockquote>

<h3>CIM_Schema</h3>

The default CIM_Schema loaded with this

release is

the DMTF CIM 2.9, Final release.  In addition, Pegasus includes

a number of

local classes defined for Pegasus.  These are defined in the

pegasus/Schemas

directory.   There are also a

number of older schema available in the CVS.

The mechanism to install other schemas than the default is defined

in the mak/config.mak

NOTE: The CIM 2.5 schema is

maintained in the

CVS repository because it remains the basis for parts of the Pegasus

test

environment.

<h3>Pegasus MOF Compilers</h3>

Pegasus implements a MOF compiler that can operate either at the

client

interface to the Pegasus CIM Server (cimmof)

or directly interfacing with a CIM

repository (cimmofl).

The direct interface compiler is used primarily to provide an

initial

class/instance repository. WARNING:

the use of cimmofl

to manipulate instances in the repository bypasses any provider that is

registered to serve these  instances and simply installs the

instances in the

instance repository; this may result in 1) bad data in the repository

if there are registered providers, 2) corruption of the repository if

the CIM Server is running or, 3) MOF data that is loaded but not

available until the server is stopped and restarted in some

cases.  Use of cimmofl in general is

discouraged and particularly  to manipulate

instances served by a registered providers (ex. Provider registration).

<h3>Client Tools</h3>

Lightweight statistics are now implemented for

the

client. The client statistics surfaces the elapsed time spent in the

client,

and the

elapsed time spent on the network between client and server.

<h3>Pegasus CIM Server Administration</h3>

<li class="MsoNormal" style="color: black;">cimuser

- Manage Pegasus CIM Server Users.<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">cimconfig

- Manage the Pegasus CIM Server configuration parameters.<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">cimauth

- Manage the CIM Server authorization characteristics. Today this is

authorizing users to namespaces.<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">cimprovider

- Manage information about the providers .</li>

</ol>

Server admin

note:

<div style="margin-left: 40px;">The default behavior for determining

the CIM server's HTTP and HTTPS ports has changed.  In previous

releases, any value in /etc/services would override a port explicitly

specified in the configuration.  The new order for determining the

CIM server's HTTP and HTTPS ports is as follows:

1) An explicitly specified port value takes precedence over any other

values.

</div>

<div style="margin-left: 40px;">2) If no port is specified, the value

in /etc/services is used.

3) If no value is specified in /etc/services, the default WBEM port is

used.

</div>

<h3>Information client tools</h3>

These tools provide information on the objects managed by the server.

<li class="MsoNormal" style="color: black;">tomof

- output classes and/or instance information from the Pegasus

repository in MOF or XML format.<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">dnsinfo

- Generate a set of standard information on the Domain

Name System (DNS) configuration from CIM Classes. Note that the

information generated is dependent on the information available from

providers and differs from system to system.<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">ipinfo

- Generates a set of standard information from the Network

Schema.  Information generated varies by system because of the

level of provider support.<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">osinfo

- Generate a set of standard information on the Operating System from

CIM Classes. Note that the information generated is dependent on the

information available from providers and differs from system to system<o:p></o:p></li>

</ol>

<h3>Test support Tools</h3>

<li class="MsoNormal" style="color: black;">Pegasus unit tests

(available through the "tests" option on the Pegasus make files) these

tests are defined throughout the Pegasus source tree typically in

"tests" directories.        <o:p></o:p></li>

<li class="MsoNormal" style="color: black;">The Pegasus test suite

(see the pegasus/tests directory)<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">TestClient

- Basic client for overall platform operation testing. <o:p></o:p></li>

<li class="MsoNormal" style="color: black;">wbemexec

- Test tool that sends/receives XML from XML input.<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">CLI - Command line

interface for Client commands.<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">Benchmark Test - A

benchmark test environment is provided which includes both a client and

provider component. See src/clients/benchmarkTest

for more information.<o:p></o:p></li>

</ol>

<h3>Pegasus Interface APIs</h3>

Details of the Pegasus public interfaces for this release are listed

in PEP 209

available from the web site(<a

href="http://www.openpegasus.org/pp/uploads/40/Administrator/My%20Documents/processes/www.openpegasus.org">www.openpegasus.org</a>).

That document is the authorative source

for the list of publicly supported Pegasus APIs.   The Client

and Provider API were originally frozen at the Pegasus version 2.1

release. The interfaces in the release of Pegasus 2.1 are forward

compatible to this release. Well-behaved clients and providers compiled

to the Pegasus 2.1 or 2.2 interfaces should be compatible with this

release without compilation.  There have been extensions and new

interfaces added for this release and these are marked as experimental.

  The Pegasus public

interfaces includes the following major functions

<li class="MsoNormal" style="color: black;">Client APIs<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">Provider APIs<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">CIM Object and System

function APIs</li>

</ol>

In addition, there are other client interfaces which are not today

in the public SDK including:

<li class="MsoNormal" style="color: rgb(0, 0, 0);"><span style=""

lang="DA">CIM Listener APIs</li>

<li class="MsoNormal">CIM Listener

is a component that can be used to consume indications without a

dependency on the Pegasus CIMOM. In environments where no CIMOM is

running or a physical separation between the indication listener and

the CIMOM is desired, CIM Listener fits the bill. Still, there are

several enhancements that are necessary to make CIM Listener scalable. <font

style="color: rgb(0, 0, 0);">Enhancements were deemed significant

enough to propose a new listener that builds off CIMListener's

basic capabilities, yet allows the existing CIMListener to remain the

same.</li>

<ul>

<li>New CIM Listener now provides selective

indication delivery.

</li>

<li>New CIM Listener

keeps all consumer libraries in memory for the duration of its

execution.

</li>

<li>New CIM Listener

is now pluggable.

</li>

<li>New CIM Listener

now provides reliable indication delivery.</li>

</ul>

<li class="MsoNormal" style="color: black;">SLP

Client (User Agent) APIs which are extensions to the Client APIs</li>

</ol>

<o:p> </o:p>

The APIs are

documented in

their respective header files and  in HTML documentation based on

the information

in the header files extracted with the doc++ tool will be available on

the

OpenPegasus web site.

<o:p></o:p>

<h3>WMI Mapper</h3>

The WBEM to WMI Mapper provides a way

to access

WMI data from Windows platform systems. It converts incoming XML/CIM

requests

to Microsoft WMI requests, executes the requests, converts the results

XML/CIM and returns the results to the client. WMI Mapper

receives an HTTP message containing the XML/CIM request. It decodes the

XML

message and extracts from the HTTP message header the user credentials

provided

on the connection (username and password). The WMI Mapper

authenticates these credentials, verifying if the provided credentials

have

access to the desired WMI data. This is done because the WMI <span

class="SpellE">Mapper runs as a service, logged on using an

account with

administrative rights (which has all access to WMI data). Because of

this, the

WMI Mapper impersonates the user

credentials provided

on the HTTP message to ensure that the calling user has rights to

browse WMI

data. Hence, ALL requests made to the WMI Mapper

MUST

contain user credentials.

<h3>Indication Handlers</h3>

System Log Indication Handler

<div style="margin-left: 40px;">The SysLog Indication Handler is a new

for 2.5

type of Indication Handler which allows CIM Indications to be delivered

to the system syslog file. It has following features:

</div>

<ul>

<li>Each syslog file entry has a tag 'CIM Indication' to distinguish

an entry made by Syslog Indication Handler.</li>

</ul>

<ul>

<li>If a subscriber includes PerceivedSeverity property in the SELECT

list of the filter condition for the indication, the PerceivedSeverity

will be mapped to syslog error severity. Otherwise, syslog error

severity 'LOG_INFO' is used.</li>

<li>See <a

href="http://www.openpegasus.org/pp/uploads/40/7165/PEP206-SystemLogIndicationHandler.htm">PEP

206</a> for details.

</li>

</ul>

Email Indicaiton Handler

<div style="margin-left: 40px;">The Email Indication Handler is a new

for 2.5

type of Indication Handler that allows CIM Indications to be delivered

to a specified e-mail address.   See <a

href="http://www.openpegasus.org/pp/uploads/40/7166/PEP207-EmailIndicationHandler.htm">PEP

207</a>  for details.

</div>

<ol>

</ol>

<h2><a name="Relationship_to_CIMWBEM_Standards"></a>Relationship to

CIM/WBEM Standards</h2>

Pegasus was designed and implemented to comply with the DMTF

specifications The following table defines the level of the DMTF

specifications which which Pegasus conforms today.

<tbody>

<tr>

<td bgcolor="#00ffff" width="33%">DMTF Specification</td>

<td bgcolor="#00ffff" width="33%">Specification Version</td>

</tr>

<tr>

<td width="33%">DSP 0004 CIM Specification</td>

<td width="33%">Version 2.2 with Addendum</td>

</tr>

<tr>

<td width="33%">DSP 0200 - CIM Operations over HTTP</td>

<td width="33%">1.1, final, 6  January 2002</td>

</tr>

<tr>

<td width="33%">DSP 0201 - Representation of CIM in XML</td>

<td width="33%">2.1, preliminary, May 2, 2002</td>

</tr>

<tr>

<td width="33%">DSP 0205 - WBEM Discovery using SLP</td>

<td width="33%">1.0, preliminary, 27 January 2004</td>

</tr>

<tr>

<td width="33%">WBEM SLP Template</td>

</tr>

<tr>

<td width="33%">CIM Schema </td>

<td width="33%">2.9 Final, Jan. 2005</td>

</tr>

</tbody>

</table>

<h2><a name="Supported Platforms">Supported

<h2>PEGASUS Bugs</h2>

Platforms</a></h2>

Each Pegasus release lists as 'active' platforms those

The current bug list for Pegasus is openly available on the OpenPegasus web

hardware/software platforms that have recognized ports for the Pegasus

site.  As of the release of 2.3.2 release date, the following list

code

represents what the Pegasus community feels are a subset of  open bugs with OpenPegasus

base including a maintainer for the platform that will be willing to

2.3.2 that may be of particular interest to users. Please see the bug reports

regularly document issues and/or fix defects as the Pegasus

(the number is a link to the report) to determine if there are any workarounds,

code base is changed. 

patches, etc. for particular bugs.

Pegasus may be operable on other platforms (ex. Windows 98) but without

a group

<o:p> </o:p>

to provide the role of test and maintenance, correct operation of 

Pegasus cannot be

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=730

assured.  In all cases, including the active platforms, it is the

style='width:437.95pt;mso-cellspacing:0in;mso-padding-alt:2.4pt 2.4pt 2.4pt 2.4pt'>

responsibility of the entity that packages and/or compiles OpenPegasus

for shipment or deployment, to read, and actively monitor the Pegasus

bugzilla database for a list of relevant defects that affect their

<span

platform.   The platforms that are considered 'active' for this

style='mso-fareast-font-family:"Times New Roman"'><a

Pegasus release are:

href="buglist.cgi?short_desc_type=allwordssubstr&short_desc=&product=Pegasus+CLI+Commands&product=PegasusCIMOM&product=PegasusClient&product=PegasusCompiler&product=PegasusGeneral&product=PegasusJavaCIMClient&product=PegasusProvider&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=VERIFIED&priority=P1&priority=P2&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&newqueryname=&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.bug_id">ID</a>

<o:p></o:p>

</td>

<table class="MsoNormalTable" style="width: 302.25pt;" border="1"

cellpadding="0" cellspacing="1" height="409" width="504">

<span

<tbody>

style='mso-fareast-font-family:"Times New Roman"'><a

<td

class=SpellE>Sev</a> <o:p></o:p>

style="padding: 0.75pt; background: rgb(153, 255, 153) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial; width: 126.75pt;"

</td>

height="26" width="211">

Platform and

<span

OS<o:p></o:p>

style='mso-fareast-font-family:"Times New Roman"'><a

</td>

<td

class=SpellE>Pri</a> <o:p></o:p>

</td>

height="26" width="289">

Compilers<span

<span

style="color: black;"><o:p></o:p>

style='mso-fareast-font-family:"Times New Roman"'><a

</td>

</tr>

class=SpellE>Plt</a> <o:p></o:p>

</td>

<td style="padding: 0.75pt; width: 126.75pt;" height="25"

width="211">

<span

HP-UX<o:p></o:p>

style='mso-fareast-font-family:"Times New Roman"'><a

</td>

<td style="padding: 0.75pt; width: 173.25pt;" height="25"

<o:p></o:p>

width="289">

</td>

HP <span

</tr>

class="SpellE">aC++ B3910B<o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=14">14</a> <o:p></o:p>

<td style="padding: 0.75pt; width: 126.75pt;" height="25"

</td>

width="211">

<span

nor

style="color: black;">Linux on Power<span

<o:p></o:p>

style="color: black;"><o:p></o:p>

</td>

<td style="padding: 0.75pt; width: 173.25pt;" height="25"

P2

width="289">

<o:p></o:p>

<span

</td>

style="color: black;">gcc<o:p></o:p>

</td>

All

</tr>

<o:p></o:p>

</td>

<td style="padding: 0.75pt; width: 126.75pt;" height="25"

width="211">

MOF

<span

Compiler does not support aliasing <o:p></o:p>

style="color: black;">zLinux<o:p></o:p>

</td>

</tr>

<td style="padding: 0.75pt; width: 173.25pt;" height="25"

width="289">

<span

<a

style="color: black;">gcc<o:p></o:p>

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=377">377</a> <o:p></o:p>

</td>

</tr>

<span style='mso-fareast-font-family:

<td style="padding: 0.75pt; width: 126.75pt;" height="25"

"Times New Roman"'>enh<span style='mso-fareast-font-family:

width="211">

"Times New Roman"'> <o:p></o:p>

Linux Itanium<o:p></o:p>

</td>

<td style="padding: 0.75pt; width: 173.25pt;" height="25"

P2

width="289">

<o:p></o:p>

<span

</td>

style="color: black;">gcc<o:p></o:p>

</td>

PC

</tr>

<o:p></o:p>

</td>

<td style="padding: 0.75pt; width: 126.75pt;" height="25"

width="211">

<span style='mso-fareast-font-family:

Linux IA-32<o:p></o:p>

"Times New Roman"'>Multireq<span style='mso-fareast-font-family:

</td>

"Times New Roman"'> not supported <o:p></o:p>

<td style="padding: 0.75pt; width: 173.25pt;" height="25"

</td>

width="289">

</tr>

<span

style="color: black;">gcc

(versions 2.9x and 3.xx)<o:p></o:p>

<a

</td>

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=424">424</a> <o:p></o:p>

</tr>

</td>

<td style="padding: 0.75pt; width: 126.75pt;" height="91"

nor

width="211">

<o:p></o:p>

Windows 2000<o:p></o:p>

</td>

<td style="padding: 0.75pt; width: 173.25pt;" height="91"

P2

width="289">

<o:p></o:p>

Microsoft

</td>

Visual C++ Ver 6 and Microsoft .Net compiler Version.   <span

style="color: black;">Works on VC .NET 2003 (aka

All

v7.1)<o:p></o:p>

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>XMLParser<span style='mso-fareast-font-family:

"Times New Roman"'> removes whitespace <o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=482">482</a> <o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>maj<span style='mso-fareast-font-family:

"Times New Roman"'> <o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

PC

<o:p></o:p>

</td>

Absence

of REFERENCECLASSNAME in XML causes error <o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=544">544</a> <o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>maj<span style='mso-fareast-font-family:

"Times New Roman"'> <o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

All

<o:p></o:p>

</td>

MOF

compiler does not convert escape characters <o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=786">786</a> <o:p></o:p>

</td>

nor

<o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

PC

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>CIMRepository<span style='mso-fareast-font-family:

"Times New Roman"'> enumerateinstances <span

class=SpellE>deepInheritance, etc. procesing

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=1054">1054</a> <o:p></o:p>

</td>

nor

<o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

PC

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>cimserver<span style='mso-fareast-font-family:

"Times New Roman"'> stop responding after stress query of repository <o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=1179">1179</a> <o:p></o:p>

</td>

nor

<o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

All

<o:p></o:p>

</td>

Sample

providers should not be declared in Pegasus namespace <o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=1195">1195</a> <o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>maj<span style='mso-fareast-font-family:

"Times New Roman"'> <o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

All

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>ResponseHandler<span style='mso-fareast-font-family:

"Times New Roman"'> should clone CIM* objects before modifying

them

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=1285">1285</a> <o:p></o:p>

</td>

nor

<o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

PC

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>EnumerateInstanceNames<span

style='mso-fareast-font-family:"Times New Roman"'> generates namespace error <span

class=SpellE>CIMException

</td>

</tr>

</table>

<tr>

<td style="padding: 0.75pt; width: 126.75pt;" height="69"

<span style='mso-fareast-font-family:"Times New Roman";

width="211">

display:none;mso-hide:all'><o:p> </o:p>

Windows XP<o:p></o:p>

</td>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=742

<td style="padding: 0.75pt; width: 173.25pt;" height="69"

style='width:445.35pt;mso-cellspacing:0in;mso-padding-alt:2.4pt 2.4pt 2.4pt 2.4pt'>

width="289">

Microsoft

Visual C++ Ver. 6 and Microsoft .Net compiler Version 7.1<span

<a

style="color: black;" lang="NL"><o:p></o:p>

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=1307">1307</a> <o:p></o:p>

</td>

</tr>

<span style='mso-fareast-font-family:

<td style="padding: 0.75pt; width: 126.75pt;" height="43"

"Times New Roman"'>maj<span style='mso-fareast-font-family:

width="211"> MacOS version 10.2 and higher</td>

"Times New Roman"'> <o:p></o:p>

<td style="padding: 0.75pt; width: 173.25pt;" height="43"

</td>

width="289"> gcc 3.3</td>

</tr>

P2

<tr>

<o:p></o:p>

<td style="vertical-align: top;"><big>HP OpenVMS Alpha

</td>

</big></td>

<td style="vertical-align: top;"> <big><font

All

style="color: rgb(0, 0, 0);" color="RED">HP C++ V6.5-042 for OpenVMS

<o:p></o:p>

Alpha and above</big> </td>

</td>

</tr>

<tr>

Functionality on errors with Enumerate Functions. Should we

<td style="vertical-align: top;"><big><font

generate error or send existing data. Today we pass data.

style="color: rgb(0, 0, 0);"> HP OpenVMS IA64</big></td>

</td>

<td style="vertical-align: top;"><big><font

</tr>

style="color: rgb(0, 0, 0);">HP C++ V7.1-011 on OpenVMS IA64 and above</big>

</td>

</tr>

<a

<tr>

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=1330">1330</a> <o:p></o:p>

<td style="vertical-align: top;"><big><font

</td>

color="RED">Solaris 8

* See below for additional info

nor

</big></td>

<o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

PC

<o:p></o:p>

</td>

MOF compiler does not handle "/* ... */" comments.

</td>

</tr>

1400</a></td>

maj</td>

P1</td>

All</td>

Disabling https prevents indication delivery through http.</td>

</tr>

</tbody>

</table>

Solaris:  Solaris testing

<o:p></o:p>

began late in the 2.5 release cycle, thus has not been thoroughly

tested.  In order for Pegasus 2.5 to function properly on that

<h2>List of Bugs Corrected in Pegasus 2.3

platform, changes documented in OpenPegasus Bugzilla 4179  must be

</h2>

applied.

The current bug list for Pegasus is openly available on the OpenPegasus web

<h2>Platform patches</h2>

site bug database.  This site defines the mechanism so that the user can list the bugs

The following is a list of platform

that have been fixed between the release of Pegasus 2.2 and the current release.

patches Pegasus requires.

<h2>Documentation</h2>

<div style="margin-left: 40px;">RHAS

2.1 needs the update to fix Red Hat Bugzilla 98815.

The following documentation is available for the this Pegasus release:

</div>

Further information regarding Pegasus support on IBM platforms can

<li class=MsoNormal style='color:black;mso-list:l2 level1 lfo33;tab-stops:

list .5in'>Pegasus Build and Installation - Readme in

found at: <a

the Pegasus Root Directory<o:p></o:p></li>

href="http://publib.boulder.ibm.com/infocenter/eserver/v1r1/en_US/index.htm?info/icmain.htm"><span

<li class=MsoNormal style='color:black;mso-list:l2 level1 lfo33;tab-stops:

style="text-decoration: underline; color: rgb(51, 51, 255);">http://publib.boulder.ibm.com/infocenter/eserver/v1r1/en_US/index.htm?info/icmain.htm</a>

list .5in'>Pegasus Operation - Readme in the Pegasus

Root Directory<o:p></o:p></li>

<li class=MsoNormal style='color:black;mso-list:l2 level1 lfo33;tab-stops:

Further information regarding Pegasus support on HP platforms can be

list .5in'>APIs - See the header files and the HTML  API documentation that is

found at:

on the web site. <o:p></o:p></li>

<a href="http://www.hp.com/go/wbem">http://www.hp.com/go/wbem</a>.

<li class=MsoNormal style='color:black;mso-list:l2 level1 lfo33;tab-stops:

<o:p>

list .5in'>Utilities - A combination of help generally available with the

</o:p>

-h option for each command and HTML documentation for most of the tools.<o:p></o:p></li>

<h2><a name="Conformance with DMTF Specifications">Conformance with

<li class=MsoNormal style='color:black;mso-list:l2 level1 lfo33;tab-stops:

DMTF Specifications</a></h2>

list .5in'>API usage documentation - The best API usage documentation is

It is a major goal

the existing utilities and test programs and the examples in the API

of the OpenPegasus project to both drive and utilize the DMTF CIM/WBEM

documentation.  In particular the

specifications.  However, today there are a number of known

Common/tests unit tests contain extensive examples of the use of the

differences. 

Common APIs.</li>

As of this release, some of the differences include the following:

<li class=MsoNormal style='color:black;mso-list:l2 level1 lfo33;tab-stops:

<ol>

list .5in'>Building and Debugging Providers - Readme in the Pegasus Root

<li>Provider Registration - Pegasus supports registration

Directory, API documentation, and documentation from the Pegasus Technical

through a set of Pegasus Provider registration classes rather than

Workshop which is available on the Pegasus web site.</li>

support the DMTF defined Provider Qualifier. Pegasus will not support

<li class=MsoNormal style='color:black;mso-list:l2 level1 lfo33;tab-stops:

this qualifier in the future. See the readme for more information on

list .5in'>Building and Debugging Clients - API documentation and the

provider registration.</li>

documentation on the Pegasus Technical Workshop which is available on the

<li> Indications -Today Pegasus supports process

Pegasus web site.</li>

indications but does not

include any specific support for lifecycle indications.</li>

<li>

<font

style="color: rgb(0, 0, 0); font-weight: bold;">IncludeQualifiers

option on Instance Operations

The DMTF specifications are unclear regarding the inclusion of

qualifiers on

CIM instances.  Some CIM Client implementations expect instances

returned

from the CIM Server to include the qualifiers defined in the class

definition (such as KEY qualifiers on properties).   Pegasus

today expects the provider to complete the qualifiers on instances in

accordance with the specification and generally the interpretation is

that Pegasus applies class level qualifiers when the includeInstance

parameter is supplied on instance operations.  However, Pegasus

today is inconsistent in the return of qualifiers so that the user

should NOT depend on Pegasus accurately honoring the includeQualifier

parameter for instance operations.  In the future it is expected

that Pegasus will deprecate the use of qualifiers on instance

operations completely.

</li>

<li>LocalOnly option on instance

Operations - With the 1.1 version of Specification for CIM

Operations over HTTP, the definition of the LocalOnly parameter for the

GetInstance and EnumerateInstances operations was modified. This change

was incorrect, resulted in reduced functionality and introduced a

number of backward compatibility issues. As a result of issues

introduced by this change, we strongly recommend that CIM Clients set

LocalOnly = false and do not rely on the use of this parameter to

filter the set of set of properties returned.</li>

<li>

CIM MOF compiler function for

instance aliasing - The Pegasus MOF compiler does not today support

this function.  This function is planned for a future version.

</li>

<li>

MultiRequest Oprations - Pegasus

does not support the DMTF defined MultiRequest Operation option.

</li>

<li>

MOFCompiler namespace pragma - The

Pegasus compiler does not support the namespace pragma.

</li>

</ol>

<h2><a name="Changes in This Release">Changes in This Release</a></h2>

The development and release of each version of Pegasus is defined

and

controlled through Pegasus PEP documents.  PEP 180 is the

controlling document

this release and lists the original set of changes proposed and the

status of

each of those changes. Note that not all of the originally defined

functionality was completed for this release.

In general, the areas of development for this release were:

Addition of CQL

stage 1 support

</li>

Refactoring of

Object Normalizer function to improve performance.

</li>

Out of Process

Provider user level request.

</li>

Embedded Object

support.

</li>

Command Line

Utilities

</li>

CIMDateTime

enhancements

</li>

Completion of

AutoPtr enhancements.

</li>

Certificate

management and user-based certificate authentication

</li>

Completion of HTTP

chunking. Pegasus

now supports HTTP V1.1 transfer encoding otherwise known as chunking .<a

href="http://www.openpegasus.org/pp/uploads/40/5097/PEP140_ChunkedEncoding_4.3.html">

PEP 140</a> describes the implementation details.

</li>

<li class="MsoNormal" style="color: black;">Client side performance

statistics</li>

<li class="MsoNormal" style="color: black;">Syslog Indication handler.</li>

<li class="MsoNormal" style="color: black;">Email Indication handler.</li>

<li class="MsoNormal" style="color: black;">Port to OpenVMS.</li>

</ol>

The complete set of PEPs defined for

this release is defined in PEP 180.

<h2><a name="PEGASUS Bugs">Pegasus defects

</a></h2>

The Pegasus bugzilla database documents any defects found in Pegasus

and  is available through the following link:  <a

href="http://cvs.rdg.opengroup.org/bugzilla/">OpenPegasus bugzilla

database</a>.

<h2><a

name="Pegasus Release Control and Version Definition Documentation">Pegasus

Release Control and Version Definition Documentation</a></h2>

The Pegasus project is controlled largely through a set of documents

(PEPs) that serve as the definition and review mechanism for new and

modified Pegasus functionality and for the definition and documentation

of releases.

Specifically the following PEPs define the characteristics of this

Pegasus release.

<ol>

<li><a

href="http://www.openpegasus.org/pp/protected/upreviews/20/1682/PEP209_ExternalInterface2.5.htm">PEP

209</a> - OpenPegaus 2.5 External Interfaces (as of this document

verion of PEP 230, PEP 209 is listed as draft status)

</li>

<li><a

href="http://www.openpegasus.org/pp/protected/doc.tpl?CALLER=index.tpl&gdid=8502">PEP 

200</a> - OpenPegaus 2.5 Build and Configuration

Option  for Selected

Platforms</li>

<li>PEP 230 - Pegasus 2.5 Release Notes (This document)</li>

<li><a

href="http://www.openpegasus.org/pp/protected/doc.tpl?CALLER=index.tpl&gdid=8503">PEP

227</a> -  Pegasus 2.5 Runtime Packaging Definition

</li>

<li><a

href="http://www.openpegasus.org/pp/protected/doc.tpl?CALLER=index.tpl&gdid=8466">PEP

210</a>  - OpenPegasus 2.5 SDK Packaging Definition</li>

<li>PEP 235  - Pegasus readme.txt for 2.5 (also in the Pegasus

source

tree root directory).</li>

<li><a

href="http://www.openpegasus.org/pp/protected/revdoc.tpl?CALLER=revdocuments.tpl&grid=1411">PEP

180</a> - OpenPegasus Release Definition - This PEP is used

throughout the development of this version as the control point for

functionality that will go into the release and points to all of the

PEPs that represent the Pegasus 2.5 functionality changes.  (as of

this document verion of PEP 230, PEP 180 is listed as draft status)</li>

</ol>

<h2><a name="General Documentation">General Documentation</a></h2>

The following documentation is available for the this Pegasus

release:

<li class="MsoNormal" style="color: black;">Utilities - A

combination of help generally available with the -h option for each

command and HTML documentation for most of the tools.<o:p></o:p></li>

<li class="MsoNormal" style="color: black;">API and  usage

documentation - See the header files and the HTML  API

documentation that is on the web site. The best API usage documentation

is the existing utilities and test programs and the examples in the API

documentation.  In particular the Common/tests unit tests contain

extensive examples of the use of the Common APIs.</li>

<li class="MsoNormal" style="color: black;">Building and Debugging

Providers - Readme.html in the Pegasus Root Directory, API

documentation, and documentation from the Pegasus Technical Workshop

which is available on the Pegasus web site.</li>

<li class="MsoNormal" style="color: black;">Building and Debugging

Clients - API documentation and the documentation on the Pegasus

Technical Workshop which is available on the Pegasus web site.</li>

<li class="MsoNormal" style="color: black;">Compiler operation and

commands - compiler help (cimmofl -h)</li>

<li class="MsoNormal" style="color: black;">PEPs - The

features of Pegasus that have been installed in this and the previous

few versions are defined by Pegasus PEPs that are available on the

OpenPegasus web site.  While these are the original design

documents largely and use in the process of defining and approving the

overall characteristics of new functionality, they serve as a guide to

the design and implementation of these features.</li>

</ul>

<o:p></o:p>

<span

style="color: black;">  <o:p></o:p>

<div class=MsoNormal align=center style='text-align:center'><span

<div class="MsoNormal" style="text-align: center;" align="center"><span

style='color:black'>

style="color: black;">

<hr align="center" color="#009900" noshade="noshade" size="2"

width="100%"></div>

</div>

Hewlett-Packard Development Company, L.P.; IBM Corp.; The Open Group;

VERITAS Software Corporation

Hewlett-Packard Development Company, L.P.; IBM Corp.; The Open Group

Permission is hereby granted,

free of

Permission is hereby granted, free of

charge, to any person obtaining a copy  of this software and

charge, to any person obtaining a copy  of this software and associated

associated

documentation files (the "Software"), to deal in the Software without

restriction, including without limitation the rights to use, copy, modify,

restriction, including without limitation the rights to use, copy,

merge, publish, distribute, sublicense, and/or sell copies of the Software, and

modify,

to permit persons to whom the Software is furnished to do so, subject to the

merge, publish, distribute, sublicense, and/or sell copies of the

Software, and

to permit persons to whom the Software is furnished to do so, subject

to the

following conditions:

THE ABOVE COPYRIGHT NOTICE AND THIS

THE ABOVE COPYRIGHT

PERMISSION NOTICE SHALL BE INCLUDED IN ALL COPIES OR SUBSTANTIAL PORTIONS OF

NOTICE AND THIS

THE SOFTWARE. THE SOFTWARE IS PROVIDED  "AS IS", WITHOUT

PERMISSION NOTICE SHALL BE INCLUDED IN ALL COPIES OR SUBSTANTIAL

WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE

PORTIONS OF

THE SOFTWARE. THE SOFTWARE IS PROVIDED  "AS IS", WITHOUT

WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO

THE

WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE

FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,

LIABLE

TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR

FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF

CONTRACT,

TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE

SOFTWARE OR

THE USE OR OTHER DEALINGS IN THE SOFTWARE.

</div>

</body>

</html>

Legend:

Removed from v.1.3
changed lines
	Added in v.1.8

No CVS admin address has been configured