pegasus/ReleaseNotes.htm - diff

Return to ReleaseNotes.htm CVS log

Up to [Pegasus] / pegasus

Diff for /pegasus/ReleaseNotes.htm between version 1.4 and 1.17.4.1

version 1.4, 2005/08/26 16:15:07

version 1.17.4.1, 2011/10/11 18:17:09

Line 1

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

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

<head>

<style>

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

Line 448

margin:1.0in 1.25in 1.0in 1.25in;

mso-header-margin:.5in;

mso-footer-margin:.5in;

mso-paper-source:0;}

div.Section1

{page:Section1;}

Line 569

Line 570

text-indent:-.25in;}

@list l4:level7

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

mso-level-number-position:left;

text-indent:-.25in;}

@list l4:level8

Line 887

Line 889

text-indent:-.25in;}

@list l19

{mso-list-id:1902863286;

mso-list-template-ids:740079056;}

@list l19:level1

{mso-level-number-format:bullet;

Line 959

Line 962

font-size:10.0pt;

font-family:"Times New Roman"}

</style>

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

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

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

<o:smarttagtype

name="City"/>

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

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

<o:smarttagtype

name="place"/>

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

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

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

name="date"/>

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

<o:DocumentProperties>

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

<o:LastAuthor> </o:LastAuthor>

Line 995

Line 996

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

</w:WordDocument>

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

</head>

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

style="color: black;">

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

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

style='color:black'>

width="100%"></div>

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

align="center">Pegasus

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

</div>

<span

style="color: black;">

<span

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

PEP #: 185

PEP #: 359

Title: Release Notes for OpenPegasus 2.4

Title: Release

Notes for OpenPegasus version 2.11.0

Version: 1.4

Created: 23

March 2011

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

Authors: Karl

Schopmeyer

Authors: Karl

Schopmeyer

Status:  draft

Version History:

Status:  draft

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

border="1" cellpadding="0" cellspacing="1" height="155" width="100%">

Version History:

<tbody>

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

<td

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

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

<span

<span

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

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

</td>

<td

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

<span

height="27">

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

<span

</td>

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

</td>

<span

<td

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

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

</td>

height="27">

<span

<span

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

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

</td>

<td

</tr>

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

<span

<span

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

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

</td>

</tr>

<o:p>

23 July 3004</o:p>

<span

</td>

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

</td>

<span

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

<font

</td>

size="2">23 March 2011

</td>

Initial

Submission<o:p> (Incomplete)</o:p>

<span

</td>

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

</tr>

</td>

<span

1.1</td>

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

Submission <o:p><font

26 August 2004</td>

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

</td>

KS</td>

</tr>

<tr>

Incorporate comments from 1.0</td>

</tr>

1.2</td>

</tr>

6  October 2004</td>

KS</td>

Incorporate comments from Review of 1.1</td>

</tr>

<tr>

1.3</td>

24 October 2004</td>

</tr>

KS</td>

Update with comments from Version 1.2</td>

</tr>

1.4</td>

1 November 2004</td>

KS</td>

Comments from 1.3</td>

</tr>

</tbody>

</table>

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

<o:p> </o:p>

style="color: black;">

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

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

width="100%"></div>

style='color:black'>

Abstract: This document defines the release notes for the

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

to summarize the characteristics of this release, point to other

</div>

documentation that defines the release in more detail, and provide

additional information about this release that is not available in the

Abstract: This document defines the release notes that support

other Pegasus documentation.

release 2.4 of the Pegasus platform. <span

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

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

style="color: black;">

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

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

target="_self">

width="100%"></div>

</a>

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

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

style='color:black'>

</div>

<o:p> Contents</o:p>

<ol>

<li><a href="#Availability of this Release">Availability of this Release</a></li>

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

<li><a href="#Functionality of This Release">Functionality of This Release</a></li>

Release</a></li>

<li><a href="#Relationship to CIM/WBEM Standards">Relationship to CIM/WBEM

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

Standards</a></li>

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

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

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

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

Considerations</a></li>

Specifications</a></li>

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

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

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

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

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

<li>

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

with DMTF Specifications</a></li>

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

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

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

<li> <a

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

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

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

Documentation</a></li>

</ol>

<h2>Availability

<h2><a name="Availability of this Release">Availability of this Release</a></h2>

of this Release</h2>

This release is available in a number of forms including:

<ul>

<li>source release in both ZIP and TAR formats. These can be downloaded from the OpenPegasus Web

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

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

These can be

<li>OpenPegasus 2.4 binaries are available for Red Hat Enterprise Linux 3.0 and

downloaded from the OpenPegasus Web

SUSE LINUX Enterprise Server 9.0. A Source RPM is also available that can be

site at <a

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

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

versions.</li>

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

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

A source RPM is  available on the

release and subsequent snapshots that are made available in the Pegasus CVS are

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

defined on the

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

OpenPegasus CVS repository web page (see the

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

<a href="http://www.openpegasus.org/cvs.tpl?CALLER=page.tpl">OpenPegasus CVS

release and

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

subsequent snapshots that are made available in the Pegasus CVS are

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

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

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

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

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

snapshots page</a>.</li>

</ul>

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

The instructions for acquiring the released code are on the

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

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

WEB site</a>.

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

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

Pegasus source

tree.

<a name="comtag_59">Instructions for building the Linux

RPMs: </a>

<ol>

<li><a name="comtag_59">Download tog-pegasus-2.4.0-1.src.rpm.

</a></li>

<li><a name="comtag_59">rpm -ih tog-pegasus-2.4.0-1.src.rpm

</a></li>

<li>

<a name="comtag_59">Build the rpms</a>:

<a name="comtag_59">For RHEL3 - rpmbuild -bb /usr/src/redhat/SPECS/tog-pegasus- 2.4.0-1.spec </a>

<a name="comtag_59">For SLES9 - rpmbuild -bb /usr/src/packages/SPECS/tog-pegasus- 2.4.0-1.spec </a></li>

<li><a name="comtag_59">After the build the rpms will be in

the following locations: </a>

<a name="comtag_59">For RHEL3 - /usr/src/redhat/RPMS/[arch]/tog-pegasus-

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

<a name="comtag_59">For SLES9 - /usr/src/packages/RPMS/[arch]/tog-pegasus- 2.4.0-1.[arch].rpm /usr/src/packages/RPMS/[arch]/tog-pegasus-sdk-

2.4.01-.[arch].rpm</a>.</li>

</ol>

<h2><a name="Functionality of This Release">Functionality of This Release</a></h2>

The overall level of functionality in the Pegasus environment effective with

this release is as follows:

<h3>CIM Server Functionality</h3>

The following paragraphs list the functions in this release.  All

functions are considered community tested and operational unless specifically

noted below. Features that are marked alpha or beta are not generally of the

quality or completeness for production usage.  Interfaces that are

part of the Pegasus public interface definitions but that the Pegasus team feels

may change are marked experimental. In many cases these features  and

interfaces are conditionally compiled with special environment variables. PEP

174 provides more detailed information on how to enable functionality that is

conditionally compiled in this release.

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

<ol>

<li>Class Operations (getClass, <span

class=SpellE>deleteClass, modifyClass, <span

class=SpellE>enumerateClass, enumerateClassNames)</li>

<li>Qualifier Operations (getQualifier, setQualifier, deleteQualifier) </li>

<li>Instance Operations (getInstance, <span

class=SpellE>deleteInstance, modifyInstance,

enumerateInstance, enumerateInstanceNames,

getProperty, setProperty)</li>

<li>Association Operations (references, referencenames,

associators, associatornames)</li>

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

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

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

alpha quality because it has only been contributor tested and there is no test

in the test suite to confirm the functionality.</li>

</ol>

</blockquote>

</div>

<h2>OpenPegasus Functionality for This

Release</h2>

<h4>Indications</h4>

Pegasus overall status by release is defined by  a

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

Process indications are operational in the Server.  This includes support

WEB Page</a>

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

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

indications and the CIMXML indication handler.

shows the

Pegasus users and developers the status of the various features found

<h4>Indication Listener</h4>

in Pegasus

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

The generic components for a CIM

description of

Listener and a listener API are operational.  This includes the functions

each feature.

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

Pegasus 2.11.0

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

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

indication listener in the Pegasus server.

areas as described in the Pegasus  PEP defining this release

.

</blockquote>

The major areas of development 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

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

<font

<h4>Query Language</h4>

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

Changes for this Release

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

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

filters and in 2.4 for execQuery.  The execQuery support  for WQL has

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

been implemented in Pegasus 2.4 but is considered alpha quality.

<tbody>

<h4>Class Repository</h4>

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

Pegasus uses an XML based file/directory class repository. All class and qualifier operations

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

access this repository. The repository was modified to improve efficiency in 2.4

Version</th>

by adding a binary repository option to reduce repository size. The binary

</tr>

repository functions are considered alpha level because they have only been

contributor tested and there is no test function in the automated Pegasus test

suite.

<h4>Instance Repository</h4>

Pegasus uses an XML based file/directory Instance repository.  The

instance  repository may be conditionally used as the default repository

with a Pegasus configuration flag ( As defined in PEP 174, it is normally set 

to NOT use the instance repository as default).

<h4>Server Security</h4>

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

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

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

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

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

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

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

supported by OpenSSL.  Minimum level known

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

with 0.9.6k.  See <a

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

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

</ol>

<h4> Platform Management Functions</h4>

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

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

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

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

list .5in'>Daemon/service operation of the Pegasus CIM Server on all supported platforms<o:p>.</o:p></li>

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

list .5in'>Operation statistics capture using the CIMStatistics classes in

the DMTF Interop model. This function is considered alpha quality and conditionally compiled.  The

default is that this function is not compiled.</li>

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

list .5in'>Multiple pluggable provider managers.  Provider managers are provided for the Pegasus C++ provider interface, the CMPI C provider interface

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

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

list .5in'>Platform Globalization - Pegasus includes support for unicode

data transfers and includes a mechanism for message support in mulitple

languages using the open source ICU libraries (<a href="http://oss.software.ibm.com/icu/">http://oss.software.ibm.com/icu/</a>). Note that this is still marked

experimental.</li>

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

list .5in'>Out-of-process providers (Experimental) - See PEP 072 for more information on

use of this feature </li>

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

list .5in'>Shared class namespaces (Experimental) - See PEP 129 for more information on

use of this feature</li>

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

list .5in'>Remote providers for the CMPI provider interface (Experimental)

- See PEP 130

for more information on use of this feature</li>

</ol>

<h4>SLP Discovery</h4>

SLP support is included but is conditionally compiled with the default.  This code can be enabled by setting the compile

environment variable PEGASUS_ENABLE_SLP.   Once compiled, SLP support

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

an SLP service agent in the Pegasus CIM severas and generates SLP advertisements compatible with the DMTF

slp template specification. The SLP support also includes  extensions to the CIM

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

(note that these interfaces are not yet part of the Pegasus public SDK).

<h4>Provider Managers</h4>

Pegasus is designed to support multiple Provider Managers to allow multiple

provider interfaces to the CIMOM.  The default provider manager is the C++

Interface.  This section defines the additional provider managers available

with Pegasus 2.4.

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

Pegasus 2.4 includes a provider manager for the CMPI C interfaces.

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

class=GramE>see� <a

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

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

which is in review now within the WBEMSource

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

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

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

providers.

Today, the CMPI provider manager and interfaces are considered experimental

and are subject to change in future versions of Pegasus  until the CMPI

specification is released. Information on writing providers with the CMPI

interface is available in the draft version of the specification today (see

above) and in the following documents (<a href="http://www-124.ibm.com/sblim/doc/CMPIandC++.pdf">http://www-124.ibm.com/sblim/doc/ProviderArchitecture.pdf

</a>and <a href="http://www-124.ibm.com/sblim/doc/CMPIandC++.pdf">

http://www-124.ibm.com/sblim/doc/CMPIandC++.pdf</a>) and readme.cmpi in the

Pegasus source root directory.

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

Pegasus includes an experimental provider manager for Java provider

interfaces based on the SNIA provider interface definitions.  This provider

manager is  considered alpha quality and is not compiled in the default build.  

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

</blockquote>

<h3>Providers</h3>

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

This includes providers in the following categories:

<h4>Pegasus Internal Providers</h4>

Pegasus provides a set of "internal" providers that have direct access to the

CIMOM for information and provide information and services to support the CIMOM

and its administration.    The providers in this category are mostly defined in the directory src/pegasus/controlproviders

and include support for the following classes:

<ul>

<li>DMTF Interop classes including __Namespace,  <span

class=SpellE>CIM_Namespace, CIM_ObjectManager,

CIM_CommunicationMechanism, and CIMOMStatistics.</li>

</ul>

<h4>Generic Providers</h4>

Generic OperatingSystem provider. See the

directory src/Providers/generic.

<h4>Test/Sample Providers</h4>

See the directories src/Providers/TestProviders

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

sample providers.

<h4>Managed System Providers</h4>

ComputerSystem, DNSAdmin,

DNSService, Operating System, Process, Processor. For

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

the directory src/Providers/ManagedSystem

<h4>SLP Provider</h4>

This provider acts as the definer of  SLP

information for SLP registration and also controls the Pegasus SLP Service

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

it does not use internal functions of the CIMOM to generate any of its

information today. (conditionally compiled today)

</blockquote>

<h3>CIM_Schema</h3>

The default CIM_Schema loaded with this release is

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

local classes defined for Pegasus.  These are defined in the pegasus/Schemas

directory.   CIM 2.9 preliminary

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

There are also a number of older schema available in the CVS.

The mechanism to install other schemas than the default is

defined in the mak/config.mak

NOTE: The CIM 2.5 schema is maintained in the

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

environment.

<h3>Pegasus MOF Compilers</h3>

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

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

repository (cimmofl).

The direct interface compiler is used primarily to provide an initial

class/instance repository. WARNING:

the use of cimmofl

to manipulate instances in the repository bypasses any provider that is

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

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

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

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

stopped and restarted in some cases.  Use of cimmofl in

general is discouraged and particularly  to manipulate

instances served by a registered providers (ex.

Provider registration). Use of <span

class=SpellE>cimmof rather that cimmofl is encouraged

wherever possible.

<h3>Client Tools</h3>

<h4>   Pegasus CIM Server Adminstration</h4>

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

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

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

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

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

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

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

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

authorization characteristics. Today this is authorizing users to

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

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

list .5in'>cimprovider - Manage information

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

</ol>

<h4>Information client tools</h4>

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

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

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

instance information from the Pegasus repository in MOF or XML format.<o:p></o:p></li>

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

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

information on the Domain Name System (DNS)

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

on the information available from providers and differs from system to

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

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

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

information from the Network Schema.  Information generated varies by

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

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

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

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

information generated is dependent on the information available from

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

</ol>

<h4>Test support Tools</h4>

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

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

option on the Pegasus make files) these tests are defined throughout the

Pegasus source tree typically in "tests" directories.       

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

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

list .5in'>The Pegasus test suite (see the pegasus/tests directory and the

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

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

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

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

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

list .5in'>wbemexec - Test tool that

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

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

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

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

list .5in'>Benchmark Test - A benchmark test

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

See src/clients/benchmarkTest for more

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

</ol>

<h3>Pegasus Interface APIs</h3>

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

189

available from the web site(<a

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

That document is the authorative source for the list

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

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

release of Pegasus 2.1 are forward compatible to this release. Well-behaved

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

compatible with this release without compilation.  There have been

extensions and new interfaces added for this release and these are marked as

experimental.   The Pegasus public

interfaces includes the following major functions

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

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

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

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

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

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

</ol>

In addition, there are other client interfaces which are not today in the

public SDK including:

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

list .5in'>CIM Listener APIs</li>

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

list .5in'>SLP Client (User Agent) APIs which are

extensions to the Client APIs</li>

</ol>

<o:p> </o:p>

The APIs are documented in

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

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

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

<h3>WMI Mapper</h3>

The WBEM to WMI Mapper provides a way to access

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

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

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

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

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

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

authenticates these credentials, verifying if the provided credentials have

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

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

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

WMI Mapper impersonates the user credentials provided

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

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

contain user credentials.

<h2><a name="Relationship to CIM/WBEM Standards">Relationship to CIM/WBEM

Standards</a></h2>

Pegasus was designed and implemented to comply with the DMTF specifications The following table defines the

level of the DMTF specifications which which Pegasus conforms today.

<tr>

<td width="33%" bgcolor="#00FFFF">DMTF Specification</td>

<td width="33%" bgcolor="#00FFFF">Specification Version</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>

</tr>

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

<td width="128"> <a

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

</td>

</tr>

<tr>

<td width="33%">DSP 0004 CIM Specification</td>

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

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

Indication Handler</td>

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

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

</tr>

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

</td>

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

Implementation, stage 2

</td>

<td width="128"><a

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

</tr>

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

</td>

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

style="">Improve the

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>

</tr>

<tr>

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

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

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

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

</td>

<td>Add External SLP support to release builds

</td>

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

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

</a></td>

</tr>

<tr>

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

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

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

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

</a></td>

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

PEGASUS_USE_RELEASE_CONFIG_OPTIONS build option to have true/false

values

</td>

</td>

</tr>

<tr>

<td width="33%">DSP 0205 - WBEM Discovery using SLP</td>

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

<td width="33%">1.0, preliminary, 27 January 2004</td>

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

8806</a></td>

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

</tr>

<tr>

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

<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 width="33%">CIM Schema </td>

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

<td width="33%">2.8 Final, June 2004</td>

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

8839</a></td>

<td>OOP Provider recovery enhancement</td>

</tr>

</table>

<tr>

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

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

8845</a></td>

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

Each Pegasus release lists as supported platforms those

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

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

</td>

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

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

</tr>

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

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

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

operation. The supported platforms for this Pegasus release are:

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

</a> </td>

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

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

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

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

to include enumeration association filters</td>

Platform and OS<span

</td>

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

</tr>

</td>

Compilers<span

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

<td width="128"><a

</td>

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

</a></td>

</tr>

</tbody>

</table>

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

The status of several components of Pegasus functionality change

</td>

status

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

HP aC++

that

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

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

</td>

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>

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

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

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

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

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

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

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

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

Listener components. For more information on IPv6 support for your

specific platform, refer to the documentation for that platform.

All OpenPegasus externals that

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

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

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

address must be specified without brackets. For example, the

OpenPegasus osinfo client (which returns information about the OS

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

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><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; font-family: monospace;"><big>cimcli ns

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

or

<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 href="http://www.ietf.org/rfc/rfc2373.txt">IETF

RFC 2373 - IP Version

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

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:

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.

To check whether your current

running

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

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

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

bug 6586</a>

and

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

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 ipv6.exe

tool to install, uninstall, and

query

your IPv6 configuration. For example:

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

Note that the OpenPegasus IPv6 support has not yet been tested

on Windows Vista or Windows Server 2008.

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

color="#000000">IPv6

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

<h4>Testing your OpenPegasus IPv6

support</h4>

As part of the OpenPegasus

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:

<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

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 a minor version upgrade of OpenPegasus.

However, there

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

that

significantly affects interoperability) that may require the Community

to make

potentially incompatible changes. The following table contains a list

of defect

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

Clients when

upgrading to this OpenPegasus release.

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

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

<tbody>

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

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

</tr>

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

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

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

on performance the CIMInstance::filter() and

CMPIInstanceFT.setPropertyFilter() functions have been changed to a

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

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

allow users to actually filter properties from an instance, new

function CIMInstance::filterInstance() will actually filter properties

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

versions of Pegasus.</td>

</tr>

</tr>

</tr>

</tr>

</tr>

</tbody>

</table>

PowerLinux<span

<h2>OpenPegasus Relationship to

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

CIM/WBEM Standards</h2>

</td>

Pegasus was designed and implemented to comply with the DMTF

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

gcc<span

DMTF specifications to which this version of Pegasus aims to conform

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

today.

</td>

<tbody>

<tr>

<td bgcolor="#00ffff" width="33%">DMTF Specification</td>

<td bgcolor="#00ffff" width="33%">Specification Version</td>

</tr>

<tr>

<td width="33%">DSP 0004 - CIM Infrastructure Specification</td>

zLinux<span

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

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

</td>

gcc<span

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

</td>

</tr>

<tr>

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

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

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

</td>

gcc<span

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

</td>

</tr>

<tr>

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

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

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

</td>

gcc<span

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

</td>

</tr>

<tr>

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

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

<td width="33%">1.0.0, preliminary, 9 December 2004</td>

</td>

Microsoft

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

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

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

</td>

</tr>

<tr>

<td width="33%">DSP 0205 - WBEM Discovery using SLP</td>

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

<td width="33%">1.0, preliminary, 27 January 2004</td>

</td>

Microsoft

Visual C++ Ver. 6 and Microsoft .Net compiler Version 7.1<span lang=NL style='color:black;mso-ansi-language:

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

</td>

</tr>

<tr>

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

Sun Solaris 9</td>

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

Sun workshop 6, update 2</td>

</tr>

<tr>

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

MacOS version 10.2 and higher</td>

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

gcc 3.3</td>

</tr>

</tbody>

</table>

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

Exceptions to

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

DMTF Specifications</a></h2>

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

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

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

<o:p> </o:p>

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

It is a major goal

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

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

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

<li>Provider Registration - Pegasus supports registration

Pegasus Provider registration classes rather than support the DMTF defined Provider

through a set of Pegasus Provider registration classes rather than

Qualifier. Pegasus will not support this qualifier in the future. See the readme for more information on provider registration.</li>

support the DMTF defined Provider Qualifier. Pegasus will not support

<li> Indications -Today Pegasus supports process indications but does not

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

include any specific support for lifecycle indications.</li>

provider registration.  This is not a deviation from the

specifications but is a different method of registration than many CIM

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

<li>Indications -Today Pegasus supports process

indications and lifecycle indications when defined specifically by

providers. Pegasus does not support lifecycle indications if they are

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

color="#ff0000">  For

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

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

size="2">.</li>

<li>

<font

Instance qualifiers and class

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

qualifiers on some Operations -

option on Instance Operations

The DMTF specifications are unclear regarding the inclusion of qualifiers on

CIM instances.  Some CIM Client implementations expect instances returned

The DMTF specifications have deprecated the use of qualifiers on

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

instance operations with the 1.2 CIM Operations Specification and

(such as KEY qualifiers on properties).   Pegasus today expects the provider to complete the qualifiers on instances in

stated specifically that the client should NOT depend on the

accordance with the specification and generally the interpretation is that

includeQualifiers parameter of the CIM/XML instance operations

Pegasus applies class level qualifiers when the includeInstance parameter is

returning qualifiers. 

supplied on instance operations.  However, Pegasus today is inconsistent in

Some CIM Client implementations expect instances

the return of qualifiers so that the user should NOT depend on Pegasus

returned

accurately honoring the includeQualifier parameter for instance operations. 

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

In the future it is expected that Pegasus will deprecate the use of qualifiers

definition (such as KEY qualifiers on properties).   Pegasus

on instance operations completely.

today expects the provider to complete the qualifiers on instances in

accordance with the specification and generally the interpretation is

that Pegasus applies class level qualifiers when the includeInstance

parameter is supplied on instance operations.  However, Pegasus

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

should NOT depend on Pegasus accurately honoring the includeQualifier

parameter for instance operations.  In the future it is expected

that Pegasus will deprecate the use of qualifiers on instance

operations completely.  When Pegasus uses object normalization,

the normalizer does apply qualifiers to returned instances if the

includeQualifiers operation parameter is set.

</li>

<li>LocalOnly option on instance

Operations - With the 1.1 version of Specification for CIM

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

GetInstance and Enumerate Instances operations was modified. This

change

was incorrect, resulted in reduced functionality and introduced a

number of backward compatibility issues. As a result of issues

introduced by this change, we strongly recommend that CIM Clients set

LocalOnly = false and do not rely on the use of this parameter to

filter the set of set of properties returned. See Appendix C of this

specification for more information.</li>

<li>

MultiRequest Operations - Pegasus

CIM MOF compiler function for instance aliasing - The

does not support the DMTF defined MultiRequest Operation option.

Pegasus MOF compiler does not today support this function.  This function is

planned for a future version.

</li>

<li>

MultiRequest Oprations - Pegasus does not support the DMTF defined MultiRequest

Operation option.

</li>

<li>

LocalOnly option on some instance Operations -

With the 1.1 version of Specification for CIM Operations over HTTP, the

definition of the LocalOnly parameter for the GetInstance and EnumerateInstances

operations was modified. This change was incorrect, resulted in reduced

functionality and introduced a number of backward compatibility issues. As a

result of issues introduced by this change, we strongly recommend that CIM

Clients set LocalOnly = false and do not rely on the use of this parameter to

filter the set of set of properties returned.

</li>

<li>

MOF Compiler namespace pragma - The

MOFCompiler namespace pragma - The Pegasus compiler does not support the namespace pragma.

Pegasus compiler does not support the namespace pragma.

</li>

<li>CIMOperation Trailer - Pegasus implements

chunking

based on the DSP0200 1.2.0 preliminary spec. including the operation

trailer defined in that specification Refer to bug <a

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

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

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

is used Pegasus is returning a noncompliant response to enumerate type

requests. </li>

<li>Whitespace in XML value Element

- Pegasus trims the leading and trailing whitespace from XML value

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

in Pegasus bug <a

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

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

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

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

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

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

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

<li>modifyInstance operation

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

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

all properties rather than just the properties supplied with the

request thereby Nulling out existing values. See bug <a

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

for more information.</li>

</ol>

<h2>OpenPegasus <a

<h2><a name="Changes in This Release">Changes in This Release</a></h2>

name="Supported Platforms">Supported

Platforms</a></h2>

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

Each OpenPegasus release lists as 'active' platforms

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

those

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

hardware/software platforms that have recognized ports for the Pegasus

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

code base

functionality was completed for this release.

including a maintainer for the platform that will be willing to

regularly

In general, the areas of development for this release were:

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

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

a group

list .5in'>

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

Expansion of platform globalization.</li>

Pegasus

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

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

list .5in'>

it is the

Expansion of SLP support (still

responsibility of the entity that packages and/or compiles OpenPegasus

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

for

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

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

list .5in'>

bugzilla

Inclusion of the Pluggable Provider   manager

database for a list of relevant defects that affect their

(Providermanager2)as the default provider manager. Note that the original

platform.  

provider manager will NOT be supported in the future.</li>

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

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

below. 

list .5in'>

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

Inclusion of Pluggable

regular

CMPI provider manager and the JMPI provider.  </li>

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

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

platforms

list .5in'>

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

Inclusion of the out-of-process

the time

provider mechanism and the remote provider mechanism for CMPI. (Experimental)</li>

of the release are reported in the second table.

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

Actively Supported Platforms (Nightly Tests Reported for this

list .5in'>

release)

Addition of the binary repository

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

option. (Experimental)</li>

cellpadding="0" cellspacing="1">

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

<tbody>

list .5in'>

Addition of the shared namespace

<td

concept so that class and qualifier definitions can be shared between multiple

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

namespaces. (Experimental)</li>

height="26">

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

Platform and

list .5in'>

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

Refactoring of the HTTP monitor.</li>

</td>

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

<td

list .5in'>

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

Addition of HTTP chunking.

height="26">

Note that the internal segmenentation of operation responses allowing better control of memory within

Compilers<span

the cimom is planned for the future.</li>

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

</ol>

</td>

</tr>

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

HP-UX<o:p>

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

PA_RISC and Itanium</o:p>

</td>

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

HP <span

list .5in'>Complete move to segmented operation responses and positive control of memory

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

for operations.   The chunking code has been incorporated and the

</td>

Pegasus client and the Server HTTP components handle chunking.  The

</tr>

components necessary to segment operation responses from the providers was not

completed and will be included in a future version.</li>

</ol>

<span

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

The complete set of PEPs defined for this release is

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

defined in PEP 97.

</td>

<h2><a name="PEGASUS Bugs">PEGASUS Bugs</a></h2>

<span

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

The current bug list for Pegasus is openly available on the

</td>

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

</tr>

site</a>.  As of the release of 2.4 release date, the following list represents

what the Pegasus community feels are a subset of  open bugs with

OpenPegasus 2.4 that may be of particular interest to users. Please see the bug reports

<span

(the number is a link to the report) to determine if there are any workarounds,

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

patches, etc. for particular bugs.

</td>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=730

<span

style='width:437.95pt;mso-cellspacing:0in;mso-padding-alt:2.4pt 2.4pt 2.4pt 2.4pt'>

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

</td>

</tr>

<span

style='mso-fareast-font-family:"Times New Roman"'><a

href="buglist.cgi?short_desc_type=allwordssubstr&short_desc=&product=Pegasus+CLI+Commands&product=PegasusCIMOM&product=PegasusClient&product=PegasusCompiler&product=PegasusGeneral&product=PegasusJavaCIMClient&product=PegasusProvider&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=VERIFIED&priority=P1&priority=P2&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&newqueryname=&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.bug_id">ID</a>

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

<o:p></o:p>

</td>

<span

<span

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

style='mso-fareast-font-family:"Times New Roman"'><a

</td>

</tr>

class=SpellE>Sev</a> <o:p></o:p>

</td>

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

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

<span

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

style='mso-fareast-font-family:"Times New Roman"'><a

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

style="color: black;">

class=SpellE>Pri</a> <o:p></o:p>

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

</td>

</tr>

<span

style='mso-fareast-font-family:"Times New Roman"'><a

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

</td>

class=SpellE>Plt</a> <o:p></o:p>

</td>

<span

style="color: black;">gcc

<span

(versions 3.xx, 4.xx)

style='mso-fareast-font-family:"Times New Roman"'><a

<o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=14">14</a> <o:p></o:p>

</td>

nor

<o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

All

<o:p></o:p>

</td>

MOF

Compiler does not support aliasing <o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=377">377</a> <o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>enh<span style='mso-fareast-font-family:

"Times New Roman"'> <o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

PC

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>Multirequest operations<span style='mso-fareast-font-family:

"Times New Roman"'> not supported <o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=424">424</a> <o:p></o:p>

</td>

nor

<o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

All

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>XMLParser<span style='mso-fareast-font-family:

"Times New Roman"'> removes whitespace <o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=482">482</a> <o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>maj<span style='mso-fareast-font-family:

"Times New Roman"'> <o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

PC

<o:p></o:p>

</td>

Absence

of REFERENCECLASSNAME in XML causes error <o:p></o:p>

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=786">786</a> <o:p></o:p>

</td>

nor

<o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

PC

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>CIMRepository<span style='mso-fareast-font-family:

"Times New Roman"'> enumerateinstances <span

class=SpellE>deepInheritance, etc. procesing

</td>

</tr>

<a

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=1195">1195</a> <o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>maj<span style='mso-fareast-font-family:

"Times New Roman"'> <o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

All

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>ResponseHandler<span style='mso-fareast-font-family:

"Times New Roman"'> should clone CIM* objects before modifying

them

</td>

</tr>

<tr>

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

z/OS Version 1.7 and up</td>

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=1285" style="color: blue; text-decoration: underline; text-underline: single">1285</a> <o:p></o:p>

</tr>

</td>

</tbody>

</table>

nor

<o:p></o:p>

Platforms not Actively supported for this release

</td>

(No

current Nightly Build Test Results

P2

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

<o:p></o:p>

cellpadding="0" cellspacing="1">

</td>

<tbody>

PC

<td

<o:p></o:p>

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

</td>

height="26">

Platform and

<span style='mso-fareast-font-family:

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

"Times New Roman"'>EnumerateInstanceNames<span

</td>

style='mso-fareast-font-family:"Times New Roman"'> generates namespace error <span

<td

class=SpellE>CIMException

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>

</tr>

<tr>

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

href="http://cvs.rdg.opengroup.org/bugzilla/show_bug.cgi?id=1307" style="color: blue; text-decoration: underline; text-underline: single">1307</a> <o:p></o:p>

</td>

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

<span style='mso-fareast-font-family:

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

"Times New Roman"'>maj<span style='mso-fareast-font-family:

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

"Times New Roman"'> <o:p></o:p>

</tr>

</td>

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

P2

and higher</td>

<o:p></o:p>

</td>

All

<o:p></o:p>

</td>

Functionality on errors with Enumerate Functions. Should we

generate error or send existing data. Today we pass data.

</td>

</tr>

</td>

</td>

</td>

</td>

</td>

</tr>

</table>

<tr>

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

<span style='mso-fareast-font-family:"Times New Roman";

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

display:none;mso-hide:all'><o:p> </o:p>

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

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

<h2><a name="Bugs Corrected in This Release">Bugs

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

Corrected in This Release</a>

</h2>

The current bug list for Pegasus is openly available on the

<a href="http://cvs.rdg.opengroup.org/bugzilla/">OpenPegasus web site bug

database</a>.  The database can be searched for bugs fixed based on date

and Pegasus version.

Specifically the following Bugs which were listed in the release notes for

Pegasus 2.3.2 have been fixed.

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=730

style='width:437.95pt;mso-cellspacing:0in;mso-padding-alt:2.4pt 2.4pt 2.4pt 2.4pt'>

<span

style='mso-fareast-font-family:"Times New Roman"'>

<o:p></o:p>

</td>

<span

style='mso-fareast-font-family:"Times New Roman"'>

class=SpellE>Sev</a> <o:p></o:p>

</td>

<span

style='mso-fareast-font-family:"Times New Roman"'>

class=SpellE>Pri</a> <o:p></o:p>

</td>

</tr>

<span

<tr>

style='mso-fareast-font-family:"Times New Roman"'>

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

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

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

class=SpellE>Plt</a> <o:p></o:p>

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

</td>

</tr>

<span

<tr>

style='mso-fareast-font-family:"Times New Roman"'>

<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

<o:p></o:p>

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

544</a>

</td>

maj

</td>

P2

<o:p></o:p>

</td>

All

<o:p></o:p>

</td>

MOF compiler does not convert escape characters

</td>

</tr>

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

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>enh<span style='mso-fareast-font-family:

"Times New Roman"'> <o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

PC

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>cimserver stop responding after stress query of repository <o:p></o:p>

</td>

</tr>

nor</td>

P2</td>

All</td>

Sample providers should not be declared in Pegasus namespace</td>

</tr>

nor</td>

nor</td>

PC</td>

MOF compiler does not handle "/* ... */" comments.</td>

</tr>

</td>

maj

<o:p></o:p>

</td>

P2

<o:p></o:p>

</td>

All

<o:p></o:p>

</td>

<span style='mso-fareast-font-family:

"Times New Roman"'>Disabling https prevents indication delivery through http. <o:p></o:p>

</td>

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

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

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

</tr>

<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

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

<font

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

The Pegasus project is controlled largely through a set of documents (PEPs)

patches Pegasus requires.

that serve as the definition and review mechanism for new and modified Pegasus

functionality and for the definition and documentation of releases.

Specifically the following PEPs define the characteristics of this Pegasus

release.

<ol>

<li>PEP 189 - OpenPegaus 2.4 External Interfaces</li>

<li>

<li>PEP 188 - OpenPegaus 2.4 Packaging Definition for Selected Platforms</li>

<font

<li>PEP 185 - Pegasus 2.4 Release Notes (This document)</li>

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

<li>PEP 181 - OpenPegasus 2.4 SDK Packaging Definition</li>

2.1 needs the update to fix Red Hat Bugzilla 98815.

<li>PEP 175 - Pegasus readme.txt for 2.4 (also in the Pegasus source tree root

</li>

directory).</li>

<li>

<li>PEP 97 - OpenPegasus Release Definition - This PEP is used throughout the

RHEL 4.4

development of this version as the control point for functionality that will

multithreading bug in

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

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

2.4 functionality changes.</li>

fixed in

RHEL 4.5

</li>

<li>

Red Hat and SUSE

Linux multiple versions -

multithreaded client intermittently fails connecting to IPv6 (Pegasus

Bugzilla

6586) (Red Hat bug 248052)

</li>

</ol>

</div>

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

Further information regarding Pegasus support on IBM platforms can

The following documentation is available for the this Pegasus release:

found at: <a

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

style="text-decoration: underline; color: rgb(51, 51, 255);">http://publib.boulder.ibm.com/infocenter/eserver/v1r1/en_US/index.htm?info/icmain.htm</a>

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

list .5in'>Utilities - A combination of help generally available with the

Further information regarding Pegasus support on HP platforms can

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

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

found at:

list .5in'>API and  usage documentation - See the header files and the

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

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

<h2><a name="PEGASUS Bugs">Pegasus Defects</a></h2>

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

The Pegasus bugzilla database documents any defects found in Pegasus

documentation.  In particular the

and  is available through the following link:  <a

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

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

Common APIs.</li>

database</a>.

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

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

list .5in'>Building and Debugging Providers - Readme.html in the Pegasus Root

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

Directory, API documentation, and documentation from the Pegasus Technical

only for bugs and

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

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

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

new code

list .5in'>Building and Debugging Clients - API documentation and the

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

documentation on the Pegasus Technical Workshop which is available on the

versions.  Therefore, a search of

Pegasus web site.</li>

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

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

version

list .5in'>Compiler operation and commands - compiler help (cimmofl

(ex. 

-h)</li>

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

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

list .5in'>PEPs - The features of Pegasus that have been installed

in this and the previous few versions are defined by Pegasus PEPs that are

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

available on the OpenPegasus web site.  While these are the original

2.6.1_APPROVED</a>,

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

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

design and implementation of these features.</li>

etc) will yield all changes to

</ul>

the Pegasus CVS tree for that Pegasus release.

<o:p></o:p>

     - Changes for this release (bugs Tagged

2.11.0_APPROVED). The link is <a

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

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

style='color:black'>

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>

</div>

The Pegasus project is controlled largely through the CVS repository

and a set of documents

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

Development Company, L.P.; IBM Corp.; The Open Group; VERITAS Software

and

Corporation

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

repository.

Permission is hereby granted, free of

<ul>

charge, to any person obtaining a copy  of this software and associated

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

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

Section <a

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

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

merge, publish, distribute, sublicense, and/or sell copies of the Software, and

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

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

section in the Pegasus wiki is used

following conditions:

throughout the development of this version as the control point for

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

THE ABOVE COPYRIGHT NOTICE AND THIS

PEPs that represent the Pegasus  functionality changes for this

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

version of Pegasus. </li>

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

OpenPegasus

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

Build and Configuration

WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

Options  for Selected

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

Platforms -  In previous

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

versions of Pegasus this information was  released as a Pegasus

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

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

THE USE OR OTHER DEALINGS IN THE SOFTWARE.

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

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

<li> OpenPegasus External Interfaces -<span

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

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

exception is explicitly approved by the Steering Committee all

subsequent releases of Pegasus MUST continue to support these

interfaces. Interfaces not explicitly listed in this document, should

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

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

style="font-weight: normal;">.</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

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

previous Pegasus releases this document was made available as s

separate Pegasus PEP document rather than in the CVS repository.

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

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

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

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

documentation - </li>

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

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

Providers - </li>

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 class="MsoNormal"

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

Clients - </li>

API documentation and the documentation on the Pegasus

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

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

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.

</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 License; you may not use this file except in compliance with the

License.

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

obtaining a

copy of this software and associated documentation files (the

"Software"),

to deal in the Software without restriction, including without

limitation

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

sublicense,

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

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

The above copyright notice and this 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>

</body>

</html>

Legend:

Removed from v.1.4
changed lines
	Added in v.1.17.4.1

No CVS admin address has been configured