pegasus/ReleaseNotes.htm - diff

Return to ReleaseNotes.htm CVS log

Up to [Pegasus] / pegasus

Diff for /pegasus/ReleaseNotes.htm between version 1.6 and 1.18.2.1

version 1.6, 2005/09/26 15:41:17

version 1.18.2.1, 2011/09/05 14:23:46

Line 1

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

<head>

<style>

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

</style>

Line 448

Line 449

margin:1.0in 1.25in 1.0in 1.25in;

mso-header-margin:.5in;

mso-footer-margin:.5in;

mso-paper-source:0;}

div.Section1

{page:Section1;}

Line 569

Line 571

text-indent:-.25in;}

@list l4:level7

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l4:level8

Line 887

Line 890

text-indent:-.25in;}

@list l19

{mso-list-id:1902863286;

mso-list-template-ids:740079056;}

@list l19:level1

{mso-level-number-format:bullet;

Line 959

Line 963

font-size:10.0pt;

font-family:"Times New Roman"}

</style>

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" name="City"></o:smarttagtype>

<o:smarttagtype

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

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

<o:smarttagtype

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

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

<o:DocumentProperties>

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

<o:LastAuthor> </o:LastAuthor>

Line 992

</w:Compatibility>

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

</w:WordDocument>

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

</xml><![endif]--></head><body lang="EN-US" link="blue" vlink="blue">

</head>

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

style="color: black;">

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

Pegasus

width="100%"></div>

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

align="center">Pegasus

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

<span

style="color: black;">

PEP #: 230

PEP #: 359

Title: Release

Notes for OpenPegasus 2.5

Notes for OpenPegasus version 2.11.0 and version 2.11.1

Version: 1.8

Created: <st1:date

Created: 23

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

March 2011

Authors: Warren

Authors: Karl

Grunbok, Karl Schopmeyer

Schopmeyer

Status:  draft

Version History:

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

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

<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;">

<o:p> </o:p>

<span

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

</td>

<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

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

</td>

<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

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

</td>

<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

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>

<span

<o:p> </o:p>

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

2005

</o:p>

</td>

<span

<o:p> </o:p>

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

</o:p>

</td>

<span

<o:p> </o:p>

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

Submission<o:p>

</o:p>

</td>

</tr>

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

1.0<o:p></o:p>

</td>

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

</td>

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

</td>

</tr>

<tr>

23 March 2011

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

</td>

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

</td>

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

Karl Schopmeyer

</td>

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

security notes.

Initial

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

</td>

</tr>

<tr>

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

</td>

<td style="padding: 0.75pt;" align="center" height="21">30 August 2011 </td>

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

<td style="padding: 0.75pt;" align="center" height="21">Karl Schopmeyer </td>

</td>

<td style="padding: 0.75pt;" height="21">Updated to reflect Pegasus 2.11.1 release. Added covered properties to list of exceptions to DMTF specs.

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

</td>

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

</td>

</tr>

<tr>

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

</td>

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

</td>

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

</td>

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

review in Architecture meeting

</td>

</tr>

<tr>

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

</td>

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

</td>

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

</td>

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

version  (balloted version)

</td>

</tr>

<tr>

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

</td>

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

</td>

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

</td>

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

</td>

</tr>

<tr>

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

</td>

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

</td>

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

</td>

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

Provider security statement, and clarified Solaris support for 2.5

</td>

</tr>

<tr>

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

</td>

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

</td>

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

</td>

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

Paragraph and correction of Power on Linux in platform table

</td>

</tr>

</tbody>

</table>

<o:p> </o:p>

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

style="color: black;">

Abstract: This document defines the release notes for the

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

2.11.0 release of the OpenPegasus CIM Server with notes to reflect the 2.11.1 revision. The purpose of this PEP

width="100%"></div>

Abstract: This document defines the release notes for the 2.5

to summarize the characteristics of this release, point to other

version of the Pegasus CIM Server. <span

documentation that defines the release in more detail, and provide

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

additional information about this release that is not available in the

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

other Pegasus documentation.

target="_self">

</a>

NOTE: This PEP is maintained both as a PEP on the Pegasus website

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

and is also available directly in the OpenPegasus source tree root

style="color: black;">

library as ReleaseNotes.htm

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

width="100%"></div>

<o:p> Contents

</o:p>

<h2 style="margin-bottom: 1px;"><o:p> Contents</o:p></h2>

<ol>

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

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

this Release</a></li>

Release</a></li>

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

<li><a href="#Functionality_of_This_Release">OpenPegasus

This Release</a></li>

Functionality of This Release</a></li>

<li><a href="#Compatibility_Considerations_">Compatibility

Considerations</a></li>

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

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

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

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

Platforms</a></li>

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

with DMTF Specifications</a></li>

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

<li><a href="#PEGASUS%20Bugs">OpenPegasus Bug Fixes and Changes for this Release

in This Release</a></li>

</a></li>

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

<li> <a href="#Pegasus%20Release%20Control%20and%20Version%20Definition%20Documentation">OpenPegasus

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

<h2>Availability

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

of this Release</h2>

NOTE: This document defines

the OpenPegasus 2.11.0 version release with comments added to define

the 2.11.1 revision to that release.  OpenPegasus 2.11.1 is a bug

fix revision to Pegasus 2.11.0. The complete list of changes (total of

32 bugs fixed)  is defined in OpenPegasus bugzilla with the <a href="http://bugzilla.openpegasus.org/buglist.cgi?keywords=2.11.1_APPROVED">2.11.1_APPROVED bugs</a>

query.  We recommend that all uses of 2.11.0 review this list.

OpenPegasus tries to execute only bug fixes for revision releases and

not include enhancements but in exceptional cases including 2.11.1 some

extensions are included (See the Functionality of this Release

section). The OpenPegasus team recommends that users of Pegasus 2.11.0

update to Pegasus 2.11.1 because of of issues defined in a couple of

the bugs below, in particular an api incompatibility defined in bug

9014. Note that in OpenPegasus ALL changes including enhancements are

defined as bugs and committed only when the APPROVED keyword is set so

that the list in the query above defines ALL changes between 2.11.0 and

2.11.1.

This release is available in a number of forms including:

<ul>

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

<li>Source release in both ZIP (and ZIP EXE) and TAR formats.

These can be

downloaded from the OpenPegasus Web

site at <a

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

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

<li>OpenPegasus source RPMs on the OpenPegasus web site..

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

A source RPM is  available on the

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

OpenPegasus web site that can be used to build binaries for most

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

<li>The Pegasus CVS repository. 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

defined on the OpenPegasus CVS repository web page (see the <a href="http://cvs.opengroup.org/cgi-bin/viewcvs.cgi/">OpenPegasus

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

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

The instructions for acquiring the released code are on the <a href="http://www.openpegasus.org/page.tpl?CALLER=index.tpl&ggid=392">Pegasus

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.

tree.

</div>

Instructions for building the Linux RPMs: <span

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

<h2>OpenPegasus Functionality for This

</>

Release</h2>Pegasus overall status by release is defined by  a

<ol>

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

<li>Download

WEB Page</a>

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

that is available on the OpenPegasus web site .  That web page

<li>rpm

shows the

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

Pegasus users and developers the status of the various features found

<li>

in Pegasus

<span

using a simple color coded key (white, red, yellow, green) and a

class="norm">Build

description of

the rpms:

each feature.

</li>

Pegasus 2.11.0

</ol>

is a major release, extending the previous Pegasus release in selected

areas as described in the Pegasus  PEP defining this release

<table

.

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

The major areas of development for this release  were as

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

follows. Note that the bugs listed represent only those features

incorporated in bugs without PEPS that are considered enhancements, not

all bugs incorporated in the release. For

more information access the PEP/BUG for each change defined below:

Table of Major

Changes for this Release

<tbody>

<th bgcolor="#00ffff">Description of Change</th>

<th bgcolor="#00ffff" width="128">Posted PEP

Version</th>

</tr>

<tr>

<td

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

<td>Run 32 bit providers in 64 bit OpenPegasus</td>

<td

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

</tr>

<td align="left" width="75%">Provider Module Grouping</td>

</td>

</tr>

<tr>

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

<td align="left" width="75%">SNMP V3 Trap Generation in Pegasus

Indication Handler</td>

</tr>

<td style="text-align: center;" width="7%">PEP 324

</td>

<td align="left" width="75%">DMTF Indications Profile (DSP 1054)

Implementation, stage 2

</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 style="text-align: center;" width="7%">PEP 349

</td>

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

<td align="left" width="75%">Improve the

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

availability of the CIMOM by better isolation from faulty providers</td>

2.5.0-1.spec</td>

</tr>

<tr>

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

</td>

<td>Add External SLP support to release builds

</td>

</a>

</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>

</table>

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

the build the rpms will be in the

following locations:</li>

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

cellpadding="2" cellspacing="2">

<tbody>

<tr>

<td

<td style="text-align: center;"> <a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8800">Bug 8800

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

</a></td>

<td> <a name="comtag_90"></a>enable

PEGASUS_USE_RELEASE_CONFIG_OPTIONS build option to have true/false

values

</td>

<td

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

of RPMs after the build is complete

</td>

</tr>

<tr>

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

<td style="text-align: center;"><a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8806">Bug

</td>

8806</a></td>

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

<td>Diagnose data for BAD UTF8 exception</td>

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><a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8825">Bug

8825</a></td>

<td>Option to specify multiple provider dirs for release builds</td>

</tr>

<tr>

<td style="text-align: center;"><a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8839">Bug

8839</a></td>

<td>OOP Provider recovery enhancement</td>

</tr>

<tr>

<td><a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8845">Bug

8845</a></td>

<td><big><big>Enhance SSL Certificate info to

expose the whole certificate</big></big>

</td>

</tr>

<td style="text-align: center;" width="7%"> <a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8871">Bug 8871

</a> </td>

<td align="left" width="75%">Enhance WSMan Server Adpater

to include enumeration association filters</td>

</td>

</tr>

<td align="left" width="75%"> New runtime configuration options for Indication Service (2.11.1 Release)

</td>

</a></td>

</tr><tr>

</td>

<td style="vertical-align: top;">Correct issue with Provider

backward compatibility due to a new virtual function that was

introduced in Pegasus 2.11.0 (2.11.1 release)

</td>

</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>

</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>

The status of several components of Pegasus functionality change

</ol>

status

between Pegasus versions. <a name="comtag_116">Features

that

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

have changed status can be identified by a change in color from the

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

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

release to this release</a> on the

This document shows the Pegasus users and developers the maturity of

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

the various features found in Pegasus using a simple color coded

WEB Page</a>.

key.  That document can be found here:  <a

Finally, a significant number of internal changes and corrections

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

were made

Maturity Link</a>

under the control of the Pegasus bugzilla bug system. See the bug

section below

The overall level of functionality in the Pegasus environment

for more information.

effective with

<h3>Information on  IPv6 Support (PEP 291)</h3>

this release is as follows:

NOTE: This functionality was incorporated in OpenPegasus

<h3>CIM Server Functionality</h3>

2.7.0 but it

The following paragraphs list the functions in this release.

was felt that the information below was worth repeating in subsequent

All functions are considered community tested and operational unless

Release

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

Notes

not generally of the quality or completeness for production

IPv6 is

usage.  Interfaces that are part of the Pegasus public

short for "Internet

interface definitions but that the Pegasus team feels may change are

Protocol

marked experimental. In many cases these features  and interfaces

Version 6". IPv6 is the "next generation" protocol designed by the IETF

are conditionally compiled with special environment variables. <a

to replace the current version Internet Protocol, IP Version 4

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

("IPv4"). IPv6 Support for OpenPegasus is documented in <a href="http://www.openpegasus.org/pp/uploads/40/14222/PEP_291_IPv6.html">

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

PEP

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

291</a>.

provides more detailed information on how to enable

The IPv6 support in OpenPegasus is

functionality that is conditionally compiled in this release.

controlled by the PEGASUS_ENABLE_IPV6 build variable. The default for

this

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

variable is "true"; setting this to

<ol>

'false' before building OpenPegasus will disable the IPv6 support.

<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,

The following subsections provide

193, 205 combine to describe the function submitted.

some information on IPv6 support for the Linux and Windows platforms.

Note that in the 2.6.1 release there is no automatic run-time detection

of IPv6 support on a platform by OpenPegasus. If you build with

PEGASUS_ENABLE_IPV6=true, your platform must support IPv6 or you will

get a build failure (missing header files), a run-time bind() failure,

or possibly some other failure. This applies to both the CIM Server and

Listener components. For more information on IPv6 support for your

specific platform, refer to the documentation for that platform.

<h4>Schema Repository</h4>

All OpenPegasus externals that

By default, Pegasus uses an XML-based

support either a hostname or an IP address as input have been updated

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

to allow an IPv6 address to be specified. If the required input is just

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

an IP address (eg. no optional or required port number), then the IPv6

address must be specified without brackets. For example, the

To use the binary encoding feature a new configuration

OpenPegasus osinfo client (which returns information about the OS

properties was

running on a host system) takes separate host and port options. In this

added:

case a host with an IPv6-configured network interface would be

enableBinaryRepository (true|false) - Enables

specified as:

disables binary repository.

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

<div style="margin-left: 40px; color: rgb(153, 51, 153); font-family: monospace;"><big>osinfo -h

repository, the compressed repository

3ffe:1:2:1 -p 5988</big></div>

functionality has

But the cimcli command, which

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

takes

support

an optional "location" option including an optional port number,

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

requires the IPv6 address to be delimited with brackets, for example:

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

<div style="margin-left: 40px; font-family: monospace;"><big>cimcli ns

</h4>

-l [3ffe:1:2:1]</big></div>

OpenPegasus 2.5 (and

or

prior) contains several mechanisms to perform authorization, but none

<div style="margin-left: 40px;"><big>cimcli ns -l [3ffe:1:2:1]:5989</big>

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

For more information on

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

specifying

<h4>Server Security</h4>

IPv6 addresses, refer to <a href="http://www.ietf.org/rfc/rfc2373.txt">IETF

RFC 2373 - IP Version

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

6 Addressing Architecture</a>

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

and <a href="http://www.ietf.org/rfc/rfc2732.txt">IETF RFC 2732 -

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

Format for

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

Literal IPv6 Addresses in URL's</a>.

implemented in Pegasus using the OpenSSL

<h4>IPv6 on Linux</h4>

libraries. Pegasus does not provide the OpenSSL

Modern Linux distributions already

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

contain IPv6-ready kernels, the

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

IPv6 capability is generally compiled as a module, but it's possible

is  0.9.6c .   This release of Pegasus was tested with

that this module is not loaded automatically on startup.

0.9.6k.  See <a

Note:

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

you shouldn't use kernel series 2.2.x, because it's not

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

IPv6-up-to-date anymore. Also the IPv6 support in series 2.4.x is no

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

longer improved according to definitions in latest RFCs. It's recommend

SSLv3

to use series 2.6.x now.

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>

To check whether your current

Pegasus is designed to support multiple Provider Managers to allow

running

multiple provider interfaces to the CIMOM.  The two default

kernel supports IPv6, take a look into your /proc filesystem. The entry

provider managers are the Pegasus C++ Interface and Common

/proc/net/if_inet6 must exist. A short automated test looks like:

Manageability Programming Interface (CMPI) Interface.

<div style="margin-left: 40px; color: rgb(153, 51, 153); font-family: monospace;"><big>test -f

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

/proc/net/if_inet6 && echo "Running kernel is IPv6 ready"</big></div>

Pegasus 2.5 includes

For more information on

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

enabling

result of a project by the IBM SBLIM team (see 

IPv6 in the Linux kernel and configuring network interfaces, refer to

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

<a href="http://tldp.org/HOWTO/html_single/Linux+IPv6-HOWTO/">The Linux

Manageability Programming Interface, which is an OpenGroup standard.

Documentation Project's IPv6 HOWTO</a>.

The CMPI

specification is available at:

Warning:

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

There is currently an open issue with RedHat to address a problem that

standardized C level interface for creating providers that can be

is seen intermittently on RHEL5 and SLES10 systems. This problem is

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

described in

current C++ providers.  <span

<a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=6586">Pegasus

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

bug 6586</a>

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

and

Pegasus 2.5.

<a href="https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=248052">RedHat

bug 248052</a>,

Information on writing providers with the CMPI interface is available

and manifests itself as an intermittent IPv6 socket failure. You

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

should be aware

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

that OpenPegasus with IPv6 enabled may be significantly impacted in

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

these

Pegasus source root directory.

environments.

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

<h4>IPv6 on Windows</h4>

Pegasus includes an experimental provider manager for Java

Microsoft provides supported IPv6

provider interfaces based on the SNIA provider interface

implementations for Windows Server

definitions.  This provider manager is  considered alpha

2003, Windows XP with Service Pack 1 (SP1), Windows XP with Service

quality and is not compiled in the default build.   See

Pack 2 (SP2), and Windows CE .NET 4.1 and later.

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

On Windows XP, you can use the ipv6.exe

</blockquote>

tool to install, uninstall, and

</blockquote>

query

<h3>    Providers</h3>

your IPv6 configuration. For example:

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

to run out of process at

<div style="margin-left: 40px; color: rgb(153, 51, 153); font-family: monospace;"><big>ipv6 install

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

ipv6 if</big></div>

process space.

Windows Vista

and Windows Server 2008 support an integrated

Administrators should check the providers to

IPv4 and IPv6 implementation known as the Next Generation TCP/IP stack.

ensure that the provider vendor

Note that the OpenPegasus IPv6 support has not yet been tested

has made use of available authorization capability.

on Windows Vista or Windows Server 2008.

</div>

There are a number of providers available

For more information on

in the Pegasus release.

installing, configuring, and using IPv6 on Windows platforms, refer to

This includes providers in the following categories:

the document

<a href="https://www.microsoft.com/technet/network/ipv6/ipv6faq.mspx">IPv6

<h4>Pegasus Internal Providers</h4>

for Microsoft Windows: Frequently Asked Questions</a>.

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>

<h4>Testing your OpenPegasus IPv6

System Log Indication Handler

support</h4>

<div style="margin-left: 40px;">The SysLog Indication Handler is a new

As part of the OpenPegasus

for 2.5

automated tests, the TestClient, g11ntest, and IndicationStressTest

type of Indication Handler which allows CIM Indications to be delivered

test clients were modified to run tests using the IPv6 loopback address

to the system syslog file. It has following features:

(::1) if PEGASUS_ENABLE_IPV6=true.

</div>

<ul>

You can also perform manual

<li>Each syslog file entry has a tag 'CIM Indication' to distinguish

tests

an entry made by Syslog Indication Handler.</li>

using the IPv6 loopback or a real IPv6-configured network interface.

</ul>

For example, using the IPv6 loopback on a system with OpenPegasus

<ul>

running on the WBEM standard http port of 5988:

<li>If a subscriber includes PerceivedSeverity property in the SELECT

list of the filter condition for the indication, the PerceivedSeverity

<big style="font-family: monospace;"> osinfo -h ::1</big></div>

will be mapped to syslog error severity. Otherwise, syslog error

<h2><a name="Compatibility_Considerations_">Compatibility Considerations</a></h2>

severity 'LOG_INFO' is used.</li>

Support for forward-compatibility is a fundamental design principle

<li>See <a

for the

href="http://www.openpegasus.org/pp/uploads/40/7165/PEP206-SystemLogIndicationHandler.htm">PEP

OpenPegasus project. As a Community, our goal is for well-behaved

206</a> for details.

OpenPegasus

</li>

Providers or Clients, using only the externally defined OpenPegasus

</ul>

interface,

to continue to work with a minor version upgrade of OpenPegasus.

Email Indicaiton Handler

However, there

<div style="margin-left: 40px;">The Email Indication Handler is a new

are certain classes of errors (e.g., non-compliance with a standard

for 2.5

that

type of Indication Handler that allows CIM Indications to be delivered

significantly affects interoperability) that may require the Community

to a specified e-mail address.   See <a

to make

href="http://www.openpegasus.org/pp/uploads/40/7166/PEP207-EmailIndicationHandler.htm">PEP

potentially incompatible changes. The following table contains a list

207</a>  for details.

of defect

</div>

fixes that MAY impact, even well-behaved, OpenPegasus Providers or

Clients when

upgrading to this OpenPegasus release.

<ol>

</ol>

<h2><a name="Relationship_to_CIMWBEM_Standards"></a>Relationship to

<tbody>

<th bgcolor="#00ffff" width="10%">Bugzilla #</th>

<th bgcolor="#00ffff">Description</th>

</tr>

<td align="left">The requirement for providers (CMPI and C++) to

filter properties from instances has been relieved. The server will do

the filtering at the protocol adapter level. To avoid a negative impact

on performance the CIMInstance::filter() and

CMPIInstanceFT.setPropertyFilter() functions have been changed to a

NOP. This may be a change in behavior for provider relying in some

unknown way on the instance being filtered through these functions. To

allow users to actually filter properties from an instance, new

function CIMInstance::filterInstance() will actually filter properties

from an instance exactly as the CIMInstance::filter() did in previous

versions of Pegasus.</td>

</tr>

<td>

</td>

<td>

</td>

</tr>

<td>

</td>

<td>

</td>

</tr>

<td>

</td>

<td>

</td>

</tr>

<td>

</td>

<td>

</td>

</tr>

</tbody>

</table>

<h2>OpenPegasus 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

CIM/WBEM specifications The following table defines the level of the

specifications which which Pegasus conforms today.

DMTF specifications to which this version of Pegasus aims to conform

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%">DSP 0004 - CIM Infrastructure Specification</td>

<td width="33%">Version 2.2 with Addendum</td>

<td width="33%">Version 2.3 Final, 4 October 2005</td>

</tr>

<tr>

<td width="33%">DSP 0200 - CIM Operations over HTTP</td>

<td width="33%">1.1, final, 6  January 2002</td>

<td width="33%">Version 1.2, Final, January 09, 2007</td>

</tr>

<tr>

<td width="33%">DSP 0201 - Representation of CIM in XML</td>

<td width="33%">2.1, preliminary, May 2, 2002</td>

<td width="33%">Version 2.2 Final, January 09, 2007</td>

</tr>

<tr>

<td width="33%">DSP 0202 - CIM Query Language Specification</td>

<td width="33%">1.0.0, preliminary, 9 December 2004</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>

<td width="33%">DSP 0206 - WBEM SLP Template</td>

<td width="33%">1.0.0, Preliminary, January 2004</td>

</tr>

<tr>

<td width="33%">CIM Schema </td>

<td width="33%">2.9 Final, Jan. 2005</td>

<td width="33%">2.22.1 Final,  22 Oct 2009( default) </td>

</tr>

</tbody>

</table>

<h2><a name="Supported Platforms">Supported

<h2><a name="Conformance with DMTF Specifications">Conformance

Exceptions to

DMTF Specifications</a></h2>

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 this release, some of the differences include the following:

<ol>

<li>Provider Registration - Pegasus supports registration

through a set of Pegasus Provider registration classes rather than

support the DMTF defined Provider Qualifier. Pegasus will not support

this qualifier in the future. See the readme for more information on

provider registration.  This is not a deviation from the

specifications but is a different method of registration than many CIM

Servers and means that the the provider qualifier is unused in Pegasus.</li>

<li>Indications -Today Pegasus supports process

indications and lifecycle indications when defined specifically by

providers. Pegasus does not support lifecycle indications if they are

not defined by the provider or for changes to CIM Classes.  For

more information see the Pegasus CVS file:<a name="comtag_137">  pegasus/src/Unsupported/LifecycleIndicationProvider/README.LifecycleIndications.htm</a>.</li>

<li>

IncludeQualifiers

option on Instance Operations

The DMTF specifications have deprecated the use of qualifiers on

instance operations with the 1.2 CIM Operations Specification and

stated specifically that the client should NOT depend on the

includeQualifiers parameter of the CIM/XML instance operations

returning qualifiers. 

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.  When Pegasus uses object normalization,

the normalizer does apply qualifiers to returned instances if the

includeQualifiers operation parameter is set.

</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 Enumerate Instances 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. See Appendix C of this

specification for more information.</li>

<li>

MultiRequest Operations - Pegasus

does not support the DMTF defined MultiRequest Operation option.

</li>

<li>

MOF Compiler namespace pragma - The

Pegasus compiler does not support the namespace pragma.

</li>

<li>CIMOperation Trailer - Pegasus implements

chunking

based on the DSP0200 1.2.0 preliminary spec. including the operation

trailer defined in that specification Refer to bug <a href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=6760">6760</a>

for more details. This trailer was completely removed from the DSP0200

1.2 final specification as a non-compatible change so that if chunking

is used Pegasus is returning a noncompliant response to enumerate type

requests. </li>

<li>Whitespace in XML value Element

- Pegasus trims the leading and trailing whitespace from XML value

elements that are of the Type String.  This behavior is documented

in Pegasus bug <a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8773">8773</a>

and there is a patch available for users.  However, since the

change is considered a change to behavior this will not be patched

until pegasus does a major version update. NOTE: There are some

documented bugs in Pegasus such as this that the OpenPegasus team feels

cannot be modified until a major version update.  These bugs are

documented with the Bugzilla tag <big style="font-weight: bold;"><samp>"3.0_TARGET".</samp></big></li>

<li>modifyInstance operation

behavior in the Pegasus repository does not match the DMTF specification.

Under some conditions (ex. if no propertyList is supplied) it modifies

all properties rather than just the properties supplied with the

request thereby Nulling out existing values. See bug <a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8752">8752</a>

for more information.</li>

<li>Covered Properties (multiple properties with the same name but different class origin)

- The DMTF Spec DSP0004 now defines the requirement for covered

properties. However, OpenPegasus does not support this capability (see <a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=3571">bug 3571</a>)

</li>

</ol>

<h2>OpenPegasus <a name="Supported Platforms">Supported

Platforms</a></h2>

Each Pegasus release lists as 'active' platforms those

Each OpenPegasus release lists as 'active' platforms

those

hardware/software platforms that have recognized ports for the Pegasus

code

code base

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

including a maintainer for the platform that will be willing to

regularly document issues and/or fix defects as the Pegasus

regularly

code base is changed. 

document issues and/or fix defects 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, correct operation of 

Pegasus cannot be

Pegasus

assured.  In all cases, including the active platforms, it is the

cannot be assured.  In all cases, including the active platforms,

it is the

responsibility of the entity that packages and/or compiles OpenPegasus

for shipment or deployment, to read, and actively monitor the Pegasus

for

bugzilla database for a list of relevant defects that affect their

shipment or deployment, to read, and actively monitor the Pegasus

platform.   The platforms that are considered 'active' for this

bugzilla

Pegasus release are:

database for a list of relevant defects that affect their

platform.  

The platforms that are considered ported are shown in the two tables

<table class="MsoNormalTable" style="width: 302.25pt;" border="1"

below. 

cellpadding="0" cellspacing="1" height="409" width="504">

The first table represents platform sofr which testing is done on a

regular

basis and reported to the Pegasus Nightly Build Test WEB Page. Those

platforms

which have been ported but do not have test results that are current at

the time

of the release are reported in the second table.

Actively Supported Platforms (Nightly Tests Reported for this

release)

<tbody>

<td

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;"

height="26" width="211">

Platform and

OS<o:p></o:p>

</td>

<td

Compilers<o:p></o:p>

height="26" width="289">

Compilers<span

style="color: black;"><o:p></o:p>

</td>

</tr>

<td style="padding: 0.75pt; width: 126.75pt;" height="25"

width="211">

HP-UX<o:p>

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

PA_RISC and Itanium</o:p>

</td>

<td style="padding: 0.75pt; width: 173.25pt;" height="25"

width="289">

HP aC++ B3910B<o:p></o:p>

HP <span

class="SpellE">aC++ B3910B<o:p></o:p>

</td>

</tr>

<td style="padding: 0.75pt; width: 126.75pt;" height="25"

width="211">

Linux on Power<o:p></o:p>

<span

</td>

style="color: black;">Linux on Power<span

style="color: black;"><o:p></o:p>

gcc<o:p></o:p>

</td>

<td style="padding: 0.75pt; width: 173.25pt;" height="25"

width="289">

<span

style="color: black;">gcc<o:p></o:p>

</td>

</tr>

<td style="padding: 0.75pt; width: 126.75pt;" height="25"

width="211">

zLinux<o:p></o:p>

<span

</td>

style="color: black;">zLinux<o:p></o:p>

</td>

gcc<o:p></o:p>

<td style="padding: 0.75pt; width: 173.25pt;" height="25"

width="289">

<span

style="color: black;">gcc<o:p></o:p>

</td>

</tr>

<td style="padding: 0.75pt; width: 126.75pt;" height="25"

width="211">

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

</td>

<td style="padding: 0.75pt; width: 173.25pt;" height="25"

width="289">

gcc<o:p></o:p>

<span

style="color: black;">gcc<o:p></o:p>

</td>

</tr>

<td style="padding: 0.75pt; width: 126.75pt;" height="25"

<td style="padding: 0.75pt;"> Linux IA-32</td>

width="211">

<td style="padding: 0.75pt;"> gcc

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

(versions 3.xx, 4.xx)<o:p></o:p></td>

</td>

</tr>

<td style="padding: 0.75pt; width: 173.25pt;" height="25"

width="289">

<span

Linux X86_64<o:p></o:p>

style="color: black;">gcc

</td>

(versions 2.9x and 3.xx)<o:p></o:p>

gcc

(versions 3.xx, 4.xx)

</td>

</tr>

<tr>

<td style="vertical-align: top;">XL C/C++ from

z/OS Version 1.7 and up</td>

</tr>

</tbody>

</table>

Platforms not Actively supported for this release

(No

current Nightly Build Test Results

<tbody>

<td style="padding: 0.75pt; width: 126.75pt;" height="91"

width="211">

Platform and

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

OS<o:p></o:p>

</td>

<td style="padding: 0.75pt; width: 173.25pt;" height="91"

width="289">

Compilers<o:p></o:p>

Microsoft

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="padding: 0.75pt; width: 126.75pt;" height="69"

<td style="padding: 0.75pt;"> Windows XP

width="211">

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

</td>

<td style="padding: 0.75pt; width: 173.25pt;" height="69"

width="289">

Microsoft

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

style="color: black;" lang="NL"><o:p></o:p>

</td>

<td style="padding: 0.75pt;"> Microsoft Visual

C++ Ver. 6 and Microsoft .Net compiler Version 7.1. Note: Visual C++

Ver. 6 no longer being regular tested. </td>

</tr>

<td style="padding: 0.75pt; width: 126.75pt;" height="43"

<td style="padding: 0.75pt;"> MacOS version 10.3

width="211"> MacOS version 10.2 and higher</td>

and higher</td>

<td style="padding: 0.75pt; width: 173.25pt;" height="43"

width="289"> gcc 3.3</td>

</tr>

<tr>

<td style="vertical-align: top;"><big>HP OpenVMS Alpha

<td style="vertical-align: top;"><big>Solaris 8</big></td>

</big></td>

<td style="vertical-align: top;"><big>GNU  2.95.3,  Sun

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

CC compiler V 5.8. Note that the latest thread patch (108993) may be

style="color: rgb(0, 0, 0);" color="RED">HP C++ V6.5-042 for OpenVMS

required. (see Pegasus bug 4632)</big>

Alpha and above</big> </td>

</td>

</tr>

<tr>

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

<td style="vertical-align: top;"><big>Solaris 9</big></td>

style="color: rgb(0, 0, 0);"> HP OpenVMS IA64</big></td>

<td style="vertical-align: top;"><big>GNU  2.95.3, Sun

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

WorkShop 6 update 2 C++ 5.3, patch 111685-22 2005/04/09</big>

style="color: rgb(0, 0, 0);">HP C++ V7.1-011 on OpenVMS IA64 and above</big>

</td>

</tr>

<tr>

<td><big>HP OpenVMS 8.3 or later Alpha</big></td>

<td><big>HP C++ V7.3-009 or later required for

OpenVMS

Alpha</big></td>

</tr>

<tr>

<td><big> HP OpenVMS 8.3 or

later IA64</big></td>

<td><big>HP C++ V7.3-023 or later required on OpenVMS IA64</big></td>

</tr>

<tr>

Windows 2000

</td>

<td style="padding: 0.75pt;"> Microsoft Visual

C++ Ver.  6 and Microsoft .Net compiler version. Works on VC

.NET 2003 v7.1). NOTE: Visual C++ Ver. 6 no longer being regularly

tested.</td>

</tr>

<tr>

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

<td style="padding: 0.75pt;"> Windows 2003

color="RED">Solaris 8

* See below for additional info

</big></td>

</td>

<td style="padding: 0.75pt;"> Microsoft Visual

C++ Ver. 6 and Microsoft .Net compiler Version 7.1. Note: Visual C++

Ver. 6 no longer being regular tested. </td>

</tr>

<tr>

<td><big>OpenSolaris 11 (Nevada) Community Edition (Sparc and

IX86)</big></td>

<td><big>CC Compiler Sun Studio 5.11</big></td>

</tr>

</tbody>

</table>

Platform patches

Solaris:  Solaris testing

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

platform, changes documented in OpenPegasus Bugzilla 4179  must be

applied.

<h2>Platform patches</h2>

The following is a list of platform

patches Pegasus requires.

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

2.1 needs the update to fix Red Hat Bugzilla 98815.

</div>

Further information regarding Pegasus support on IBM platforms can

found at: <a

href="http://publib.boulder.ibm.com/infocenter/eserver/v1r1/en_US/index.htm?info/icmain.htm"><span

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>

The following is a list known of platform

Further information regarding Pegasus support on HP platforms can be

patches Pegasus requires.

found at:

<a href="http://www.hp.com/go/wbem">http://www.hp.com/go/wbem</a>.

<o:p>

</o:p>

<h2><a name="Conformance with DMTF Specifications">Conformance with

DMTF Specifications</a></h2>

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 this release, some of the differences include the following:

<ol>

<li>Provider Registration - Pegasus supports registration

through a set of Pegasus Provider registration classes rather than

support the DMTF defined Provider Qualifier. Pegasus will not support

this qualifier in the future. See the readme for more information on

provider registration.</li>

<li> Indications -Today Pegasus supports process

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