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

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

version 1.17.4.3, 2013/07/20 18:32:34

Line 1

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

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

<head>

<style>

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

</style>

Line 962

Line 965

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:DocumentProperties> <o:Author>IBM_User</o:Author> <o:LastAuthor> </o:LastAuthor> <o:Revision>4</o:Revision> <o:TotalTime>211</o:TotalTime> <o:Created>2004-04-05T14:13:00Z</o:Created> <o:LastSaved>2004-04-12T16:03:00Z</o:LastSaved> <o:Pages>1</o:Pages> <o:Words>5026</o:Words> <o:Characters>28651</o:Characters> <o:Company>IBM</o:Company> <o:Lines>238</o:Lines> <o:Paragraphs>67</o:Paragraphs> <o:CharactersWithSpaces>33610</o:CharactersWithSpaces> <o:Version>10.4219</o:Version> </o:DocumentProperties></xml><![endif]--><!--[if gte mso 9]><xml>

<w:WordDocument> <w:SpellingState>Clean</w:SpellingState> <w:GrammarState>Clean</w:GrammarState> <w:Compatibility> <w:ApplyBreakingRules/> </w:Compatibility> <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel> </w:WordDocument></xml><![endif]-->

<o:smarttagtype

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>

<o:Revision>4</o:Revision>

<o:TotalTime>211</o:TotalTime>

<o:Created>2004-04-05T14:13:00Z</o:Created>

<o:LastSaved>2004-04-12T16:03:00Z</o:LastSaved>

<o:Pages>1</o:Pages>

<o:Words>5026</o:Words>

<o:Characters>28651</o:Characters>

<o:Company>IBM</o:Company>

<o:Lines>238</o:Lines>

<o:Paragraphs>67</o:Paragraphs>

<o:CharactersWithSpaces>33610</o:CharactersWithSpaces>

<o:Version>10.4219</o:Version>

</o:DocumentProperties>

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

<w:WordDocument>

<w:SpellingState>Clean</w:SpellingState>

<w:GrammarState>Clean</w:GrammarState>

<w:Compatibility>

<w:ApplyBreakingRules/>

</w:Compatibility>

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

</w:WordDocument>

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

</head>

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

style="color: black;">

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

OpenPegasus Enhancement

width="100%"></div>

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

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

align="center">Pegasus

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

PEP #: 366

PEP #: 306

Title: Release

Notes for OpenPegasus 2.7.0

Notes for OpenPegasus version 2.13.0

Created: 18 July

2013

Created: 3 October 2007

Authors: Karl

Authors: Karl Schopmeyer

Schopmeyer

Status:  draft

Version History:

<tbody>

<o:p> </o:p>

</td>

<o:p> </o:p>

</td>

<o:p> </o:p>

</td>

<o:p> </o:p>

</td>

</tr>

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

</td>

11 July 2013

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

October 2007

</td>

Karl Schopmeyer

Karl Schopmeyer

</td>

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

Initial

Submission<o:p>

</o:p>

</td>

</tr>

<tr>

<td style="padding: 0.75pt;" align="center" height="21">1.01

</td>

<td style="padding: 0.75pt;" align="center" height="21">11 July 2013

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

</td>

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

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

Schopmeyer

</td>

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

<td style="padding: 0.75pt;" height="21">Minor editorial updates

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

before review

</td>

</tr>

<td style="padding: 0.75pt;" align="center" height="21">1.02

</td>

<td style="padding: 0.75pt;" align="center" height="21">16 July 2013

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

</td>

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

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

Schopmeyer

</td>

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

<td style="padding: 0.75pt;" height="21">Update with comments from

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

1.01. See bug 9611. Add new section"Notes on SpecificOpenPegasus

Functionality"

</td>

</tr>

<tr>

<td style="padding: 0.75pt;" align="center" height="21">1.03

</td>

<td style="padding: 0.75pt;" align="center" height="21">18 July 2013

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

</td>

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

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

</td>

<td style="padding: 0.75pt;" height="21">Respond to HP comment about some confusion with the comment to bug 8830 in the compatibility Considerations section

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

</td>

</tr>

</tr>

</tbody>

</table>

<span

style="color: black;">

Abstract: This document defines the release notes for the 2.13.0

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

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

width="100%"></div>

summarize the characteristics of this release, point to other

Abstract: This document defines the release notes for the

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

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.

<span

style="color: black;">

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

width="100%"></div>

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

<ol>

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

Release</a></li>

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

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

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

of This Release</a></li>

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

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

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

Considerations</a></li>

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

<li><a href="#Notes_on_Specific_OpenPegasus">Notes on Specific

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

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

with DMTF Specifications</a></li>

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

<li> <a

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

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

Release

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

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

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

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

Documentation</a></li>

</ol>

<h2>Availability

<h2>Availability of this Release</h2>

of this Release</h2>

This release is available in a number of forms including:

This release is available in a number of forms including:

<ul>

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

These can be

These can be downloaded from the OpenPegasus

downloaded from the OpenPegasus Web

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

site at <a

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

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

source RPM is  available on the OpenPegasus web site that can be

<li>OpenPegasus source RPMs on the OpenPegasus web site.. A source RPM is  available on the

used to build binaries for most LSB-compliant RPM-based Linux

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

distributions and versions.</li>

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

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

release and

release and subsequent snapshots that are made available in the

subsequent snapshots that are made available in the Pegasus CVS are

Pegasus CVS are defined on the OpenPegasus CVS repository web page

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

(see the <a href="http://cvs.opengroup.org/cgi-bin/viewcvs.cgi/">OpenPegasus

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

CVS

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

page</a> for information) using the tags defined on the <a href="http://www.openpegasus.org/page.tpl?CALLER=cvs.tpl&ggid=392">release

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

snapshots

snapshots page</a>.</li>

page</a> and the <a title="https://wiki.opengroup.org/pegasus-wiki/doku.php?id=dev:openpegasusreleasestatus" href="https://wiki.opengroup.org/pegasus-wiki/doku.php?id=dev:openpegasusreleasestatus">OpenPegasus

WIKI Release Status Page</a>.</li>

</ul>

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

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

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

WEB site</a>.

WEB

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

site</a> and the <a title="OpenPegasus WIKI" href="https://wiki.opengroup.org/pegasus-wiki/doku.php?id=start">OpenPegasus

Pegasus source

WIKI</a>. Installation instructions are part of the README in the root

tree.

of the Pegasus source tree.

</div>

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

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

OpenPegasus overall status by release is defined by  a <a href="http://www.openpegasus.org/page.tpl?ggid=799">Feature

Pegasus overall status by release is defined by  a

Status WEB Page</a> that is available on the OpenPegasus web site

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

.  That web page shows the Pegasus users and developers the status of

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

the various features found in OpenPegasus using a simple color coded key

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

(white, red, yellow, green) and a description of each feature.

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

each feature.Pegasus 2.7.0

OpenPegasus 2.13.0 is a major release, extending the previous Pegasus

is a major release, extending Pegasus 2.6 in selected

release in selected areas as described in the Pegasus  PEP defining

areas as described in the Pegasus  PEP defining this release

this release .

.

NOTE: OpenPegasus releases are categorized as follows:

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

<ul>

more information access the PEP for each change defined:

<li>First number of version changes (ex. 2.x.x to 3.0.0) -  Major

release includes major functionality change and  incompatible

behavior changes and/or incompatible public API changes,

Table of Major Changes for this Release

</li>

<li>Second number changes (ex 2.12.0 2.13.0) -  Minor Release and

includes new functionality but maintains behavior and public API

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

compatibility,

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

</li>

<TBODY>

<li>3rd number changes (2.13.0 to 2.13.1) - Revision(also called point

release) release and only includes bug fixes.</li>

</ul>

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

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

ALL changes for each release are documented in the

</TR>

OpenPegasus bug data base by tagging each bug(keyword field of bug). 

No change to Pegasus is committed with out this tag on the bug. Changes

for this minor release are  tagged 2.13.0_APPROVED. All changes for

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

this minor release can be viewed through  this link to the

Solutions Environment (PASE)</TD>

OpenPegasus bugzilla <a href="http://bugzilla.openpegasus.org/buglist.cgi?keywords=2.13.0_APPROVED">

Pegasus 2.13.0_APPROVED bug list. Bugs.  </a>Bugs marked as

enhancements can be reviewed through the this <a href="http://bugzilla.openpegasus.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=CIM+Server+Core&product=CIMClient+Application&product=CIMClient+DefaultCPlusPlus&product=CIMClient+Java-SNIA&product=CIMConsumer+DefaultCPlusPlus&product=CIMIndicationHandler&product=CIMListener+Dynamic&product=CIMListener+Standalone&product=CIMProvider+CMPI&product=CIMProvider+CMPIRemote&product=CIMProvider+DefaultCPlusPlus&product=CIMProvider+Instrumentation&product=CIMProvider+JMPI&product=CIMSchema&product=CIMServer+Administration&product=CIMServer+Administration+Command&product=CIMServer+Administration+Profiles&product=CIMServer+ProviderManagement&product=CIMServer+Repository&product=CIMServer+SLP&product=OpenPegasus+Build+System&product=OpenPegasus+Documentation&product=OpenPegasus+Security+Defects&product=OpenPegasusProject+Bugzilla&product=OpenPegasusProject+CVS&product=OpenPegasusProject+Website&product=PegasusCIMOM&product=PegasusGeneral&product=RPM+CIMServer&product=TestProduct&product=Unsupported&product=WMI+Mapper&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=2.13.0_APPROVED&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailqa_contact2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&chfieldfrom=&chfieldto=Now&chfield=%5BBug+creation%5D&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=bug_severity&type0-0-0=equals&value0-0-0=enhancement">link

1.6</a></TD>

to OpenPegasus bugzilla 2.13.0 enhancement bugs</a> .  Bugs fixed

</TR>

for subsequent revision releases (ex. 2.13.1) would also be viewed through

corresponding Bugzilla tags for each revisions (ex 2.13.1_APPROVED).

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

The major areas of development including both enhancements and bug fixes

(Privilege Separation)</TD>

for this release  were as 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

1.8</a></TD>

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

</TR>

Table of Major

Changes for this Release. Please review  Bugzilla 2.13.0

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

Enhancements and approved(above) for a complete list

was made available but normally disabled

Pegasus 2.6.1)</TD>

<tbody>

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

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

Version</th>

</tr>

<tr>

<td>Fixed issues where Pegasus compiler converted Schema Qualifer

decl to CLASS</td>

<td>

</td>

</tr>

<tr>

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

</td>

<td>Fixed issue that could cause server error if providers

return  associator or ref responses with no keys in path</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Support Writing indications to local file. Note that this is

primarily a development and debug extension.

</td>

<td>

</td>

</tr>

<tr>

<td>Remove the PEGASUS_VENDOR_HP build variable</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Enhance repupgrade utility to support "interop" namespace (see

note below)

</td>

<td><a href="https://collaboration.opengroup.org/pegasus/pp/documents/24686/PEP304.htm">PEP

304, Version 1.6</a>

</td>

</tr>

<tr>

</td>

<td>Support clang compiler in Production Build

</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Add more supplemental help info to cimconfig CLI tool that views

and sets runtime parameters

</td>

<td>

</td>

</tr>

<tr>

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

</a>and others

</td>

<td style="vertical-align: top;">Fixed issues involving compiled

unused variable warnings and set compiler defaults to make these

warnings a build error.

</td>

</td>

</tr>

<tr>

</td>

<td>Clean up  issues with building with static libraries

</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Reduce static code size (Note: several bug fixes contributed to

this reduction) (see 9555, 9560, 9557, 9558, 9580)

</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Log rotation configuration variable to set max file size (see

below for more info)

</td>

<td>

</td>

</tr>

</td>

<td align="left" width="75%">Remove compile option

PEGASUS_CLIENT_TRACE_ENABLE (now always compiles) </td>

</td>

</tr>

<tr>

</td>

<td>Fix issues requiring restart of cimserver  if indication

provider reregistered

</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Initial configure script for OpenPegasus (Experimental, see below)

</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Update env_var_LINUX.status and env_var_HPUX.status to change

some build defaults

</td>

</td>

</tr>

<tr>

<td>Modify environment variable definition that controls client

tracing (See below)</td>

<td>

</td>

</tr>

<tr>

</td>

<td align="left" width="75%">Add support for PUSH_WITH_ACK delivery

mode for WSMAN indications

</td>

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

</td>

</tr>

<tr>

<td>Change default Schema version to use CIM Schema 2.36</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Replace custom atomic operations with GCC built-in atomic

operations(see below for more comments)

</td>

<td>

</td>

</tr>

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

</td>

<td align="left" width="75%">IPV6 support for OpenPegasus slp using

OpenSLP 2.0 (See OpenSLP 2.0 issues documented below)

</td>

</td>

</tr>

<tr>

</td>

<td>Support for ARM 64 CPU by adding platform definition

(Experimental because of limited testing)

</td>

</td>

</tr>

<tr>

</td>

<td>Fix connection between indication handlers and IndicationService

so that OnFatalErrorPolicy works

</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Expand reporting of errors from PAM so detailed PAM errors reported.

</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Allow remote update of expired user password for PAM session

based authentication

</td>

<td>

</td>

</tr>

<tr>

</td>

<td>Role-based authorization extension for CMPI providers

</td>

<td>

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

previous release to this release</a> on the <a href="http://www.openpegasus.org/page.tpl?ggid=799">Feature

Status WEB Page</a>.

<h2><a name="Notes_on_Specific_OpenPegasus"></a>Notes on Specific

OpenPegasus Functionality Changes</h2>

This section documents specific issues that the OpenPegasus team feels are

important to OpenPegasus users with the current release (and possibly

older releases).

<h3>Add new RunTime Variables to control trace file size and Rotation(OpenPegasus

2.13.0)(bug 9550)</h3>

As of OpenPegasus 2.13.0, two new runtime variables have been added:

   * traceFileSizeKBytes -  Defines the size of the

tracefile in kilobytes. The trace file will be rolled once its size

exceeds the specified size.

   * numberOfTraceFiles - Specifies the number of the tracefiles

for rolling where the default is 3.

<h3>Using GCC 4.7 Compiler on Linux OS (OpenPegasus 2.13.0)

</h3>

As of 2.13.0, OpenPegasus has been updated to replace the custom atomic

operations with GCC built-in atomic operations if GCC version 4.7 or

greater is used as the compiler.  It is recommended that if possible

this version of the GCC compiler be used since the change provides

significant performance improvements.

<h3>OpenPegasus and OpenSLP V 2.0 (OpenPegasus 2.13.0)</h3>

As of 2.13.0, OpenPegasus slp fully supports IPV6  and has been

tested with OpenSLP 2.0 (Recently released by <a href="http://openslp.org">OpenSlp.org</a>)

While testing OpenPegasus with OpenSLP 2.0 the OpenPegasus team found two

issues with this version of OpenSLP.  The patches documented below

allow this version of OpenSLP to work with OpenPegasus

1) SLPReg used TCP connection previously, but it now uses UDP. Therefore,

a BUFFER_OVERFLOW exception occurs.  This is because UDP cannot

handle attribute size greater than network MTU size. In such cases,

according to the specification, OpenSLP should automatically switch to

TCP.  Since this has not been implemented in OpenSlp 2.0, the

workaround used by OpenPegasus to force use of TCP may be found at <a title="http://sourceforge.net/p/openslp/bugs/139/" href="http://sourceforge.net/p/openslp/bugs/139/">http://sourceforge.net/p/openslp/bugs/139/</a>.

2) On Windows, slpd service fails to start when IPV6 is enabled and throws

the error message "Error 1067: the process terminated unexpectedly". More

details and the fix for this issue are in the bug <a href="http://sourceforge.net/p/openslp/bugs/140/">http://sourceforge.net/p/openslp/bugs/140/</a>.

<h3>Interop namespace name (OpenPegasus 2.13.0)</h3>

Effective with the release of OpenPegasus  2.13 the "interop"

namespace support for existing or

older repositories which used

"root/PG_InterOp" has been added via a new option in the "reupgrade"

utility. Users with existing repositories may use this option to migrate

the repository from "root/PG_InterOp" to

"interop" namespace.  See <a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=9414" title="RESOLVED FIXED - enhance repupgrade to support "interop" namespace">bug

9414</a> (PEP304) for

details.

For this to work, the build  option "PEGASUS_INTEROP_NAMESPACE" has

to be

set to "interop". Only then will the "-i" option in repupgrade be enabled.

Once the repository is upgraded with "-i" , the namespace

"root/PG_InterOp"

will cease to exsist. Clients using "root/PG_InterOp" must now use

"interop".

Prior to version 2.12 OpenPegasus used an OpenPegasus internal variable to

define "root/PG_InterOp" as the name for the OpenPegasus namespace with no

defined way to change this variable.  Note that an unsupported method

involving editing one file and rebuilding OpenPegasus was defined as a

workaround in the <a href="file:///home/kschopmeyer/dev/pgogbug9611releasenotes/pegasus/%20https://wiki.opengroup.org/pegasus-wiki/doku.php?id=faq:openpegasus_build_and_installing">OpenPegasus

wiki faq</a>s.

However, since the definition of a standard name for this namespace in

DMTF and SNIA specifications ("interop" or "root/interop" with "interop"

being the preferred alternative) the use of  "root/PG_InterOp" has

become an issue. Support for forward-compatibility is a fundamental design

principle for the OpenPegasus project. As a community, our goal is for

well-behaved OpenPegasus providers or clients, using only the externally

defined OpenPegasus interface, to continue to work with each version

upgrade of OpenPegasus.

Effective OpenPegasus 2.12.0 a new build variable was defined 

(PEGASUS_INTEROP_NAMESPACE) which allows an OpenPegasus builder to define

an alternate name for the Interop namespace to either "interop" or

"root/interop" (ex. PEGASUS_INTEROP_NAMESPACE = interop).  Once this

build variable is defined and OpenPegasus compiled, the actual name of the

interop namespace is what was defined in this varaible and all components

of OpenPegasus use this as the interop namespace name include the complete

OpenPegasus test suite.  The only name for the interop namespace will

be the name defined through this build variable.  This is the logical

approach for implementations starting a new repository.

In order to supexport PEGASUS_CLIENT_TRACE=keyword:keywordport users with

existing repositories, in 2.13.0,  migration of existing repositories

was integrated into the "repupgrade" utility to allow existing OpenPegasus

environments to smoothly move the server from use of the old name 

for the interop namespace "root/PG_InterOp" to 

the prefered name "interop".

NOTE: If the interop namespace

name is redefined with PEGASUS_INTEROP_NAMESPACE clients using the

"root/PG_InterOp" namespace will not connect with the updated version of

OpenPegasus. The OpenPegasus team searched for a solution to the issue

supporting the old and new name at the same time and concluded that there

were so many issues that it could not effectively be done.

<h3>Configure Script to Control OpenPegasus Builds (OpenPegasus

2.13.0)(Bug 9592)</h3>

OpenPegasus is moving from the use of environment variables to a configure

script to control build.  This is both to make it easier to define

the build variables, etc. and to be more compatibile with the Linux/Unix

standard build environment.  However, because OpenPegasus must build

on a number of platforms that do not support the full Linux/Unix

configuration tool set, this is an OpenPegasus defined configure

script.  The first very experimental version is part of OpenPegasu

2.13.0 but this version has a number of limitations (see the OpenPegasus

Bugzilla) and will be expanded in the next versions of OpenPegasus.

The goal is to replace the setting of most of the OpenPegasus build

environment variable with options in the pegasus/configure script where

those options are comatible with the Linux standard for defining configure

options and those options control the entire build process including placement

of output and choice of build options.

<h3>Tracing Client Requests and Responses(OpenPegasus2.13.0)</h3>

OpenPegasus has

long contained a hidden build controlled function to allow tracing at

the client through an environment variable

(PEGASUS_CLIENT_TRACE_ON).  In 2.13.0 this was a) make a permanent

part of of the environment (Bug 9564) and the calling convention

slightly changed

to make it simpler to use. The original format for the

environment variable was:

<pre class="bz_comment_text" id="comment_text_1">export PEGASUS_CLIENT_TRACE=keyword:keyword where the keyword was "con" | "log" | "both" This was changed to: keyword:keyword separately define Client input and output keyword: Client Input only :keyword Client Output Only keyword Client Input and output defined by keyword</pre>

so that the normal setup for a console output trace would be

<pre> export PEGASUS_CLIENT_TRACE=con</pre>

<h3>Information on IPV6 Support and OpenPegasus(PEP 291)(OpenPegasus

2.7.0)</h3>

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 Support for OpenPegasus is documented in

1.2</a></TD>

PEP 291</a>.

</TR>

The IPv6 support in OpenPegasus is controlled by the PEGASUS_ENABLE_IPV6

build variable. The default for this variable is "true"; setting this to

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

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

1.1</a></TD>

</TR>

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

1.2</a></TD>

</TR>

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

1.0</a></TD>

</TR>

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

logging</TD>

1.5</a></TD>

</TR>

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

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

triage of indication delivery issues</TD>

Bug 6466</a></TD>

</TR>

</TBODY>

</TABLE>

</html>

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 previous

release to this release</a> on the

<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

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

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

291</a>.

The IPv6 support in OpenPegasus is

controlled by the PEGASUS_ENABLE_IPV6 build variable. The default for this

variable is "true"; setting this to

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

The following subsections provide

The following subsections provide some information on IPv6 support for the

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

Linux and Windows platforms. Note that in the 2.6.1 release there is no

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

automatic run-time detection of IPv6 support on a platform by OpenPegasus.

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

If you build with PEGASUS_ENABLE_IPV6=true, your platform must support

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

IPv6 or you will get a build failure (missing header files), a run-time

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

bind() failure, or possibly some other failure. This applies to both the

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

CIM Server and Listener components. For more information on IPv6 support

Listener components. For more information on IPv6 support for your

for your specific platform, refer to the documentation for that platform.

specific platform, refer to the documentation for that platform.

All OpenPegasus externals that support eitcompilerher a hostname or an IP

All OpenPegasus externals that

address as input have been updated to allow an IPv6 address to be

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

specified. If the required input is just an IP address (eg. no optional or

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

required port number), then the IPv6 address must be specified without

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

brackets. For example, the OpenPegasus osinfo client (which returns

address must be specified without brackets. For example, the

information about the OS running on a host system) takes separate host and

OpenPegasus osinfo client (which returns information about the OS

port options. In this case a host with an IPv6-configured network

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

interface would be specified as:

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

specified as:

<div style="margin-left: 40px; color: rgb(153, 51, 153); font-family: monospace;"><big>osinfo -h 3ffe:1:2:1 -p 5988</big></div>

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

But the cimcli command, which takes an optional "location" option

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

including an optional port number, requires the IPv6 address to be

But the cimcli command, which

delimited with brackets, for example:

takes

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

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

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

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

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

or

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

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

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

</div>

For more information on

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

specifying

RFC

IPv6 addresses, refer to <a

2373 - IP Version 6 Addressing Architecture</a> and <a href="http://www.ietf.org/rfc/rfc2732.txt">IETF

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

RFC 2732 - Format for Literal IPv6 Addresses in URL's</a>.

6 Addressing Architecture</a>

and <a

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

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

<h4>IPv6 on Linux</h4>

Modern Linux distributions already

Modern Linux distributions already contain IPv6-ready kernels, the IPv6

contain IPv6-ready kernels, the

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

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

module is not loaded automatically on startup.

that this module is not loaded automatically on startup.

Note:

Note: you shouldn't use

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

kernel series 2.2.x, because it's not IPv6-up-to-date anymore. Also the

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

IPv6 support in series 2.4.x is no longer improved according to

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

definitions in latest RFCs. It's recommend to use series 2.6.x now.

to use series 2.6.x now.

To check whether your current running kernel supports IPv6, take a look

To check whether your current

into your /proc filesystem. The entry /proc/net/if_inet6 must exist. A

running

short automated test looks like:

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); font-family: monospace;"><big>test -f /proc/net/if_inet6 && echo "Running

kernel is IPv6 ready"</big></div>

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

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

For more iSchema version default update to CIM 2.36nformation on enabling

For more information on

IPv6 in the Linux kernel and configuring network interfaces, refer to <a href="http://tldp.org/HOWTO/html_single/Linux+IPv6-HOWTO/">The Linux

enabling

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

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

Documentation Project's IPv6 HOWTO</a>.

Warning:

Warning: There is currently an

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

open issue with RedHat to address a problem that is seen intermittently on

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

RHEL5 and SLES10 systems. This problem is described in

described in <span

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

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

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

bug

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

248052</a>, and manifests itself as an intermittent IPv6

bug 6586</a>

socket failure. You should be aware that OpenPegasus with IPv6 enabled may

be significantly impacted in these environments.

and<span

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 should be aware

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

Microsoft provides supported IPv6 implementations for Windows Server 2003,

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

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

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

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

On Windows XP, you can use the <span

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

On Windows XP, you can use the ipv6.exe

query

tool to install, uninstall, and query your IPv6 configuration. For

your IPv6 configuration. For example:

example:

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

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

ipv6 if</div>

ipv6 if</big></div>

Windows Vista

and Windows Server 2008 support an integrated

Windows Vista and Windows Server 2008 support an integrated IPv4 and IPv6

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

implementation known as the Next Generation TCP/IP stack. Note that the

Note that the OpenPegasus IPv6 support has not yet been tested

OpenPegasus IPv6 support has not yet been tested on Windows Vista or

on Windows Vista or Windows Server 2008.

Windows Server 2008.

For more information on

For more information on installing, configuring, and using IPv6 on Windows

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

platforms, refer to the document <a href="https://www.microsoft.com/technet/network/ipv6/ipv6faq.mspx">IPv6 for Microsoft Windows: Frequently Asked Questions</a>.

the document

<h4>Testing  OpenPegasus IPv6 support</h4>

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

As part of the OpenPegasus automated tests, the TestClient, g11ntest, and

IPv6

IndicationStressTest test clients were modified to run tests using the

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

IPv6 loopback address (::1) if PEGASUS_ENABLE_IPV6=true.

<h4>Testing your OpenPegasus IPv6

You can also perform manual tests using the IPv6 loopback or a real

support</h4>

IPv6-configured network interface. For example, using the IPv6 loopback on

As part of the OpenPegasus

a system with OpenPegasus running on the WBEM standard http port of 5988:

automated tests, the TestClient, g11ntest, and IndicationStressTest

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

(::1) if PEGASUS_ENABLE_IPV6=true.

You can also perform manual

tests

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

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>

<h2><a name="Compatibility_Considerations_">OpenPegasus Compatibility

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

Considerations</a></h2>

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

Support for forward-compatibility is a fundamental design principle for

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

the 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 providers or clients, using only the externally defined

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

OpenPegasus interface, to continue to work with a minor version upgrade of

significantly affects interoperability) that may require the Community to make

OpenPegasus. However, there are certain classes of errors (e.g.,

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

non-compliance with a standard that significantly affects

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

interoperability) that may require the community to make potentially

upgrading to OpenPegasus 2.7.0.

incompatible changes. The following table contains a list of defects/fixes

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

that MAY impact, even well-behaved, OpenPegasus providers or clients when

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

upgrading to this OpenPegasus release.

<TBODY>

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

<tbody>

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

</TR>

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

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

</tr>

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

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

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

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

8830</a></td>

<td align="left">Starting

</TD>

with OpenPegasus 2.11.0 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

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>

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

allow users to actually filter properties from an instance in a

provider, a new function (CIMInstance::filterInstance()) will actually

<TD>

filter properties from an instance exactly as the CIMInstance::filter()

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

did in previous versions of Pegasus. This is not required since the

</TR>

CIMServer will do the filtering but allows the provider to prefilter

</TBODY>

properties if it so desires, in particular where properties might be

</TABLE>

very large or there would be a significant number of properties.

</html>

</td>

</tr>

<h2>OpenPegasus Relationship to

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

CIM/WBEM Standards</h2>

9369</a>

Pegasus was designed and implemented to comply with the DMTF

</td>

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

<td align="left">NOTE: This bug

DMTF specifications to which this version of Pegasus aims to conform

fixed in OpenPegasus 2.13.0. Reregistering of an

today.

indication provider requires that the  cimserver be restarted

to send the enableIndication request to the providers. This issue

has existed starting with OpenPegasus 2.10 to  version 2.12.

If the cimserver is not restarted the indication will not be

enabled for the reregistered provider. </td>

</tr>

</tbody>

</table>

<h2>OpenPegasus Relationship to CIM/WBEM Standards</h2>

Pegasus was designed and implemented to comply with the DMTF CIM/WBEM

specifications The following table defines the level of the DMTF

specifications to which this version of Pegasus aims to conform today.

<tbody>

<tr>

Line 1508

Line 1712

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

</tr>

<tr>

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

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

<td width="33%">2.36.0 Final ( default build Schema) </td>

</tr>

<tr>

<td>DSP0226 - Web Services for Management

</td>

<td>Version 1.1.1

</td>

</tr>

<tr>

<td>DSP0227 - WS-Management CIM Binding Specification

</td>

<td>Version 1.2.0

</td>

</tr>

<tr>

<td>DSP0230 - WS-CIM Mapping Specification </td>

<td>Version 1.1.0

</td>

</tr>

</tbody>

</table>

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

<h2><a name="Conformance with DMTF Specifications"></a>DMTF/SNIA SMI

Exceptions to

Profiles Supported</h2>

DMTF Specifications</a></h2>

It is a major goal

Today OpenPegasus includes support for several DMTF profiles including:

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

<li>DMTF ProfileRegistration Version DSP 1033, Version 1.0.0</li>

through a set of Pegasus Provider registration classes rather than

<li>DMTF Indications DSP 1054, Version 1.1.0. Since this is effectively the same as the

support the DMTF defined Provider Qualifier. Pegasus will not support

SNIA SMI Indication profile it also supports this profile. This

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

profile is enabled by compiling OpenPegasus with the buld variable

provider registration.  This is not a deviation from the

PEGASUS_ENABLE_DMTF_INDICATION_SUPPORT.

specifications but is a different method of registration than many CIM

</li>

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

<li>SNIA Profile Registration 1.0.0

<li>Indications -Today Pegasus supports process

</li>

indications and lifecycle indications when defined specifically by

<li>SNIA Server 1.1.0 & 1.2.0

</li>

</ol>

<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 really a deviation from the specifications since there is no

specification or profile for provider registration today but is a

different method of registration than many CIM Servers and means that

the the provider qualifier is unused in Pegasus.</li>

<li>Lifecycle Indications -Today Pegasus supports process

iPegasusndications 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.<font

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

color="#ff0000">  For

For more

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

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

<font

pegasus/src/Unsupported/LifecycleIndicationProvider/README.LifecycleIndications.htm</a>.</li>

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

<li> IncludeQualifiers

<li>

option

<font

on Instance Operations

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

- The DMTF specifications have deprecated the use of qualifiers on

option on Instance Operations

instance operations with the 1.2 CIM Operations Over HTTP Specification (DSP0200) and

stated specifically that the client should NOT depend on the

The DMTF specifications have deprecated the use of qualifiers on

includeQualifiers parameter of the CIM/XML instance operations

instance operations with the 1.2 CIM Operations Specification. 

returning qualifiers.  Some CIM Client implementations expect

Some CIM Client implementations expect instances

instances returned from the CIM Server to include the qualifiers

returned

defined in the class definition (such as KEY qualifiers on

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

properties).   Pegasus today expects the provider to

definition (such as KEY qualifiers on properties).   Pegasus

complete the qualifiers on instances in accordance with the

today expects the provider to complete the qualifiers on instances in

specification and generally the interpretation is that Pegasus

accordance with the specification and generally the interpretation is

applies class level qualifiers when the includeInstance parameter is

that Pegasus applies class level qualifiers when the includeInstance

supplied on instance operations.  However, Pegasus today is

parameter is supplied on instance operations.  However, Pegasus

inconsistent in the return of qualifiers so that the user should NOT

today is inconsistent in the return of qualifiers so that the user

depend on Pegasus accurately honoring the includeQualifier parameter

should NOT depend on Pegasus accurately honoring the includeQualifier

for instance operations.  In the future it is expected that

parameter for instance operations.  In the future it is expected

Pegasus will deprecate the use of qualifiers on instance operations

that Pegasus will deprecate the use of qualifiers on instance

completely.  When Pegasus uses object normalization, the

operations completely.

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 CIM/XML Option

-  Pegasus does not support the DMTF defined MultiRequest

Operation option (See DSP0200).

</li>

<li>LocalOnly option on instance

<li>MOF Namespace Pragma -The

Operations - With the 1.1 version of Specification for CIM

Pegasus compiler does not support the namespace pragma defined in DSP

Operations over HTTP, the definition of the LocalOnly parameter for the

0004. Namespaces for the OpenPegasus repository are defined through

GetInstance and Enumerate Instances operations was modified. This change

arguments for the MOF Compiler

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>

<li>CIMOperation Trailer - Pegasus implements chunking based on

MOF Compiler namespace pragma - The

the DSP0200 1.2.0 preliminary spec. including the operation trailer

Pegasus compiler does not support the namespace pragma.

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 incorporated into the code 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>OpenPegasus Interop Namespace - The default interop namespace

name in OpenPegasus is "root/PG_Interop".  In versions of

OpenPegasus prior to 2.12.0 this could be changed during build by

modifying a string definition in the code. Effective version 2.12.0

this  has become a build option with the build configuraton

environment variable PEGASUS_INTEROP_NAMESPACE = <name for this

namespace> however, the default if built without this change is

still "root/PG_InterOp". Effective with OpenPegasus 2.13.0 the reupgrade utility has been extended to allow existing repositories to be converted from the use of "root/PG_Interop" to "interop" (See discussion above).  The default in the CVS source code is still "root/PG_InterOp".

</li>

<li>Pegasus implements

<li>OpenPegasus WSMAN protocol on windows does not handle NaN, INF,

chunking

or -INFHowever, t (bug  <a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=8836">8836</a>)

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

- If requests or responses include properties or parameters with

defined in that specification Refer to bug

floating point property types (Real32 or Real64) with the special

states NaN, INF, or -INF on a Windows platform, the input is not

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

accepted because these special strings are not understood by the

decoder on Windows.</li>

<li>OpenPegasus outputs Nan, INF, -INF special values for Real32 and

Real64 property and Parameter types for the CIM/XML protocol -

(bug <a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=9392">9392</a>).

Today the DMTF Specification DSP0201 allows only numeric information

in the format definition for this type and does not all the special

strings Nan, etc. However, OpenPegasus actually outputs the special

strings if  that is what is defined in the internal values. 

OpenPegasus does not allow these special Strings on input however,</li>

<li>OpenPegasus does not handle covered properties - (bug <a href="http://bugzilla.openpegasus.org/show_bug.cgi?id=3571">3571</a>)

Covered properties (properties which have the same name in a

superclass and subclass without overridding the property in the

superclass) are not allowed in OpenPegasus. While the requirement for

this functionality was added to DSP0004 subsequent to version 2.4, the

general agreement is that the requirement itself is not supportable

and particularly not with the existing OpenPegasus APIs. 

Further, the requirement is expected to be removed in the future (i.e

CIM 3.0).

</li>

</ol>

<h2>OpenPegasus <a

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

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 including a maintainer for the platform that will be willing to

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

regularly document issues and/or fix defects as the Pegasus code base is

regularly document issues and/or fix defects as the Pegasus

changed.  Pegasus may be operable on other platforms (ex. Windows 98)

code base is changed. 

but without a group to provide the role of test and maintenance, correct

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

operation of  Pegasus cannot be assured.  In all cases,

a group

including the active platforms, it is the responsibility of the entity

to provide the role of test and maintenance, correct operation of 

that packages and/or compiles OpenPegasus for shipment or deployment, to

Pegasus cannot be

read, and actively monitor the Pegasus Bugzilla database for a list of

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

relevant defects that affect their platform.   The platforms

responsibility of the entity that packages and/or compiles OpenPegasus

that are considered ported are shown in the two tables below.  The

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

first table represents platform for which testing is done on a regular

bugzilla database for a list of relevant defects that affect their

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

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

platforms which have been ported but do not have test results that are

Pegasus release are:

current at the time of the release are reported in the second table.

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

Actively Supported Platforms (Nightly Tests Reported for this release)

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

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

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

height="26">

Compilers<span

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

</td>

</tr>

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

HP-UX<o:p>

PA_RISC and Itanium</o:p>

</td>

HP <span

HP aC++

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

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

</td>

</tr>

<span

Linux

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

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

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

</td>

<span

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

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

</td>

</tr>

<span

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

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

</td>

<span

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

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

</td>

</tr>

Line 1675

Line 1954

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

</td>

<span

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

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

</td>

</tr>

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

Linux IA-32</td>

IA-32</td>

<td style="padding: 0.75pt;"> gcc (versions 3.xx, 4.7) clang(The clang compiler usage

<span

is considered production effective OpenPegasus 2.13.0)<o:p></o:p></td>

style="color: black;">gcc

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

</tr>

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

</td>

<span

gcc (versions 3.xx, 4.7) clang(The clang compiler usage is considered production effective OpenPegasus 2.13.0)

style="color: black;">gcc

(versions 2.9x, 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>

Windows 2000

Platform and

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

</td>

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

</td>

Vista, Windows 7, Windows Server 2008 </td>

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

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

Compilers 2003 - 2010.. Note: Visual C++ Ver. 6 no longer being

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

regular tested.Note that today there are some open issues with

the Windows. </td>

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

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

8</big></td>

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

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

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

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

Alpha</big></td>

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

</td>

</tr>

<tr>

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

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

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

</td>

</tr>

<tr>

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

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

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

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

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

for OpenVMS Alpha</big></td>

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

<td><big> HP OpenVMS 8.3 or later

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

IA64</big></td>

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

<td><big>HP C++ V7.3-023

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

or later required on

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

OpenVMS IA64</big></td>

</td>

</tr>

<tr>

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

color="RED">Solaris 9</big></td>

Windows 2000

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

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

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

<h3>Platform patches </h3>

Platform patches

The following is a list known of

<font

platform patches Pegasus requires.

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

patches Pegasus requires.

<ol>

<li>

<li> RHAS 2.1 needs the update to

fix Red Hat Bugzilla 98815.

<font

</li>

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

<li> RHEL 4.4 multithreading bug in getpwuid-r could cause a CIM

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

Server failure (Bugzilla 6232). This is fixed in RHEL 4.5

<li>

</li>

RHEL 4.4 multithreading bug in

<li> Red Hat and SUSE Linux multiple versions - multithreaded client

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

intermittently fails connecting to IPv6 (Pegasus Bugzilla 6586) (Red

RHEL 4.5</li>

Hat bug 248052)</li>

<li>

<li> OpenSLP Version 2.0 - This release of OpenSLP requires the

Red Hat and SUSE Linux

patches for OpenSLP version 2.0 documented above.</li>

multiple versions -

multithreaded client intermittently fails connecting to IPv6 (Pegasus Bugzilla

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

</ol>

</div>

Further information regarding Pegasus support on IBM platforms can

Further information regarding Pegasus support on IBM platforms can be

found at: <a

found at: <a href="http://publib.boulder.ibm.com/infocenter/eserver/v1r1/en_US/index.htm?info/icmain.htm">http://publib.boulder.ibm.com/infocenter/eserver/v1r1/en_US/index.htm?info/icmain.htm</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>

Further information regarding Pegasus support on HP platforms can be found

Further information regarding Pegasus support on HP platforms can

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

found at:

<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

The OpenPegasus Bugzilla database documents 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

database</a>.

bugzilla database</a>.   Effective with the start of the

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

OpenPegasus 2.6 work, ALL changes to the OpenPegasus CVS tree are

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

documented through bugs. Therefore all source code changes to OpenPegasus

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

are documented through bugs providing a complete history of changes and

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

the reasons for those changes.  Bugs reports are filed not only for

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

bugs and their corresponding fixes but also as part of the process of

(ex. 

committing new code representing the work on PEPs done for OpenPegasus 2.6

and all subsequent versions.  Therefore, a search of the OpenPegasus

2.6.0_APPROVED</a>,

Bugzilla base for bugs with the tag for a particular version (ex.  <a href="http://cvs.rdg.opengroup.org/bugzilla/buglist.cgi?keywords=2.6.0_APPROVED">2.6.0_APPROVED</a>,

2.6.1_APPROVED</a>,

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

<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

etc) will yield all changes to the Pegasus CVS tree for that OpenPegasus

the Pegasus CVS tree for that Pegasus release.

release.

     - Changes for this release (bugs Tagged

     - Changes for Pegasus 2.7.0 release (bugs Tagged

2.13.0_APPROVED). The link is <a href="http://bugzilla.openpegasus.org/buglist.cgi?keywords=2.13.0_APPROVED">

2.7.0_APPROVED) 

Pegasus 2.13.0_APPROVED bug list.</a>

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

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

Control

<h2><a

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

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

The OpenPegasus project is controlled largely through the CVS repository

and a set of documents (PEPs) that serve both as the definition and review

The Pegasus project is controlled largely through a set of documents

mechanism for new and modified Pegasus functionality and for the

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

definition and documentation of releases.

modified Pegasus functionality and for the definition and documentation

of releases.

The following documentation defines the characteristics of this Pegasus

release. The documents are available in the OpenPegasus CVS

Specifically the following PEPs define the characteristics of this

repository.

Pegasus release. These PEPs are available at

<ul>

<li> OpenPegasus Release Definition/Status - (See Wiki Section <a href="https://wiki.opengroup.org/pegasus-wiki/doku.php?id=dev:release:2_12_x">OpenPegasus

OpenPegasus Approved PEPs.</a>

2.13.x

Release Status</a>) - A

section in the Pegasus wiki is used throughout the development of

this version as the control point for functionality that will go

<ol>

into the release and points to all of the PEPs that represent the

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

<li>

OpenPegasus

PEP 296 - OpenPegasus Release Definition - This PEP is used

Build and Configuration Options  for Selected Platforms -  In previous versions of Pegasus this

throughout the development of this version as the control point for

information was  released as a Pegasus PEP. Starting with

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

Pegasus 2.9.0 the information is located in the OpenPegasus CVS

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

repository as <big style="font-weight: bold;"> pegasus/doc/BuildAndReleaseOptions.html</big>.

<li> OpenPegasus External Interfaces -The

list of the OpenPegasus interfaces that are considered external

<li>

and therefore "frozen". Unless an exception is explicitly approved

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

by the Steering Committee all subsequent releases of Pegasus MUST

Options  for Selected

continue to support these interfaces. Interfaces not explicitly

Platforms</li>

listed in this document, should be considered as internal and

subject to change.In previous Pegasus releases this information

<li>

was available as a separate PEP. Starting with Pegasus 2.9.0 this

<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

information is integrated into the Pegasus repositoryas  pegasus/doc/EnternalInterface.html.</li>

interfaces for clients and providers that are considered external and

therefore "frozen".

<li> OpenPegasus  SDK Packaging Definition - Defines

the recommended set of files for inclusion in the OpenPegasus SDK.

</li>

Starting with Pegasus release 2.11.0, this document is available

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

<li>

In previous Pegasus releases this document was made available as s

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

separate Pegasus PEP document rather than in the CVS repository.

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

</li>

<li> Pegasus  Runtime Packaging Definition - Defines

the recommended set of files for inclusion in this OpenPegasus

release. Starting with Pegasus release 2.11.0, this idocument

<li>

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

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

In previous releases this was made available as a seperate Pegasus

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

PEP document rather than in the CVS repository.  </li>

<li>Pegasus Release Notes -

PEP 364 - (This document

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

is located in the approved PEP repository and the OpenPegasus

approved PEP

source tree root directory (<big>pegasus/ReleaseNotes.htm</big>)</li>

repository and the OpenPegasus source tree root directory)

</ul>

</li>

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

</ol>

The following documentation is available for the this Pegasus release:

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

The following documentation is available for the this Pegasus

release:

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

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

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

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

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>

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

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

documentation - See the header files and the HTML

documentation - See the header files and the HTML  API

API documentation that is on the web site. The best API usage

documentation that is on the web site. The best API usage documentation

documentation is the existing utilities and test programs and the

is the existing utilities and test programs and the examples in the API

examples in the API documentation.  In particular the

documentation.  In particular the Common/tests unit tests contain

Common/tests unit tests contain extensive examples of the use of the

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

Common APIs. </li>

<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

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

Technical Workshop which is available on the Pegasus web site.

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

</li>

documentation, and documentation from the Pegasus Technical Workshop

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

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

Clients -API documentation and the documentation on the

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

</li>

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

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

Clients - API documentation and the documentation on the Pegasus

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

<li class="MsoNormal" style="color: black;">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>

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

WIKI - This WIKI is maintained both for the use of the

development team and as a user information resource.  The wiki

can be accessed at <a href="https://wiki.opengroup.org/pegasus-wiki/doku.php?id=start">https://wiki.opengroup.org/pegasus-wiki/doku.php?id=start</a></li>

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

contributor licenses this file to you under the OpenPegasus Open Source

<span

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

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

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

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

copy of this software and associated documentation files (the

style="color: black;">

"Software"), to deal in the Software without restriction, including

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

without limitation the rights to use, copy, modify, merge, publish,

width="100%">

distribute, sublicense, and/or sell copies of the Software, and to

permit persons to whom the Software is furnished to do so, subject to

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

the following conditions:

Open Group; VERITAS Software Corporation; Intel Corp.

The above copyright notice and this permission notice shall be included

in all copies or substantial portions of the Software.

Permission is hereby granted, free of charge, to any

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

person obtaining a copy  of this software and associated

OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

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

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

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

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

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

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

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

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

to do so, subject to the following conditions:

SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION

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

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

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

WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

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

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

</body></html>

Legend:

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

No CVS admin address has been configured