Pegasus Enhancement Proposal (PEP)

PEP #: 083

Title: Release Notes, Pegasus 2.2

Version: 1.4

Created: 6 June 2003

Authors: Karl Schopmeyer

Status: Accepted

Version History:

Version | Date | Author | Change Description
--- | --- | --- | ---
1.0 | 6 June 2003 |  | Initial Submission
1.1 | 10 June 2003 | K. Schopmeyer | Expand and incorporate comments received for first version
1.2 | 11 June 2003 | K. Schopmeyer | Corrections from Discussion 10 June Architecture Team Telecon
1.3 | 17 June 2003 | K. Schopmeyer | Corrections from Telecon 13 June and comments on previous version.
1.4 | 18 June 2003 | K. Schopmeyer | Minor Corrections. Passed ballot with these corrections.

Abstract: This document defines the release notes that are available with the Pegasus 2.2 release.

## Availability of the Pegasus 2.2 Release

The Pegasus 2.2 release is available as a source release in both ZIP and TAR formats. The release can be downloaded from the OpenPegaus Web site at www.openpegasus.org.

In addition, the release is available through Pegasus CVS as the branch tag RELEASE_2_2_0-branch. This defines the current released version of Pegasus 2.2 . In addition, the following tags exist for the release. RELEASE_2_2_0-root which defines the initial release point of Pegasus 2.2 and the point at which it branched from the trunk.. Other tags may exist to mark release candidate snapshots, etc. These will be announced on the web site and the Pegasus mailing list.

The instructions for acquiring the released code are on the WEB site. Installation instructions are part of the readme in the root of the source tree.

The OpenPegasus project is currently not providing binary releases. However, binary releases may be available of selected ports and are documented on the OpenPegasus web site.

There may be point releases to the Pegasus 2.2 release and these will be announced on the Pegasus web site.

## Functionality Level of OpenPegaus 2.2 Release

The overall level of functionality in the Pegasus environment is as follows:

CIM Server

> CIM Operations

> 1. Class Operations (get, delete, modify, enumerate) - Operational
> 2. Instance Operations (get, delete, modify, enumerate) - Operational
> 3. Association Operations (reference, referencenames, associators, associatornames - Operational NOTE: The provider interfaces are still considered experimental today and may be modified or extended for Pegasus 2.3, particularly for possible performance improvements.
> 4. Methods- Operational
> 5. Query operation (Not implemented)

> Indications

> Process indications are operational in the Server. This includes support for subscriptions, filters, and indication handlers, the provider API for indications and the CIMXML indication handler. A second Pegasus sever can be use as an Indication client. However, the Client indication support is incomplete and completion is planned for Pegasus 2.3.

> Query Language

> The query language today is based on WQL and is implemented and used for filters. However, the executeQuery operation has not been implemented pending the availability of a standard DMTF Query language.

> Class Repository

> This release includes the XML based file/directory Class repository.

> Instance Repository

> This release includes an XML based file/directory Instance repository. The instance repository is used as the default repository unless a flag is set disabling this repository for client operations

> Security

> 1. Basic Security (Note that Digest based security is not implemented)
> 2. SSL support - SSL is implemented in Pegasus using the OpenSSL libraries. Pegasus does not provide the OpenSSL libraries but SSL can be used on any platform that supports OpenSSL

> Platform Management Functions

> 1. Configuration through the defined configuration parameters.
> 2. Daemon operation on all supported platforms

Providers

There are a number of standard providers available in Pegasus release. This includes providers in the following:

> Internal Providers

> - __Namespace provider - Serves the __Namespace class to allow manipulation of namespaces.
> - Subscription Classes Providers - These provide subscription, filter, and indication handler processing.
> - Provider registration Providers - This provide registration of providers using the PG_Provider classes.
> - ConfigProvider - Manages Pegasus configuraton information.
> - UserAuthProvider - Manages password, etc.
> - ShutdownProvider - Provides support for Pegasus shutdown.

> Generic

> Generic OperatingSystem provider. See the directory src/Providers/generic.

> Test/Sample

> See the directories src/Providers/TestProviders and src/Sample for more information about test and sample providers.

> Managed System Providers

> ComputerSystem, DNSAdmin, DNSService, Operating System, Process, Processor. For more information on these providers see the documentation for each provider in the directory src/Providers/ManagedSystem

> CIMOM Statistics Providers

> IBMStatisticalData - This is an early version of the work that became CIM_StatisticalData

Linux Specific Providers

> There are a number of providers in this category including DiskDrive, CDROMDrive, Interrupt, IOPOrt, IPROute, NetworkAdapter, Operating System, PCI Controller, PRocessor, ProviderData, ProviderSupport, SoftwareElement. For more information about these providers see the documentation in the directory src/Providers/linux

CIM_Schema

The default CIM_Schema loaded with the Pegasus 2.2 release is the DMTF CIM 2.7 Final release. In addition, Pegasus includes a number of local classes defined for Pegasus. These are visible in the Schemas directory.

Pegasus MOF Compiler

Pegasus implements a MOF compiler that can operate either at the client interface (cimmof) or directly interfacing with a CIM repository (cimmofl). There were new commands implemented in the Pegasus 2.2 compiler to support class replacement.

Note that use of cimmofl to manipulate instances in the repository bypasses any provider that is registered to serve the instances and simply installs the instances in the instance repository; this may result in corruption if providers are using the repository. Use of cimmofl to manipulate instances served by a registered providers is therefore discouraged. Use of cimmof rather that cimmofl is encouraged

Client Tools

Pegasus CIM Server Adminstration

1. cimuser - Manage Pegasus CIM server Users
2. cimconfig - Manage the Pegasus CIM Server configuration parameters
3. cimauth - Manage the CIM Server authorization characteristics. Today this is authorizing users to namespaces.
4. cimprovider - Manage information about the providers.

Information client tools

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

1. tomof - output Classes and/or instance information in MOF or XML format.
2. dnsinfo
3. ipinfo
4. osinfo

Test support Tools

1. Pegasus Unit tests (available through the "tests" option on the Pegasus make files
2. The Pegasus Test Suite (see the tests directory and the Pegasus/TestBuildMakeFile)tomof
3. TestClient - Basic client for overall platform operation testing.
4. CGICLient - This client has not been completely update to version 2.2.
5. wbemexec - Test tool that sends/receives XML from XML input.
6. CLI - Command line interface for Client commands.

Pegasus InterfaceAPIs

The Client and Provider API are frozen and at the same level as Pegasus version 2.1. This set of interfaces is listed in PEP 40 available from the web site. This includes the following major functions

1. Client APIs
2. Provider APIs
3. CIM Objects

The functions are documented in their respective header files and HTML documentation based on the information in the header files extracted with the doc++ tool will be available on the OpenPegasus web site.

## Supported Platforms

Each Pegasus release lists as supported platforms those hardware/software platforms that have recognized ports for the Pegasus code base including a maintainer for the platform that will be willing to regularly assure that the port is maintained as the Pegasus code base is changed. Pegasus may be operable on other platforms (ex. Windows 98) but without a group to provide the role of test and maintenance, the Pegasus project cannot assure operation. The supported platforms for Pegasus release 2.2 are:

Platform and OS | Compilers
AIX 5.2 | VisualAge C++ Version 5.0.2.3
HP-UX | HP aC++ B3910B
Linux Itanium | gcc
Linux IA-32 | gcc (versions 2.9x and 3.xx)
Windows 2000 | Microsoft Visual C++ Ver 6
Windows XP | Microsoft Visual C++ Ver. 6

## Conformance with DMTF Specifications

Generally Pegasus tries to conform to the CIM specifications. It is a major goal of the OpenPegasus project to both drive and utilize the specifications. However, today there are a number of differences. As of Pegasus 2.2, some of the differences include the following:

1. Provider Registration - Pegasus supports registration through a set of Provider registration classes and does not support the Provider Qualifier.

2. Indications. Today Pegasus supports process indications but does not include any specific support for lifecycle indications.

3. Today Pegasus provides alternatives to some of the classes in the Interop Schema including CIM_StatisticalData and Pegasus 2.2 does not include CIM_Namespace support (__Namespace is supported).

## Changes in this Release

Each Pegasus release is defined through the Pegasus PEP Process and there is a specific PEP that defines the changes that go into each release. The defining PEP for Pegasus 2.2 is PEP 15 which is viewable on the Pegasus WEB site. In addition, each release includes Bug corrections. Generally all of the changes should be defined by either the PEPs or the bugs closed for the release.

Some of the major changes for this release include:

- Large number of bug corrections.
- Compiler extensions.
- Association operation support.
- Upgrade to CIM 2.7 including both the support of the released CIM 2.7 Schema and update of a number of classes from Pegasus (PG_) to CIM classes.
- CIMOM handle support correction and completion.
- Indication provider API completion.
- Finalize test and support of indications.
- Production oriented Logging.
- Addition of dynamic routing for indication internal routing.

In addition, the Pegasus Project implemented a number of procedures and processes to gain further control of the project.

The detailed list of enhancements is defined through the Pegasus PEPs. Detailed information on each enhancement is available in the PEP which is available on the Pegasus WEB site. The PEPs defined for Pegasus 2.2 include (NOTE: This list includes both those implemented and those deferred or withdrawn):

PEP # | PEP Description | Actual Date | Comments
--- | --- | --- | ---
0 | PEP#000-Template for Creating PEPs | Adopted |
1 | Pegasus Project Enhancement Proposals - Guidelines and the Approval Process | Adopted | PEP Process introduced into Pegasus 2.2 process.
2 | Pegasus Bug Tracking and Bug Fix Commitment Process | Deferred | Deferred to Pegasus 2.3.
3 | Platform Maintainers Process and Procedures | Deferred | Deferred to Pegasus 2.3.
4 | Managing CVS Test and Build | Deferred | Deferred to Pegasus 2.3.
5 | Indications Improvements | Withdrawn | Replaced by PEP 47.
6 | Pegasus Architecture Process | Deferred | Deferred to Pegasus 2.3.
7 | CIMMOF Improvements | Withdrawn | Replaced with PEP 43 and 45.
8 | Runing CIM Server as a Service on Windows | January 25, 2003 |
9 | CVS Branch Merge proposal for Pegasus 2.2. | Withdrawn | Replaced by PEP 46
10 | N/A | Withdrawn | PEP Number Skipped.
11 | Adding Support for XML Character References | Feb 11, 2003 |
12 | Finish Association Provider Interface and Testing |  | Pending for Pegasus 2.2
13 | Upgrading to use CIM 2.6 and 2.7 Schemas | Withdrawn | Plan to replace with a series of class specific PEPs (e.g., 42 and 52).
14 | Pegasus Release Milestones | Adopted | Milestones introduced into Pegasus 2.2 release process.
15 | This PEP defines Pegasus Release 2.2. | Adopted | See version history section of this PEP for status.
16 | Replacement of PG_<className> classes with CIM_<className> classes for Indications | April 25, 2003 |
17 | Merge-local: Add containers for indication subscription and delivery parameters | Feb 12, 2003 |
18 | Merge-local: Modification of WQL classes to use CIMName | Feb 12, 2003 |
19 | Merge-local: Support for Multiple Listen Sockets | March 11, 2003 |
20 | Merge-local: Local Connections Using Unix Domain Sockets | March 11, 2003 |
21 | Merge-local: Add HUP Signal Handler | March 11, 2003 |
22 | Merge-local: Windows Time/Date Order Reversal in getCurrentASCIITime() | Feb 21, 2003 |
23 | Merge-local: Consolidation of SSLDir Files | Feb 21, 2003 |
24 | Merge-local: Provider Registration Consistency | March 24, 2003 |
25 | Merge-local: Add a simple display consumer to test indications | March 28, 2003 |
26 | Merge-local: RT_IndicationProvider Enhancement | Feb 26, 2003 |
27 | Merge-local: Custom hash table hash and equal function objects to support case-sensitivity of namespace names. | Feb 25, 2003 |
28 | Enhancements of osinfo to support remote connections. | March 7, 2003 |
29 | Pegasus CIMOMHandle |  |
30 | SLP Support in Pegasus 2.2 | Deferred | Deferred to Pegasus 2.3
31 | Merge-local - Incorrect error message generated during Authentication failure. | March 7, 2003 |
32 | Merge-local: HP-UX IA64 and Linux IA64 platforms to only use PAM based Authentication. | March 13, 2003 |
33 | Enhancement to Red Hat IA32 and IA64 RPM (packaging and distribution) files | March 13, 2003 |
34 | Enhanced support for doc++ in SDK head files | March 12, 2003 |
35 | Add support for /dev/random in SSLContext | March 13, 2003 |
36 | Merge-local: Add ipinfo client. | April 1, 2003 |
37 | Indication API Support Commitment |  | Plan to submit SDK directories once FC has been achieved and the 2.2 API enhancements have been tested.
38 | Proposal to Enhance Provider Manager in Pegasus 2.2 | April 17, 2003 |
39 | Improvements to HTTPConnection/Monitor in Pegasus 2.2 | Withdrawn | Changes will be submitted through Bugzilla process.
40 | Pegasus External Interface Definition |  | Plan to submit SDK directories once FC has been achieved and the 2.2 API enhancements have been tested.
41 | Modifications for successful build on zOS USS |  |
42 | Update to CIM Schema Version 2.7 | April 29, 2003 | The DMTF plans to release an update, 2.7.2, to the CIM 2.7.1 Schema. Plan to move to this version as soon as it is available.
43 | cimmof - Updating Class Definitions | April 29,2003 |
44 | Logging Enhancements | March 27, 2003 |
45 | MOF Compiler Scenarios | Deferred | Deferred to Pegasus 2.3
46 | Proposal (2nd alt) to merge working branches in Pegasus Open-source CVS Repository | Adopted | Process used for mday-2-0-patches branch merge.
47 | Dynamic Message Routing and Late Binding in Pegasus 2.2 | May 1, 2003 | One additional change, dependent on PEP 12, is still pending.
48 | Merge openpegasus.org-wbem-rh32-2.2.spec into openpegasus.org-wbem-2.2.spec | March 19, 2003 |
49 | Wbemexec enhancement to verify trust store validation result | March 19, 2003 |
50 | MD5 Digest Authentication | Deferred | Deferred Indefinitely
51 | Configuration Property Cleanup | March 25, 2003 |
52 | Adding the CIM_Interop Classes to Pegasus | Deferred | Deferred
53 | Logging Enhancements Code Points Table | April 10, 2003 |
54 | Changing IBMStatisticalData to CIMStatisticalData Classes | Deferred | Deferred to Pegasus 2.3
55 | Update Software License to reflect correct years of our copyright and list of contributors |  | Pending for Pegasus 2.2

Some of the work that was specifically planned for Pegasus 2.2 did not make the cut. As shown in the table above this includes the following:

- MD5 Digest Authentication - PEP 50 - Deferred indefinitily for lack of sponsor for the work.
- SLP - This work was deferred to Pegasus 2.3
- Changing IBMStatisticalData Classes to CIMStatisticalData classes - deferred to Pegasus 2.3
- Incorporation of Interop Classes.

In addition, a number of problems were corrected in this release. The list of problems corrected/closed includes the following:

ID | Sev | Pri | Plt | Owner | State | Result | Summary
--- | --- | --- | --- | --- | --- | --- | ---
12 | nor | P2 | PC | k.schopmeyer@opengroup.org | RESO | INVA | Compiler accepts qualifier declaractions that already exist
31 | maj | P2 | All | roger_kumpf@hp.com | RESO | FIXE | Handle absent/null ClassName and String parameters
35 | nor | P3 | All | nagaraja_boranna@hp.com | RESO | LATE | CIMOM need to timeout waiting for authentication challeng...
55 | nor | P2 | Oth | denise_eckstein@hp.com | RESO | FIXE | Add appropriate Version tag to all classes in ManagedSyst...
59 | maj | P2 | HP | Nitin_Upasani@hp.com | RESO | FIXE | CIMServer core dumps when simultaneous clients connect to it
61 | maj | P1 | All | k.schopmeyer@opengroup.org | RESO | DUPL | Subscription tests intermittently fail with core dump.
97 | cri | P2 | HP | Nitin_Upasani@hp.com | RESO | FIXE | cimom doesn't look in /opt/wbem/providers/lib for provide...
98 | nor | P2 | HP | warren_otsuka@hp.com | RESO | FIXE | repository won't be default instance provider on enumInst...
103 | nor | P2 | PC | roger_kumpf@hp.com | RESO | FIXE | Pegasus Namespace creation/deletion is Incompatible with ...
107 | nor | P2 | PC | bapu_patil@hp.com | RESO | FIXE | CIMServer died while testing NameSpace operations(05/21/02)
117 | nor | P3 | All | nagaraja_boranna@hp.com | CLOS | FIXE | Info. logging in ConfigManager related files to be change...
119 | nor | P3 | All | warren_otsuka@hp.com | RESO | FIXE | cimserver does not use 'cimserver_planned.conf' when 'cim...
124 | nor | P2 | Oth | k.schopmeyer@opengroup.org | RESO | FIXE | SUSE 8.0 tries to bind to wrong port
125 | nor | P1 | Oth | roger_kumpf@hp.com | RESO | DUPL | Bad formatting on HTTP Header Namespace Fields
135 | nor | P2 | Oth | roger_kumpf@hp.com | RESO | FIXE | Client Response decoder does not handle EMPTY tag
136 | nor | P2 | Oth | k.schopmeyer@opengroup.org | RESO | WONT | PEGASUS requires a objectpath tag on associatorsnames res...
137 | nor | P2 | Oth | k.schopmeyer@opengroup.org | RESO | INVA | Null Value datetime on received XML causes exception
142 | maj | P2 | HP | k.schopmeyer@opengroup.org | RESO | DUPL | CIMOMHandler use from a provider makes cimserver lock
143 | nor | P2 | HP | roger_kumpf@hp.com | RESO | FIXE | CIMObjectPath parsing fails if objectname has ':' character
145 | min | P4 | HP | denise_eckstein@hp.com | RESO | FIXE | make repository does not take dependences into account in...
152 | nor | P1 | All | k.schopmeyer@opengroup.org | RESO | DUPL | The ccimoperationrequestdecoder namespace vs cimobject te...
166 | nor | P2 | All | carolann_graves@hp.com | RESO | FIXE | Casting an OperationContext object to an IdentityContaine...
167 | nor | P2 | PC | roger_kumpf@hp.com | RESO | FIXE | TestBase64 takes a long time to complete on Tru64
172 | nor | P2 | All | carmack@us.ibm.com | RESO | FIXE | SIGABRT when CLI's call exit( )
173 | nor | P3 | IBM | carmack@us.ibm.com | RESO | FIXE | Porting changes for OS/400
174 | cri | P3 | PC | k.schopmeyer@opengroup.org | RESO | FIXE | Associators fn throwing exception "not Implemented"
175 | nor | P2 | IBM | dnn@austin.ibm.com | RESO | FIXE | TheadPool Fails occasionally
176 | nor | P2 | All | pegasus-cvs-writers@opengro... | RESO | WONT | Bugs in cimconfig
177 | nor | P2 | All | yi_zhou@hp.com | RESO | FIXE | Bugs in cimprovider
178 | nor | P2 | All | carmack@us.ibm.com | RESO | FIXE | Command line bugs in cimmof
179 | cri | P1 | PC | k.schopmeyer@opengroup.org | RESO | WONT | Multiple calls to Providers for any association query
180 | nor | P2 | HP | pegasus-cvs-writers@opengro... | RESO | DUPL | cimserver starts in the wrong port if wbem-http already i...
181 | cri | P2 | PC | k.schopmeyer@opengroup.org | RESO | FIXE | Association providers are not invoked
182 | nor | P3 | HP | roger_kumpf@hp.com | RESO | FIXE | Compilation fails in System.h
183 | nor | P3 | HP | roger_kumpf@hp.com | RESO | FIXE | Compile error in cimserver_unix.cpp, cimserver_os400.cpp
184 | cri | P1 | HP | pegasus-cvs-writers@opengro... | RESO | DUPL | Compile Errors
185 | maj | P3 | HP | pegasus-cvs-writers@opengro... | RESO | FIXE | Unrecognized config property: start
186 | blo | P2 | HP | mdday@us.ibm.com | RESO | FIXE | ThreadPool test dies on Semaphore::wait() exception
187 | nor | P2 | All | yi_zhou@hp.com | RESO | FIXE | WHERE Clause Properties Incorrectly Removed From Indication
188 | nor | P2 | All | yi_zhou@hp.com | RESO | FIXE | SELECT Clause Is Ignored
189 | nor | P2 | All | yi_zhou@hp.com | RESO | FIXE | Indication Contents Are Incorrect
190 | nor | P3 | HP | yi_zhou@hp.com | RESO | FIXE | Change Consumer Shared Library Major Version Number for H...
191 | nor | P2 | All | yi_zhou@hp.com | RESO | FIXE | Memory Error in Indication Response Handler
192 | nor | P4 | All | roger_kumpf@hp.com | RESO | FIXE | install/remove/start/stop options should work on Windows ...
193 | nor | P3 | All | roger_kumpf@hp.com | RESO | FIXE | Incorrect message on bad cimserver option
194 | nor | P1 | PC | k.schopmeyer@opengroup.org | RESO | FIXE | General error response on associator and reference cim op...
195 | nor | P2 | All | roger_kumpf@hp.com | RESO | FIXE | Common mutex in HTTPConnection may cause deadlock
197 | nor | P2 | All | carolann_graves@hp.com | RESO | FIXE | HTTP method not set correctly in all responses
198 | nor | P2 | HP | carolann_graves@hp.com | RESO | FIXE | Shared library major version number must be updated
199 | nor | P2 | HP | sushma_fernandes@hp.com | RESO | FIXE | cimserver core dumps on HP-UX when using PAM with trusted...
201 | nor | P2 | All | carmack@us.ibm.com | RESO | FIXE | Bug in IBM_CIMOMStatDataProvider
204 | nor | P5 | HP | roger_kumpf@hp.com | RESO | FIXE | Compile error in PERFINST code
205 | nor | P2 | All | roger_kumpf@hp.com | RESO | FIXE | Inconsistent Provider Registration MOF
207 | maj | P2 | All | roger_kumpf@hp.com | RESO | FIXE | CIMObject Header Not URI-Safe
208 | min | P2 | All | nagaraja_boranna@hp.com | RESO | FIXE | Modify PEGASUS_SSLCLIENT_CERTIFICATEFILE to define client...
209 | maj | P1 | All | nagaraja_boranna@hp.com | CLOS | FIXE | SSLContext does not configure OpenSSL to use the client t...
214 | nor | P2 | PC | pegasus-cvs-writers@opengro... | RESO | FIXE | Build problems under GCC 3.2 (RedHat 8)
215 | nor | P2 | Ita | warren_otsuka@hp.com | RESO | FIXE | Use Environment Variables for Redhat IA32
216 | nor | P2 | Ita | warren_otsuka@hp.com | RESO | FIXE | Versioning of Linux Shared Libraries Does Not Work
218 | cri | P2 | All | mdday@us.ibm.com | RESO | FIXE | CIMClient::disconnect / HTTPConnector::disconnect memory ...
219 | nor | P2 | All | roger_kumpf@hp.com | RESO | FIXE | cimXML for Indication Delivery Uses Outdated Specification
220 | nor | P2 | All | carolann_graves@hp.com | RESO | FIXE | Indication Service no longer should check select or where...
221 | nor | P2 | All | carolann_graves@hp.com | RESO | FIXE | Typos in sample indication provider files
222 | maj | P1 | HP | pegasus-cvs-writers@opengro... | RESO | DUPL | cimserver core dumps when multiple threads call OpenSSL f...
223 | maj | P2 | All | pegasus-cvs-writers@opengro... | RESO | LATE | ProviderManager deadlock during provider initialization
224 | nor | P2 | All | denise_eckstein@hp.com | RESO | FIXE | Excessive number of open files when running cimmof on CIM...
225 | maj | P2 | All | roger_kumpf@hp.com | RESO | FIXE | cimconfig aborts on bad argument value
226 | nor | P2 | All | denise_eckstein@hp.com | RESO | FIXE | Remove unnecessary include files from cimmofClient.cpp
227 | nor | P3 | PC | pegasus-cvs-writers@opengro... | RESO | FIXE | System::is_absolute_path does not consider slash differen...
228 | nor | P4 | PC | roger_kumpf@hp.com | RESO | FIXE | FileSystem::getAbsolutePath is incorrect on Windows
229 | nor | P5 | All | roger_kumpf@hp.com | RESO | FIXE | IPC test fails unnecessarily
230 | nor | P4 | HP | roger_kumpf@hp.com | RESO | FIXE | Change "severity" property to "logLevel"
231 | nor | P2 | All | roger_kumpf@hp.com | RESO | FIXE | Linux OperatingSystem provider leaks file handles
232 | cri | P2 | PC | pegasus-cvs-writers@opengro... | RESO | FIXE | ThreadPool hangs intermittently on Windows
233 | nor | P2 | All | pegasus-cvs-writers@opengro... | RESO | FIXE | logLevel is not properly initialized
234 | nor | P4 | All | pegasus-cvs-writers@opengro... | RESO | FIXE | Debug messages printed to console in Thread.cpp
235 | min | P4 | All | roger_kumpf@hp.com | RESO | FIXE | Inconsistent error message in XmlReader
236 | maj | P2 | All | nagaraja_boranna@hp.com | CLOS | FIXE | server.pem and client.pem have expired certificates
238 | nor | P4 | All | roger_kumpf@hp.com | RESO | FIXE | Signal code is platform-specific
239 | nor | P3 | HP | roger_kumpf@hp.com | RESO | FIXE | HPUX Provider libraries need to be changed to .so/.sl
240 | nor | P2 | All | yi_zhou@hp.com | RESO | FIXE | Performance Enhancement For The Provider Disable and Enable
241 | nor | P2 | All | roger_kumpf@hp.com | RESO | FIXE | Memory leak in CIMDateTime
242 | min | P4 | All | jenny_yu@hp.com | RESO | FIXE | Wrong status code returned by the Server to the client.
244 | nor | P2 | All | roger_kumpf@hp.com | RESO | FIXE | Incorrect coupling of remote privileged access and namesp...
245 | nor | P4 | All | roger_kumpf@hp.com | RESO | FIXE | Providers link with libpegserver
248 | nor | P2 | All | nagaraja_boranna@hp.com | RESO | DUPL | When certificate was in trust store and ssl verify callba...
251 | nor | P2 | PC | denise_eckstein@hp.com | RESO | FIXE | Minor Makefile Changes
252 | nor | P2 | PC | denise_eckstein@hp.com | RESO | FIXE | STRIPCRS option is not working correctly
253 | min | P4 | All | roger_kumpf@hp.com | RESO | FIXE | pegasus_sleep() mishandles fractional seconds
254 | nor | P2 | PC | yi_zhou@hp.com | RESO | FIXE | maxWaitTime code did not get called in cimserver_unix.cpp
255 | nor | P2 | All | yi_zhou@hp.com | RESO | FIXE | RT_IndicationProvider Defines Duplicated Properties
256 | nor | P2 | All | yi_zhou@hp.com | RESO | FIXE | Code in the ExportClient is obsolete
257 | maj | P2 | HP | sushma_fernandes@hp.com | RESO | FIXE | OpenSSL locking callbacks not initialized
258 | nor | P5 | All | roger_kumpf@hp.com | RESO | FIXE | Incorrect conversion from char to Char16 in String.cpp
260 | maj | P1 | HP | pegasus-cvs-writers@opengro... | RESO | FIXE | Compile error in reg_table.cpp
261 | nor | P1 | All | mdday@us.ibm.com | RESO | FIXE | need additional compile and link flags for GCC use of dyn...
262 | maj | P1 | PC | pegasus-cvs-writers@opengro... | RESO | FIXE | Compile error in ThreadWindows.cpp
264 | nor | P2 | All | warren_otsuka@hp.com | RESO | FIXE | Enable Indications for Linux
265 | nor | P2 | All | warren_otsuka@hp.com | RESO | FIXE | Enable Strong Encryption for Linux
266 | maj | P1 | HP | pegasus-cvs-writers@opengro... | RESO | FIXE | Build fails in ProviderModule.h

268 | nor | P2 | All | pegasus-cvs-writers@opengro... | RESO | FIXE | code for PEP 17, bugzilla 197 removed
269 | nor | P2 | PC | pegasus-cvs-writers@opengro... | RESO | FIXE | ProcessIndicationProvider cannot unload
270 | nor | P2 | HP | denise_eckstein@hp.com | RESO | FIXE | ProcessorProviderTestClient Link Failing
271 | nor | P1 | PC | pegasus-cvs-writers@opengro... | RESO | FIXE | TestMakefile bugs on linux
272 | nor | P2 | PC | pegasus-cvs-writers@opengro... | RESO | FIXE | Command line utilities use a different configuration than...
273 | nor | P3 | PC | warren_otsuka@hp.com | RESO | FIXE | Local Domain Socket Path Missing for Linux
274 | nor | P2 | All | roger_kumpf@hp.com | RESO | FIXE | Control characters in CIM data cause response truncation
275 | maj | P1 | HP | pegasus-cvs-writers@opengro... | RESO | FIXE | Unable to load providers
276 | nor | P2 | PC | mdday@us.ibm.com | RESO | FIXE | MSVC compilation failure in Provider directory
277 | nor | P1 | PC | roger_kumpf@hp.com | RESO | FIXE | Client::connect_local() does not work on linux when using...
278 | nor | P2 | All | pegasus-cvs-writers@opengro... | RESO | FIXE | cimserver -s does not shut down cimserver
280 | nor | P2 | All | carolann_graves@hp.com | RESO | FIXE | Provider Registration Manager does not update hash table ...
282 | nor | P2 | All | roger_kumpf@hp.com | RESO | FIXE | Pegasus cimmof compiler does not correctly handle default...
284 | nor | P2 | PC | roger_kumpf@hp.com | RESO | FIXE | sscanf failing to return conversion error on Linux IA-32
287 | nor | P2 | PC | pegasus-cvs-writers@opengro... | RESO | FIXE | Duplicate definition of ROOT in config.mak should be rem...
288 | maj | P2 | HP | roger_kumpf@hp.com | RESO | FIXE | CLIClientLib compile failure
289 | maj | P2 | All | roger_kumpf@hp.com | RESO | FIXE | Sample providers are not registered
290 | nor | P2 | All | carolann_graves@hp.com | RESO | FIXE | MessageTypeToString() returns incorrect results
291 | maj | P2 | Ita | roger_kumpf@hp.com | RESO | FIXE | CLI test client compile error
292 | nor | P2 | All | warren_otsuka@hp.com | RESO | FIXE | Resolve SSL Header File Conflict
293 | min | P2 | All | pegasus-cvs-writers@opengro... | RESO | FIXE | uninitialized variable in provider manager
295 | cri | P2 | All | pegasus-cvs-writers@opengro... | RESO | FIXE | make repositoryServer fails - Namespace Provider not found
297 | nor | P1 | PC | mdday@us.ibm.com | RESO | LATE | dynamic class routing table does not route to association...
299 | nor | P2 | All | carmack@us.ibm.com | RESO | FIXE | Update PegasusVersion.h for release 2.2
300 | nor | P3 | All | jenny_yu@hp.com | RESO | FIXE | 'cimserver -s' returns control to the user before cimser...
301 | nor | P1 | PC | mdday@us.ibm.com | RESO | FIXE | provider manager merge lost CMPI adapter
302 | nor | P2 | PC | warren_otsuka@hp.com | RESO | FIXE | Modify openpegasus.org-wbem-2.2.spec for CIM27 mofs
303 | nor | P4 | PC | denise_eckstein@hp.com | RESO | FIXE | Running "make tests" fails while using TestMakefile
304 | nor | P3 | PC | fiorentino_tony@emc.com | RESO | FIXE | Cannot have multiple cimserver CIMOMs running as a window...
305 | nor | P2 | All | pegasus-cvs-writers@opengro... | RESO | FIXE | Remove extra -aE option from makefiles when final CIM27 i...
307 | nor | P2 | PC | fiorentino_tony@emc.com | RESO | FIXE | Using the PEGASUS_REMOVE_DEPRECATED
308 | min | P3 | PC | pegasus-cvs-writers@opengro... | RESO | REMI | Threadpool - uninitialized value
309 | nor | P2 | All | roger_kumpf@hp.com | RESO | FIXE | Authentication Failure return wrong error message
310 | nor | P4 | HP | pegasus-cvs-writers@opengro... | RESO | LATE | pegasus/src/Clients/CLITestClients/CLIClientLib build fai...
311 | nor | P2 | HP | denise_eckstein@hp.com | RESO | FIXE | pegasus/src/Clients/CLITestClients/CLI/CLI.cpp build failure
312 | min | P4 | HP | roger_kumpf@hp.com | RESO | FIXE | osinfo incorrectly formats datetime value
313 | cri | P2 | All | denise_eckstein@hp.com | RESO | FIXE | ConfigManager Test Failure - Unrecognized config property...
314 | cri | P2 | All | denise_eckstein@hp.com | RESO | FIXE | Client Test fails - Person class not found
315 | nor | P2 | PC | k.schopmeyer@opengroup.org | RESO | FIXE | No try block around configurtion property get (Maximum br...
320 | nor | P2 | All | yi_zhou@hp.com | RESO | FIXE | cimprovider -r -m dose not unload the provider
321 | cri | P1 | All | roger_kumpf@hp.com | RESO | FIXE | Compile error building ProviderMoulde.cpp
325 | enh | P2 | HP | roger_kumpf@hp.com | RESO | FIXE | Add handler for TERM signals
327 | nor | P2 | PC | fiorentino_tony@emc.com | RESO | FIXE | TestMakefile and mak/buildMakefile need updates for windows
332 | nor | P1 | All | pegasus-cvs-writers@opengro... | RESO | FIXE | logic error in Provider::tryTerminate

## Documentation

The following documentation is available for the Pegasus 2.2 release:

- Build and Installation - Readme in the Pegasus Root Directory
- Operation - Readme in the Pegasus Root Directory
- APIs - See the header files and the HTML documentation that is on the web site.
- Utilities - A combination of help generally available with the -h option for the command and HTML documentation for most of the tools.
- API usage documentation - The best API usage documentation is the existing utilities and test programs. In particular the Common/tests unit tests contain extensive examples of the use of the Common APIs.

## Known Problems/Limitations with this Release

There are a number of known bugs in the Pegasus 2.2 release. The following list of known open bugs as of the CVS branch for Pegasus 2.2 is in the following table. Note that this list will change as bugs are fixed and probably new bugs found. To get the latest bug status for Pegasus, use the OpenPegasus bug manager (Bugzilla) which is can be found at http://cvs.rdg.opengroup.org/bugzilla/

Tue Jun 10 13:16:43 BST 2003

66 bugs found.

ID | Sev | Pri | Plt |  | State | Result | Summary
--- | --- | --- | --- | --- | --- | --- | ---
323 | cri | P2 | All |  | ASSI |  | TestClient Failure - Associations
18 | maj | P2 | All |  | ASSI |  | WQLParser::parse returns parse error on valid query after...
246 | maj | P2 | All |  | NEW |  | Security issues with CIMOMHandle
212 | maj | P2 | All |  | NEW |  | Cimserver uses lots of cpu "idle time" when the cimserver...
263 | maj | P2 | PC |  | NEW |  | The pegasus client has a rapid memory leak and causes the...
134 | nor | P2 | Oth |  | ASSI |  | Pegasus Compiler puts VALUE.OBJECT around qualifier Decl
141 | nor | P2 | All |  | ASSI |  | ObjectPath MalformedObjectPath exceptions leak back throu...
298 | nor | P2 | PC |  | NEW |  | dispatcher lookup optimization
285 | nor | P2 | PC |  | ASSI |  | TestStopwatch Occassionally Fails with an Assert
90 | nor | P2 | PC |  | ASSI |  | Deep Inheritance and Local Only Flags Do Not Work
168 | nor | P2 | PC |  | ASSI |  | Incomplete CIMObjectPath wen calling providers
171 | nor | P2 | PC |  | ASSI |  | DateTime key properties are not handled properly
328 | nor | P2 | All |  | NEW |  | datetime value parsing handling of interval format
250 | nor | P2 | PC |  | NEW |  | _MakeAddress() returns FALSE when given an IP address whi...
319 | nor | P2 | PC |  | NEW |  | CIMQualifier::getPropagated() returns Uint32 instead of B...
331 | nor | P2 | IBM |  | NEW |  | undefined CIMSERVER_START_FILE
318 | nor | P2 | PC |  | NEW |  | RPM SPEC file (openpegasus.org-wbem-2.2.spec ) is outdat...
92 | enh | P2 | PC |  | NEW |  | UTF8 Characters on XML input and XML output
93 | enh | P2 | PC |  | NEW |  | UTF8 input to compiler
70 | enh | P2 | HP |  | NEW |  | Client API should support socks
146 | enh | P2 | HP |  | NEW |  | There is no way to do pre-build or post-build stuff with ...
89 | maj | P3 | All |  | ASSI |  | HTTPConnection must return 413 response on oversized requ...
101 | maj | P3 | All |  | ASSI |  | The requestUri may need to be pruned of the host name.
63 | nor | P3 | All |  | ASSI |  | Indication Service should not respond to request until re...
126 | nor | P3 | PC |  | NEW |  | CIMDateTime::getDifference returns incorrect result for s...
279 | nor | P3 | HP |  | NEW |  | CIMDateTime::getDifference returns incorrect result on so...
326 | nor | P3 | HP |  | NEW |  | Use calloc for PAM response memory allocation
133 | nor | P3 | Oth |  | ASSI |  | Pegasus compiler converts Schema Qualifer decl to CLASS
211 | nor | P3 | PC |  | ASSI |  | CIMObjectPath Legal Host name incomplete
283 | nor | P3 | PC |  | NEW |  | PEGASUS_ASSERT in /src/Pegasus/Client/CIMOperationRespons...
28 | nor | P3 | All |  | NEW |  | Locale information not passed through system
196 | nor | P3 | All |  | ASSI |  | Memory leak in MessageQueueService
202 | nor | P3 | HP |  | ASSI |  | Porting changes for HP-UX
203 | nor | P3 | All |  | ASSI |  | Porting changes for IA64 Linux
206 | nor | P3 | HP |  | NEW |  | Client requests time out with PERFINST enabled
267 | nor | P3 | All |  | NEW |  | ComputerSystem provider does not set path in enumerateIns...
281 | nor | P3 | All |  | ASSI |  | setQualifier throws CIM_ERR_ALREADY_EXISTS
120 | nor | P3 | PC |  | ASSI |  | CIMClassRep::addProperty() sets ClassOrigin incorrectly.
42 | nor | P3 | PC |  | ASSI |  | Windows OS provider doesn't fill in CSName and Name keys
144 | nor | P3 | HP |  | NEW |  | cimserver writes on console even when started in daemon mode
148 | nor | P3 | PC |  | ASSI |  | CGIClient.cpp changes '-' to '.'
237 | nor | P3 | All |  | ASSI |  | Incorrect use of statistic macros
249 | nor | P3 | All |  | NEW |  | cimmof returns code of 0 on error
316 | nor | P3 | PC |  | NEW |  | Return code of cimserver is always zero.
317 | nor | P3 | PC |  | NEW |  | Startup script for RedHat - rpm/wbem1.rh7 is not complian...
247 | min | P3 | All |  | NEW |  | ssl verify callback results are ignored when certificate ...
329 | min | P3 | PC |  | ASSI |  | tomof client fails on call - cannot find repository
330 | min | P3 | All |  | NEW |  | incorrect usage of htons in systemunix.cpp
286 | min | P3 | PC |  | ASSI |  | Error information is no longer returned on failure to loa...
210 | nor | P4 | PC |  | ASSI |  | MOF output for Reference values generates XML not mof
217 | nor | P4 | PC |  | NEW |  | Error in CIMClass Create on some Linux Platforms
243 | nor | P4 | PC |  | NEW |  | Compiler misses MOF syntax error in value
213 | nor | P4 | All |  | NEW |  | Insufficient Code Coverage
294 | nor | P4 | All |  | ASSI |  | Indication Service: conditional jump or move depends upon...
54 | nor | P4 | All |  | NEW |  | Need license info in ManagedSystem provider registration ...
306 | nor | P4 | All |  | NEW |  | cimconfig -s property=value -p allows you to set non-vali...
3 | min | P4 | All |  | ASSI |  | Weak association qualifier check missed
30 | min | P4 | All |  | NEW |  | Reference keys of reference type cannot be parsed
71 | min | P4 | All |  | ASSI |  | Statistics MOF included in ManagedSystem Schema
149 | tri | P4 | HP |  | ASSI |  | src/Clients/ToMofClient/ToMofClient.cpp warning during build
150 | tri | P4 | HP |  | NEW |  | warnings compiling src/Server/cimserver.cpp
296 | nor | P5 | All |  | NEW |  | pegasus/src/Pegasus/Server/tests accidently disabled Feb '02
322 | nor | P5 | Oth |  | NEW |  | readme.txt file is outdated
324 | tri | P5 | All |  | NEW |  | Add system error message to trace message on failed syste...

## Pegasus Maintenance

The Pegasus 2.2 release is maintained as a branch to the Pegasus CVS. The branch name is RELEASE_2_2_0-branch. There will be bug correction work done against the branch, corrections installed in the branch, and incremental releases of the branch in parallel with the work on Pegasus 2.3.

It will be the responsibility of any developer doing bug fixes on the Pegasus 2.2 branch to document the bugs in Pegasus Bugzilla reports and also to insure that the bug is corrected in the Pegasus 2.3 release. We will not attempt to merge any changes from Pegasus 2.2 back to 2.3 on a project basis.

Incremental releases with bot CVS tagging and snaphshots of the code will be created when the sufficient bugs have been corrected that the project and users feel that it is necessary to create the snapshot. The list of bug fixes will be documented for each incremental release.

## Reporting Problems

The Pegasus project uses Bugzilla to report bugs, define requested enhancements, and manage work on bugs. The bug reporting system is open to anybody and it is not required to be a member of the Pegasus project to submit bugs to this system. We sincerely hope that all Pegasus users will use this bug reporting system to report Pegasus bugs.

The Bug reporting system can be accessed via the Pegasus Web site or directly via the Pegasus Bugzilla BugList. When reporting bugs, please be a specific as possible, reporting the pegasus version, problem definition, environment (ie. system, OS, etc.). If a potential solution is defined for the problem, please document the solutions and provide a patch file if possible. Please be sure to note the the Pegasus version number 2.2 on any bugs submitted to Pegasus Bugzilla.

Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; IBM Corp.; The Open Group
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.