pegasus/ReleaseNotes.htm - diff

Return to ReleaseNotes.htm CVS log

Up to [Pegasus] / pegasus

Diff for /pegasus/ReleaseNotes.htm between version 1.12 and 1.18

version 1.12, 2007/10/16 17:27:28

version 1.18, 2011/03/29 13:23:06

Line 1006

<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 #: 359

PEP #: 306

Title: Release

Notes for OpenPegasus 2.7.0

Notes for OpenPegasus version 2.11.0

Created: 23

March 2011

Created: 3 October 2007

Authors: Karl

Schopmeyer

Authors: Karl Schopmeyer

Status:  draft

Version History:

<table class="MsoNormalTable" style="width: 100%;" id="table1"

border="1" cellpadding="0" cellspacing="1" height="155" 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;"

height="27">

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

height="27">

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

height="27">

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

height="27">

<o:p> </o:p>

<span

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

</td>

</tr>

<span

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

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

</td>

<font

<o:p> </o:p>3

size="2">23 March 2011

October 2007

</td>

<span

style="font-family: Arial;">Karl Schopmeyer

Karl Schopmeyer

</td>

<span

Initial

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

Submission<o:p>

Submission <o:p><font

</o:p>

size="2"> </o:p>

</td>

</tr>

<tr>

</tr>

<tr>

</tr>

<td style="padding: 0.75pt;" align="center" height="21">8 October 2007</td>

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

<td style="padding: 0.75pt;" height="21">Incorporate data from 2.6.1

</tr>

release notes. Fix per comments in 1.0</td>

<tr>

</tr>

</tr>

<td style="padding: 0.75pt;" align="center" height="21">11 October 2007</td>

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

<td style="padding: 0.75pt;" height="21">Comments from V 1.1 and add

existing document links. Add pep 302 to enhancements</td>

</tr>

<tr>

<td style="padding: 0.75pt;" align="center" height="21">15 October 2007</td>

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

<td style="padding: 0.75pt;" height="21">Add final links</td>

</tr>

</tr>

</tbody>

</table>

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

<span

style="color: black;">

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

width="100%"></div>

Abstract: This document defines the release notes for the

2.7.0 release of the OpenPegasus CIM Server. The purpose of this PEP is

2.11.0 release of the OpenPegasus CIM Server. The purpose of this PEP

to summarize the characteristics of this release, point to other

documentation that defines the release in more detail, and provide

additional information about this release that is not available in the

other Pegasus documentation.

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

<span

style="color: black;">

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

width="100%"></div>

Line 1169

Line 1116

Release</a></li>

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

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

<li><a href="#Compatibility_Considerations_">Compatibility Considerations</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">OpenPegasus Supported Platforms</a></li>

Line 1191

Line 1139

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 source RPMs on the OpenPegasus web site.. A source RPM is  available on the

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

OpenPegasus web site that can be used to build binaries for most LSB-compliant RPM-based Linux distributions and versions.</li>

A source RPM is  available on the

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

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

<li>The Pegasus CVS repository. The CVS tags representing this

release and

subsequent snapshots that are made available in the Pegasus CVS are

Line 1210

Line 1160

tree.

</div>

<h2>OpenPegasus Functionality for This Release</h2>

<h2>OpenPegasus Functionality for This

Release</h2>

Pegasus overall status by release is defined by  a

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

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

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

WEB Page</a>

Pegasus users and developers the status of the various features found in Pegasus

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

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

shows the

each feature.Pegasus 2.7.0

Pegasus users and developers the status of the various features found

is a major release, extending Pegasus 2.6 in selected

in Pegasus

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

description of

each feature.

Pegasus 2.11.0

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

areas as described in the Pegasus  PEP defining this release

.

The major areas of development for this release  were as

The major areas of development for this release  were as follows. For

follows. Note that the bugs listed represent only those features

more information access the PEP for each change defined:

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

<font

style="font-weight: bold;" size="4">    Table of Major

Changes for this Release

<TABLE style="FONT-FAMILY: Arial" cellSpacing=1 borderColorDark=#666666

<table style="font-family: Arial;" bordercolordark="#666666"

borderColorLight=#CCCCCC border=1 width="82%">

bordercolorlight="#CCCCCC" border="1" cellspacing="1" width="82%">

<TBODY>

<tbody>

<TH bgColor=#00FFFF>Description of Change</TH>

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

<TH bgColor=#00FFFF width="128">Posted PEP Version</TH>

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

</TR>

Version</th>

</tr>

<tr>

<TD align="left" width="75%">Add Platform support IBM i5/PASE - Portable Application

Solutions Environment (PASE)</TD>

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

<td style="text-align: center;"><a

href="http://www.openpegasus.org/pp/uploads/40/23224/PEP_318_32bit_providers_in_64bit_OpenPegasusVer10.htm">1.0</a></td>

1.6</a></TD>

</tr>

</TR>

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

<TD align="left" width="75%">Reduce the Amount of CIM Server code that runs Privileged

<td width="128"> <a

(Privilege Separation)</TD>

href="http://www.openpegasus.org/pp/uploads/40/22030/PEP356_ProviderModuleGrouping.htm">2.2</a>

</td>

</tr>

1.8</a></TD>

<tr>

</TR>

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

Indication Handler</td>

<TD align="left" width="75%">Add Support for IPv6 - Stage 1 (Note: This functionality

<td style="text-align: center;" width="128"><a

was made available but normally disabled

href="http://www.openpegasus.org/pp/uploads/40/23237/PEP_357_-_SNMP_v3_trap_generation_in_Pegasus_.htm">1.0</a></td>

Pegasus 2.6.1)</TD>

</tr>

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

1.2</a></TD>

</td>

</TR>

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

Implementation, stage 2

</td>

<TD align="left" width="75%">Add IPV6 Support for SNMP Indication Handler

<td width="128"><a

and include NET-SNMP indication handler in Linux RPM </TD>

href="http://www.openpegasus.org/pp/uploads/40/22529/PEP324-DMTF_Indications_Profile_stage2_Ver11.html">1.1</a></td>

</tr>

1.1</a></TD>

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

</TR>

</td>

<td align="left" width="75%"><span

style="">Improve the

<TD align="left" width="75%">Enable Remote CMPI for Windows</TD>

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

<td width="128"> <a

href="http://www.openpegasus.org/pp/uploads/40/22386/PEP_349_-_Improve_the_availability_of_the_CIMOM_by_better_isolation_from_faulty_providers.htm">0.5</a></td>

1.2</a></TD>

</tr>

</TR>

<tr>

<td style="text-align: center;"><a

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

<TD align="left" width="75%">Enhanced Log File Support</TD>

</td>

<td>Add External SLP support to release builds

</td>

1.0</a></TD>

<td style="text-align: center;"> <a

</TR>

href="http://www.openpegasus.org/pp/uploads/40/21277/PEP350_MultiCIMOM.htm">

</a></td>

</tr>

<TD align="left" width="75%">Add support for certificate-based authentication audit

<tr>

logging</TD>

<td style="text-align: center;"> <a

href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8800">Bug 8800

</a></td>

1.5</a></TD>

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

</TR>

PEGASUS_USE_RELEASE_CONFIG_OPTIONS build option to have true/false

values

<TD width="7%">Bugzilla 6466</TD>

</td>

<TD align="left" width="75%">Add two new trace components to facilitate

triage of indication delivery issues</TD>

</td>

</tr>

<tr>

Bug 6466</a></TD>

<td style="text-align: center;"><a

</TR>

href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8806">Bug

</TBODY>

8806</a></td>

</TABLE>

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

</html>

The status of several components of Pegasus functionality change status

</tr>

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

<tr>

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

<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%"><span

style="text-decoration: underline;">Enhance WSMan Server Adpater 

to include enumeration association filters</td>

</td>

</tr>

<td width="128"><a

href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8171">

</a></td>

</tr>

</tbody>

</table>

The status of several components of Pegasus functionality change

status

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

that

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

release to this release</a> on the

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

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

WEB Page</a>.

Finally, a significant number of internal changes and corrections were made

Finally, a significant number of internal changes and corrections

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

were made

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

section below

for more information.

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

IPv6 is short for "Internet

NOTE: This functionality was incorporated in OpenPegasus

2.7.0 but it

was felt that the information below was worth repeating in subsequent

Release

Notes

IPv6 is

short for "Internet

Protocol

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

to replace the current version Internet Protocol, IP Version 4

("IPv4"). IPv6 Support for OpenPegasus is documented in <a

href="http://www.openpegasus.org/pp/uploads/40/14222/PEP_291_IPv6.html">

PEP

PEP

291</a>.

The IPv6 support in OpenPegasus is

controlled by the PEGASUS_ENABLE_IPV6 build variable. The default for this

controlled by the PEGASUS_ENABLE_IPV6 build variable. The default for

variable is "true"; setting this to

this

variable is "true"; setting this to

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

The following subsections provide

Line 1347

Line 1354

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

specified as:

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

<div

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

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

color="#000000">osinfo -h

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

But the cimcli command, which

takes

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

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

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

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

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

or

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

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

style="font-family: monospace;">cimcli ns -l [3ffe:1:2:1]:5989</big>

</div>

For more information on

specifying

IPv6 addresses, refer to <a

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

href="http://www.ietf.org/rfc/rfc2373.txt">IETF RFC 2373 - IP Version

RFC 2373 - IP Version

6 Addressing Architecture</a>

and <a

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

href="http://www.ietf.org/rfc/rfc2732.txt">IETF RFC 2732 - Format for

Format for

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

<h4>IPv6 on Linux</h4>

Modern Linux distributions already

contain IPv6-ready kernels, the

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

that this module is not loaded automatically on startup.

Note:

Note:

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

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

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

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

to use series 2.6.x now.

Line 1383

Line 1394

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

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

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

<div

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

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

color="#000000">test -f

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

For more information on

enabling

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

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

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

Documentation Project's IPv6 HOWTO</a>.

Warning:

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

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

described in <span

described in

style="color: rgb(153, 51, 153);">

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

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

bug 6586</a>

and

and<span

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

style="color: rgb(153, 51, 153);">

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

bug 248052</a>,

and manifests itself as an intermittent IPv6 socket failure. You

and manifests itself as an intermittent IPv6 socket failure. You should be aware

should be aware

that OpenPegasus with IPv6 enabled may be significantly impacted in these

that OpenPegasus with IPv6 enabled may be significantly impacted in

these

environments.

<h4>IPv6 on Windows</h4>

Microsoft provides supported IPv6

implementations for Windows Server

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

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

On Windows XP, you can use the <span

On Windows XP, you can use the ipv6.exe

style="font-weight: bold; ">ipv6.exe tool to install, uninstall, and

tool to install, uninstall, and

query

your IPv6 configuration. For example:

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

<div

ipv6 if</div>

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

color="#000000">ipv6 install

ipv6 if</big></div>

Windows Vista

and Windows Server 2008 support an integrated

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

Line 1431

Line 1441

For more information on

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

the document

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

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

color="#000000">IPv6

IPv6

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

<h4>Testing your OpenPegasus IPv6

Line 1449

Line 1458

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

running on the WBEM standard http port of 5988:

osinfo -h ::1</div>

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

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

Support for forward-compatibility is a fundamental design principle for the

Support for forward-compatibility is a fundamental design principle

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

for the

Providers or Clients, using only the externally defined OpenPegasus interface,

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

to continue to work with a minor version upgrade of OpenPegasus. However, there

OpenPegasus

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

Providers or Clients, using only the externally defined OpenPegasus

significantly affects interoperability) that may require the Community to make

interface,

potentially incompatible changes. The following table contains a list of defect

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

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

However, there

upgrading to OpenPegasus 2.7.0.

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

<TABLE style="FONT-FAMILY: Arial" cellSpacing=1 borderColorDark=#666666

that

borderColorLight=#CCCCCC border=1 width="80%">

significantly affects interoperability) that may require the Community

<TBODY>

to make

potentially incompatible changes. The following table contains a list

<TH bgColor=#00FFFF width=10%>Bugzilla #</TH>

of defect

<TH bgColor=#00FFFF>Description</TH>

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

</TR>

Clients when

upgrading to this OpenPegasus release.

<TD align="left">HP-UX only: Introduction of the "explicit" keyword in CIMClass.h and CIMInstance.h may introduce

<table style="font-family: Arial;" bordercolordark="#666666"

a compile error in some code. Specifically, a compiler-supplied automatic conversion from CIMObject

bordercolorlight="#CCCCCC" border="1" cellspacing="1" width="80%">

type to CIMClass or CIMInstance has been removed. The cast operation must be explicitly specified.

<tbody>

</TD>

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

</TR>

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

</tr>

<TD>

WIPCR00430 recommends an unquoted charset parameter in Content-type header. See the writeup in this bug for a discussion of the validation of the charset parameter in various OpenPegasus releases. In 2.7 we perform "extended" validation that should ignore differences based on whitespace or quotes. The CR recommendation is to not use quotes on the charset parameter, but only at a time when it is expected that all CIMOMs have been updated to accept the charset parameter with or without quotes.</TD>

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

</TR>

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

<TD>

CMPIInstanceFT.setPropertyFilter() functions have been changed to a

The MOF Compiler now rejects some property values that are invalid according to the DMTF specification that it previously accepted.</TD>

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

</TR>

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

</TBODY>

allow users to actually filter properties from an instance, new

</TABLE>

function CIMInstance::filterInstance() will actually filter properties

</html>

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

versions of Pegasus.</td>

</tr>

</tr>

</tr>

</tr>

</tr>

</tbody>

</table>

<h2>OpenPegasus Relationship to

CIM/WBEM Standards</h2>

Pegasus was designed and implemented to comply with the DMTF

Line 1508

Line 1535

</tr>

<tr>

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

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

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

</tr>

<tr>

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

Line 1528

Line 1555

</tr>

<tr>

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

<td width="33%">2.13.1 Final, Jan. 2005 ( default) </td>

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

</tr>

</tbody>

</table>

Line 1553

Line 1580

providers. Pegasus does not support lifecycle indications if they are

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

color="#ff0000">  For

more information see the Pegasus CVS file:<a name="comtag_137">

more information see the Pegasus CVS file:<a name="comtag_137"><font

<font

size="2">  pegasus/src/Unsupported/LifecycleIndicationProvider/README.LifecycleIndications.htm</a><font

face="Courier New" size="2"> pegasus/src/Unsupported/LifecycleIndicationProvider/README.LifecycleIndications.htm</a>.</li>

size="2">.</li>

<li>

<font

style="color: rgb(0, 0, 0); font-weight: bold;">IncludeQualifiers

option on Instance Operations

The DMTF specifications have deprecated the use of qualifiers on

instance operations with the 1.2 CIM Operations Specification. 

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

Line 1575

Line 1605

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.

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

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

Line 1595

Line 1628

MOF Compiler namespace pragma - The

Pegasus compiler does not support the namespace pragma.

</li>

<li>Pegasus implements

<li>CIMOperation Trailer - Pegasus implements

chunking

based on the DSP0200 1.2.0 preliminary spec. including the operation trailer

based on the DSP0200 1.2.0 preliminary spec. including the operation

defined in that specification Refer to bug

trailer defined in that specification Refer to bug <a

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

href="http://cvs.opengroup.org/bugzilla/show_bug.cgi?id=6760">6760</a> for more details.

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

</li>

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>

</ol>

<h2>OpenPegasus <a

name="Supported Platforms">Supported

Platforms</a></h2>

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

below. 

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)

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

cellpadding="0" cellspacing="1">

<tbody>

<td

style="padding: 0.75pt; background: #00FFFF 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial; width: 240px;"

style="padding: 0.75pt; background: rgb(0, 255, 255) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial; width: 240px;"

height="26">

Platform and

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

</td>

<td

style="padding: 0.75pt; background: #00FFFF 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial; width: 75%;"

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

height="26">

Compilers<span

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

Line 1642

Line 1709

</tr>

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

HP-UX<o:p>

PA_RISC and Itanium</o:p>

</td>

HP <span

Line 1680

Line 1748

</td>

</tr>

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

Linux IA-32</td>

size="3">Linux IA-32</td>

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

<span

style="color: black;">gcc<span

style="color: black;">gcc

style="color: black;">

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

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

</tr>

Line 1694

Line 1762

<span

style="color: black;">gcc

(versions 2.9x, 3.xx, 4.xx)

(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

<table class="MsoNormalTable" style="width: 90%;" id="table2" border="1"

cellpadding="0" cellspacing="1">

<tbody>

<td

Windows 2000

style="padding: 0.75pt; background: rgb(0, 255, 255) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial; width: 240px;"

height="26">

Platform and

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

</td>

<td

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

height="26">

Compilers<span

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

</td>

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="padding: 0.75pt; "> Windows XP, Windows 2003

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

</td>

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

Note: Visual C++ Ver. 6 no longer being regular tested.

</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; "> MacOS version 10.3 and higher</td>

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

and higher</td>

</tr>

<tr>

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

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

style="color: rgb(0, 0, 0);" color="RED">HP C++ V<span

style="color: rgb(153, 51, 153);">7.3-009 or later required for OpenVMS

Alpha</big></td>

</tr>

<tr>

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

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

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

style="color: rgb(0, 0, 0);">HP C++ V7.3-023 or

later required<font

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

</tr>

<tr>

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

style="color: rgb(0, 0, 0);">Solaris 8</big></td>

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

Line 1748

Line 1821

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

</td>

</tr>

<tr>

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

<td><big>HP C++ V<span

style="color: rgb(153, 51, 153);">7.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.<font

color="#993399">3-023 or later required<font

style="color: rgb(0, 0, 0);"> 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="padding: 0.75pt;"> Windows 2003

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

Platform patches

<font

style="color: rgb(0, 0, 0);">The following is a list known of platform

patches Pegasus requires.

<ol>

<li>

<font

<font

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

2.1 needs the update to fix Red Hat Bugzilla 98815.</li>

2.1 needs the update to fix Red Hat Bugzilla 98815.

</li>

<li>

RHEL 4.4 multithreading bug in

RHEL 4.4

getpwuid-r could cause a CIM Server failure (Bugzilla 6232). This is fixed in

multithreading bug in

RHEL 4.5</li>

getpwuid-r could cause a CIM Server failure (Bugzilla 6232). This is

fixed in

RHEL 4.5

</li>

<li>

Red Hat and SUSE Linux

Red Hat and SUSE

multiple versions -

Linux multiple versions -

multithreaded client intermittently fails connecting to IPv6 (Pegasus Bugzilla

multithreaded client intermittently fails connecting to IPv6 (Pegasus

6586) (Red Hat bug 248052) </li>

Bugzilla

6586) (Red Hat bug 248052)

</li>

</ol>

</div>

Further information regarding Pegasus support on IBM platforms can

Line 1785

Line 1900

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

<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

and  is available through the following link:  <a

href="http://cvs.rdg.opengroup.org/bugzilla/">OpenPegasus bugzilla

database</a>.

Effective with the start of the Pegasus 2.6 work, all changes to the CVS tree

Effective with the start of the Pegasus 2.6 work, all changes to the

were documented through bugs.  Bugs reports were filed not only for bugs and

CVS tree are documented through bugs.  Bugs reports are filed not

their corresponding fixes but also as part of the process of committing new code

only for bugs and

representing the work on PEPs done for Pegasus 2.6 and all subsequent versions.  Therefore, a search of

their corresponding fixes but also as part of the process of committing

the Open Pegasus bugzilla base for bugs with the tag for a particular version

new code

representing the work on PEPs done for Pegasus 2.6 and all subsequent

versions.  Therefore, a search of

the Open Pegasus bugzilla base for bugs with the tag for a particular

version

(ex. 

2.6.0_APPROVED</a>,

href="http://cvs.rdg.opengroup.org/bugzilla/buglist.cgi?keywords=2.6.0_APPROVED">2.6.0_APPROVED</a>,

href="http://cvs.rdg.opengroup.org/bugzilla/buglist.cgi?keywords=2.6.1_APPROVED">

2.6.1_APPROVED</a>,

<a href="http://cvs.rdg.opengroup.org/bugzilla/buglist.cgi?keywords=2.7.0_APPROVED">2.7.0_APPROVED</a>) will yield all changes to

href="http://cvs.rdg.opengroup.org/bugzilla/buglist.cgi?keywords=2.7.0_APPROVED">2.7.0_APPROVED</a>,

etc) will yield all changes to

the Pegasus CVS tree for that Pegasus release.

     - Changes for Pegasus 2.7.0 release (bugs Tagged

     - Changes for this release (bugs Tagged

2.7.0_APPROVED) 

2.11.0_APPROVED). The link is <a

<a href="http://cvs.rdg.opengroup.org/bugzilla/buglist.cgi?keywords=2.7.0_APPROVED">Pegasus 2.7.0_APPROVED bug list</a>

href="http://bugzilla.openpegasus.org/buglist.cgi?keywords=2.11.0_APPROVED">

Pegasus 2.11.0_APPROVED bug list.</a>

<h2><a

name="Pegasus Release Control and Version Definition Documentation">Release Control and Version Definition Documentation</a></h2>

name="Pegasus Release Control and Version Definition Documentation">Release

Control and Version Definition Documentation</a></h2>

The Pegasus project is controlled largely through a set of documents

The Pegasus project is controlled largely through the CVS repository

(PEPs) that serve both as the definition and review mechanism for new and

and a set of documents

(PEPs) that serve both as the definition and review mechanism for new

and

modified Pegasus functionality and for the definition and documentation

of releases.

The following documentation defines the characteristics of this Pegasus

Specifically the following PEPs define the characteristics of this

release. The documents are available in the OpenPegasus CVS

Pegasus release. These PEPs are available at

repository.

OpenPegasus Approved PEPs.</a>

<ul>

<li> OpenPegasus Release Definition/Status -No PEP (See Wiki

Section <a

href="https://wiki.opengroup.org/pegasus-wiki/doku.php?id=dev:release:2_11_x">OpenPegasus

<ol>

2.11.x Release Status</a>) - A

section in the Pegasus wiki is used

<li>

PEP 296 - 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

functionality that will go into the release and points to all of the

represent the Pegasus  functionality changes for this version of Pegasus.</li>

PEPs that represent the Pegasus  functionality changes for this

version of Pegasus. </li>

OpenPegasus

Build and Configuration

<li>

<a href="http://www.openpegasus.org/pp/uploads/40/14873/PEP292_RecommendedReleaseOptions.htm">PEP 292</a> -  OpenPegasus  Build and Configuration

Options  for Selected

Platforms</li>

Platforms -  In previous

versions of Pegasus this information was  released as a Pegasus

<li>

PEP. Starting with Pegasus 2.9.0 the information is located in the

<a href="http://www.openpegasus.org/pp/uploads/40/14874/PEP293_ExternalInterface2.7.htm">PEP 293</a> - OpenPegasus 2.7 External Interfaces - Lists the public

OpenPegasus CVS repository as <big style="font-weight: bold;"> <span

interfaces for clients and providers that are considered external and

style="font-family: monospace;">pegasus/doc/BuildAndReleaseOptions.html</big>.

therefore "frozen".

<li> OpenPegasus External Interfaces -<span

style="font-weight: normal;">The list of the OpenPegasus interfaces

</li>

that are considered external and therefore "frozen". Unless an

exception is explicitly approved by the Steering Committee all

<li>

subsequent releases of Pegasus MUST continue to support these

<a href="http://www.openpegasus.org/pp/uploads/40/14875/PEP294_SDKFile2.7.0.htm">PEP 294</a> - OpenPegasus  SDK Packaging Definition - Defines the

interfaces. Interfaces not explicitly listed in this document, should

recommended set of files for inclusion in the OpenPegasus SDK</li>

be considered as internal and subject to change.In previous Pegasus

releases this information was available as a separate PEP. Starting

with Pegasus 2.9.0 this information is integrated into the Pegasus

repositoryas  <font

<li>

face="Courier New" size="4">pegasus/doc/EnternalInterface.html<span

<a href="http://www.openpegasus.org/pp/uploads/40/14877/PEP295_RuntimePackaging2.7.0.htm">PEP 295</a> - Pegasus  Runtime Packaging Definition - Defines the

style="font-weight: normal;">.</li>

recommended set of files for inclusion in this OpenPegasus release.</li>

<li> OpenPegasus  SDK Packaging Definition - <span

style="font-weight: normal;">Defines the recommended set of files for

inclusion in the OpenPegasus

SDK. Starting with Pegasus release 2.11.0, this document is available

<li>PEP 306 - Pegasus Release Notes (This document located in the

in the Pegasus CVS repository as <big style="font-weight: bold;"><samp>pegasus/doc/SDKPackaging.html</samp></big>.

approved PEP

repository and the OpenPegasus source tree root directory)

previous Pegasus releases this document was made available as s

separate Pegasus PEP document rather than in the CVS repository.

</li>

</li>

<li> Pegasus  Runtime Packaging Definition

</ol>

- Defines the recommended set

of files for inclusion in this OpenPegasus

<h2><a name="General Documentation">General Documentation</a></h2>

release. Starting with Pegasus release 2.11.0, this idocument contained

The following documentation is available for the this Pegasus

in the CVS repository as <big style="font-weight: bold;"><samp>pegasus/doc/RuntimePackaging.html</samp></big>.

release:

In previous

releases this was made available as a seperate Pegasus PEP document

rather than in the CVS repository.  </li>

<li>Pegasus Release Notes - <span

style="font-weight: normal;"> PEP 355 - <span

style="font-weight: normal;"> (This document is located in the

approved PEP repository and the OpenPegasus source tree root directory (<big

style="font-weight: bold;">pegasus/ReleaseNotes.htm</big>)</li>

</ul>

<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

<li class="MsoNormal" style="color: black;">Utilities - </li>

A

combination of help generally available with the --help option for each

command and HTML documentation for most of the tools.<o:p></o:p></li>

command and HTML documentation for most of the tools.<o:p></o:p> <li

class="MsoNormal" style="color: black;">API and  usage

documentation - </li>

See the header files and the HTML  API

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

extensive examples of the use of the Common APIs. <li

class="MsoNormal" style="color: black;">Building and Debugging

Providers - </li>

Readme.html in the Pegasus source tree Root Directory, API

<li class="MsoNormal" style="color: black;">Building and Debugging

Providers - Readme.html in the Pegasus source tree Root Directory, API

documentation, and documentation from the Pegasus Technical Workshop

which is available on the Pegasus web site.</li>

which is available on the Pegasus web site. <li class="MsoNormal"

style="color: black;">Building and Debugging

Clients - </li>

API documentation and the documentation on the Pegasus

<li class="MsoNormal" style="color: black;">Building and Debugging

Technical Workshop which is available on the Pegasus web site. <li

Clients - API documentation and the documentation on the Pegasus

class="MsoNormal" style="color: black;">PEPs - </li>

Technical Workshop which is available on the Pegasus web site.</li>

The

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

the design and implementation of these features.

</ul>

<hr>Licensed to The Open Group (TOG) under one or more contributor

license

agreements. Refer to the OpenPegasusNOTICE.txt file distributed with

this work for additional information regarding copyright ownership.

<span

Each contributor licenses this file to you under the OpenPegasus Open

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

Source License; you may not use this file except in compliance with the

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

License.

style="color: black;">

Permission is hereby granted, free of charge, to any person

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

obtaining a

width="100%">

copy of this software and associated documentation files (the

"Software"),

Corporation; Hewlett-Packard Development Company, L.P.; IBM Corp.; The

to deal in the Software without restriction, including without

Open Group; VERITAS Software Corporation; Intel Corp.

limitation

the rights to use, copy, modify, merge, publish, distribute,

Permission is hereby granted, free of charge, to any

sublicense,

person obtaining a copy  of this software and associated

and/or sell copies of the Software, and to permit persons to whom the

documentation files (the "Software"), to deal in the Software without

Software is furnished to do so, subject to the following conditions:

restriction, including without limitation the rights to use, copy,

The above copyright notice and this permission notice shall be

modify, merge, publish, distribute, sublicense, and/or sell copies of

included

the Software, and to permit persons to whom the Software is furnished

in all copies or substantial portions of the Software.

to do so, subject to the following conditions:

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESS

THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION

OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

NOTICE SHALL BE INCLUDED IN ALL COPIES OR SUBSTANTIAL PORTIONS OF THE

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

SOFTWARE. THE SOFTWARE IS PROVIDED  "AS IS", WITHOUT WARRANTY OF

IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY

ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE

CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,

WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE

SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

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

</div>

</body>

</html>

Legend:

Removed from v.1.12
changed lines
	Added in v.1.18

No CVS admin address has been configured