pegasus/doc/Attic/changelog.txt - diff

Return to changelog.txt CVS log

Up to [Pegasus] / pegasus / doc / Attic

Diff for /pegasus/doc/Attic/changelog.txt between version 1.49.2.57 and 1.76

version 1.49.2.57, 2001/11/29 00:42:08

version 1.76, 2002/03/08 02:32:15

Line 1

CHANGE LOG FOR PEGASUS

Version 1.07 working towards 1.1 - Started 4 Feb 2002

Started just before cutover to the new dispatcher, etc.

TAG: VERSION_1_07

1. KS - Updated pegsusversion to 1.07 and tagged file.

2. (Markus Mueller) 05 Feb 2002 - AIX support.

3. (Sushma Fernandes - HP) 13 Feb 2002 Implemented FileSystemPropertyOwner

class to support PEGASUS_HOME dependent properties like Repository

location, Provider location and Consumer location.

The default location for these properties continue to be the same

as before. Added support to the Config Manager to own the

Pegasus Home variable and implemented method (getHomedPath) to

return absolute paths based from Pegasus Home.

For more information look in to the following files:

pegasus/src/Pegasus/Config/ConfigManager.h

pegasus/src/Pegasus/Config/ConfigManager.cpp

pegasus/src/Pegasus/Config/FileSystemPropertyOwner.h

pegasus/src/Pegasus/Config/FileSystemPropertyOwner.cpp

4. KS - 18 Feb 02 Add changes to test for and set the NULL value for CIMValues.

This forces new CIMValues to have a NULL attributes that is only

reset when a value is "set" or copied into them. the XML and MOF

also deliver a NULL value back when the state of the CIMValue is NULL.

There is a remaining addition to put an exception on CIMValue gets when

the NULL attribute is set that we will install later.

5. KS - 19 Feb 2002 Extended testclient slightly and cleaned up numerous bugs.

6. KS - 19 Feb 2002 - Add workpaper in doc/workpaper defining the Pegasus Qualifiers.

Note that this version of the paper still needs work.

7. (Nag Boranna - HP) 20 Feb 2002 - Modified HTTPAcceptor to optionally bind to

loopback host. Modified CIMClient to connect to loopback host when connectLocal()

method is used. Added a new method lookupPort() in System.h to return the system

configured wbem port number. Modified cimuser, cimauth and cimconfig CLI's to use

modified CIMClient connectLocal() interface.

8. (KS- 21 Feb 2002) - Modified Makefile for repository load so located in

schema directory. The one in src/pegasus/compiler/load is deprecated and

will be deleted.

9. KS-21 Feb 2002 - Added new constructor to CIMValue and associated tests

10. RK-20 Feb 2002 - Add Array reference to CIMValue and added tests

11. (Sushma Fernandes - HP, Nag Boranna - HP) 22 Feb 2002 Implemented

checks for privileged user when performing authorization.

Added a configuration property enableRemotePrivilegedUserAccess.

This property needs to be set to true to enable privileged user access

for remote clients.

12. (Roger Kumpf - HP) 22 Feb 2002 - Added type information to extrinsic

method (InvokeMethod) operations. This change involves the addition

of PARAMTYPE attributes to PARAMVALUE and RETURNVALUE tags. This tag

allows the server to determine the type of a parameter value without

having to look up the method definition in the schema. It also allows

the client API to do the same for output parameters as well as return

values.

PROVIDER IMPLICATIONS:

Method providers ARE affected by this change. Previously, all input

parameters to invokeMethod were sent to the provider as String type

regardless of what the client actually specified or how the method

was defined. With this change, providers will now receive input

parameters of the type that was actually specified by the client

application (regardless of how the method was defined in the schema).

However, parameters coming from clients other than the Pegasus client

API may omit the PARAMTYPE attribute. In this case, the operation

processor (currently dispatcher) will find these "typeless" parameters

and convert them to the correct type based on the method definition.

The result is that if the client specifies the parameter type in the

XML encoding (as the Pegasus client API does), the method provider

will receive the type specified by the client; if the client does not

specify the parameter type, the method provider will see the type

specified in the method definition.

CLIENT IMPLICATIONS:

Clients ARE affected by this change. Any output parameters that are

returned from Pegasus (or other CIM servers using the PARAMTYPE

attribute) will now be received by Pegasus clients as the same type

sent by the server. Previously, they would have always been of

String type. In addition, the return value will be received as the

correct type rather than as a String.

Parameters coming from servers other than Pegasus may omit the

PARAMTYPE attribute. In this case, the client will see a

CIMParamValue with type==CIMType::NONE, with a CIMValue of type

String. Similarly, return values coming from other servers that omit

PARAMTYPE will be seen by the client as String type. These return

values will NOT have the CIMType::NONE hint that parameters get,

because they are CIMValues rather than CIMParamValues.

This behavior will remain for the forseeable future (through

Pegasus version 2), as it is not possible to require that other

implementations use the PARAMTYPE attribute.

SIDE EFFECTS:

In the process of implementing this functionality, I discovered

that there was no way to set a CIMValue to be an array of

CIMReferences. This appeared to be an oversight, since method

parameters are permitted to be arrays of CIMReferences. I've

added the necessary functionality to the CIMValue class.

I also found that the CIMParamValue class needed significant

clean-up, which I completed.

SETPROPERTY CHANGES:

A similar problem in SetProperty operations was addressed by

"typing" the specified property value in the operation processor

(currently dispatcher). This is achieved by looking up the

relevant schema to get the property definition, and then converting

the specified value to that property's type.

The SetProperty operation encoding has not changed to accomodate

inclusion of type information that would obviate the need for this

extra processing. However, clients can avoid this overhead by using

ModifyInstance operations (with a property list) instead of SetProperty.

The GetProperty operation also has NOT been updated with type

information. Client applications using the Pegasus client API will

always receive String or reference values when calling GetProperty

against any server (Pegasus or not). Clients that require properties

to be returned as the correct type must use GetInstance (perhaps with

a property list) rather than GetProperty.

13. (Roger Kumpf - HP) 22 Feb 2002 - Reworked the CIMParamValue class.

Instead of being composed of a CIMParameter and a CIMValue, this

class is now composed of a String (parameter name) and a CIMValue.

This change removes the redundancy of having the type, isArray,

and arraySize members in both the CIMParameter and the CIMValue.

The new CIMParamValue definition is more consistent with the XML

encoding of parameter values.

An isTyped member was also added to CIMParamValue to support the

behavior outlined in item 12 above. Clients should use the isTyped()

method to determine whether the output parameters returned from

InvokeMethod operations are of the correct type, or whether they

have defaulted to String type.

14. (KS) 4 March 2002 - Corrections for NULL value and the XML code.

Corrections to compiler for Null values input (parser and valuectory)

15. (Nag Boranna - HP) 04 March 2002 - Modified CIMClient API to accept

username and password as parameters to connect() method, added a new

method diconnect() that closes the open connection with the server

and added code to handle HTTP Basic authentication challenges from

the server.

16 (KS) 4 March 2002 - Correct problem with array constants not picking up

all of the entires in the array. Bugzilla bug # 6.

17. (Yi Zhou - HP) 4 March 2002 - Implemented provider registration manager

to perform efficient lookup of instance provider, method provider, and

indication provider. Also, implemented provider registration instances

operations.

Modified registration provider to use latest provider registration schema.

18 (KS) 6 March 2002 - Implemented changes to compiler and flavors to correct the

definition of CIMFlavors.

19. (Roger Kumpf - HP) 1 Mar 2002 - Reworked the XmlWriter class to

eliminate many of the redundant memory copies that resulted from the

nested method call structure. Now, instead of having a method at

each level that adds a begin tag, contents, and an end tag, there

are separate methods to add the begin and end tags. At the top

level, each of the begin tag methods are called, then the message

"body" is added, followed by calls to the end tag methods.

The message body is currently still copied twice, once into the XML

payload and then again when the HTTP header is added. (Since the

HTTP header contains a content length field, the header cannot be

constructed until the payload is complete.) It is possible to

remove these extra copies as well, but that would require additional

changes elsewhere in the code. For example, the HTTPMessage class

would need to hold the headers and payload separately rather than in

a single buffer.

Along with these changes, I did a lot of cleanup. Much of the XML

formatting code has been moved from CIMReference to XmlWriter. Also,

error message formatting has been consolidated in XmlWriter from the

various encoders and decoders, etc.

20. (Roger Kumpf - HP) 5 Mar 2002 - Added checks in the

CIMOperationRequestDecoder and CIMExportRequestDecoder to validate

that the information in the HTTP headers of a request is consistent

with what is encoded in the XML request itself.

Specifically, the CIMOperation, CIMProtocolVersion, CIMMethod,

CIMObject, CIMBatch, CIMExport, and CIMExportBatch headers are

validated.

21. (KS) 7 March 2002 - Correct error in qualifier propagation processing in

qualifierlist.resolve. Temporarily remove the DEFAULT setup on the

Compiler qualifier generation. Add tests for resolve processing.

-------------------------------------------------------------------

Version 1.06 working towards 1.1 Started 13 December 2001

1. Merged back to Main branch. All general development will be in main branch

in the future with releases in side branches. Special side developments

may temporarily be in side branches.

Changed cimversion to 1.06. We will do 1.1 based on functionality.

2. (Karl) 18 December 2001 - Added new directory repositories where repository

implementations will be kept to separate them from the

repository interface defintion. Initial implementation is genericfile

which is the current file based repository.

Added new build variable RMREPOSITORY which is a generic MAKE command

to remove an existing repository. It simply substitutes for the RMDIRHIER

command at this point but we will make this a generic part of system

in the future.

3. (Roger Kumpf - HP) 18 Dec 2001 - Updated the CIMOperationRequestDecoder

to check that all required parameters for intrinsic methods are

present. If a required parameter is missing, a CIM_ERR_INVALID_PARAMETER

exception is thrown. Also added checks for duplicate parameters in the

intrinsic methods. If a parameter is specified more than once, a

CIM_ERR_INVALID_PARAMETER exception is thrown.

4. (Nag Boranna - HP) 14 Jan 2002 - Created CIMOperationRequestAuthorizer queue

and moved Authorization verification code from CIMOperationRequestDecoder

queue to this new queue. Modified CIMServer.cpp to create

CIMOperationRequestAuthorizer queue only when authorization is enabled.

Also modified CIMRequestMessagesin CIMMessage.h to include userName to make

it available to the CIMOperationRequestDispatcher.

5. (Mary Hinton - Jan 17, 2002) Fixed the problem with the CIMserver when it

runs as a Windows service. The work thread was exiting instead of running

forever. The problem was noticed when the TestClient program and CIMserver

service were both running. The service wasn't accessible to the TestClient

program.

6. (Nitin Upasani - Jan 25, 2002) Operations on CIM_IndicationSubscription,

CIM_IndicationHandlerCIMXML and CIM_IndicationFilter classes will be now processed

in new queue, IndicationService which will get invoked from dispatcher.

CIM_CREATE_INSTANCE_REQUEST_MESSAGE

CIM_MODIFY_INSTANCE_REQUEST_MESSAGE

CIM_DELETE_INSTANCE_REQUEST_MESSAGE

CIM_GET_INSTANCE_REQUEST_MESSAGE

CIM_ENUMERATE_INSTANCES_REQUEST_MESSAGE

CIM_ENUMERATE_INSTANCE_NAMES_REQUEST_MESSAGE

This new service will also take care of processing the indications on receiving

CIM_PROCESS_INDICATION_REQUEST_MESSAGE. This message should come from

IndicationProvider or some other mechanism which is not yet clear.

IndicationService will also receive following messages from PG_ProviderRegistration

when a new IndicationProvider will get registered.

CIM_NOTIFY_PROVIDER_REGISTRATION_REQUEST_MESSAGE

CIM_NOTIFY_PROVIDER_TERMINATION_REQUEST_MESSAGE

I had also defined new Indication Provider APIs, enableIndication, disableIndication

and modifyIndication with more parameters passed and eventually planning to terminate

old APIs (provideIndication, cancelIndication and updateIndication). Also there is a

plan to implement one more call as startIndication and will be done soon.

There are three new test programs in IndicationService directory, which will create

Filter, Indication and Subscription instances using IndicationService.

Also modified sample IndicationProvider code with the new APIs introduced.

-------------------------------------------------------------------------

Version 1.1.1 - 3 August 2001 - Development Branch (Work in Progress)

current working dev branch of build

---------------------------------------------------------------------------

Version 1.1 - July 2001 Development branch (Work in PRogress)

1. (Mike Brasher) Fixed bug with XML generation (was not generating

PARAMETER.REFERENCE constructs for references).

2. (Mike Brasher) Reworked server communication into new module scheme.

=======

1. (Karl) 6 Aug - extend ToMof functions. The MOF for a class can now be

seen as part of CGIclient class displays.

Line 445

Line 729

operations. Note that GetProperty and SetProperty currently only

work for String properties because of an XML encoding limitation.

53. (Nag Boranna - HP, Sushma Fernandes - HP) 30 Nov 2001 - Implemented the

Security components for authentication and authorization.

Authentication and User Management:

cimuser CLI : This CLI is used for addition, modification, removal

and listing of CIM Users. The CIM user password is encrypted and stored

in a file. The password file format is compatible with Apache's htpasswd

generated password file.

cimauth CLI implement the authorization managment functionality by letting

to add/remove/list user authorizations.

User Manager and User Manager Provider components implement the user

management and authorization functionality.

54. (Mike Brasher - BMC) 3 Dec 2001 - Added support for WQL-1. New directory

under src/Pegasus/WQL which contains library and BNF.

55. (Yi Zhou - HP) 03 Dec 2001 - Implemented Pegasus registration provider

which does provider registration, block, unblock, and stop a provider.

It also alert Subscription Service of any provider registration changes.

56. (Rudy Schuet - Compaq) 04 Dec 2001 - Replaced _min macro in String.h

and String.cpp with PEG_min. The _min macro caused problems on the

NSK platform because of a duplicate definition in a standard file.

57. (Carol Ann Krug Graves - HP) 04 Dec 2001 - Implemented Pegasus indication

subscription service provider that serves as the instance provider for the

CIM_IndicationSubscription, CIM_IndicationFilter and CIM_IndicationHandler

classes (from CIM_Events27.mof). The service also takes appropriate action

in response to startup, shutdown of the cimom, termination of a provider,

or change in provider registration.

58. (Jenny Yu - HP) 05 Dec 2001 - Implemented Pegasus Shutdown Service

and the command line interface for shutting down cimom gracefully.

For more information, refer to the CIMOM Shutdown working paper

in pegasus/doc/WorkPapers/CIMOMShutdown.pdf.

59. (Markus Mueller - IBM) 06 Dec 2001 - Implemented SSL support (Linux only).

It consists the new classes SSL_Context, SSLSocket and MP_Socket defined

in TLS.h. HTTPAcceptor and HTTPConnector are extended with an additional

constructor to set a pointer to the server-, resp. client wide SSL_Context

structure. The Socket field in HTTPConnection is substituted with an

MP_Socket pointer, a class that is designed to hide the differences

between Socket and SSLSocket. The MP_Socket (multipurpose socket) class

is defined even in a non-ssl environment.

How to use it in a Server or Client:

1. Just create an SSL_Context once per Server/Client address space

2. Construct every HTTPConnector/Acceptor with a pointer to this

SSL_Context if you want to enable SSL; construct Connectors/Acceptors

without SSL_Context for conventional connections.

The Configuration data was extended with the boolean SSL property, and

cimserver and TestClient now understand the -SSL, resp. -ssl flag.

60. (Bapu Patil - HP) Updated makefiles to support HP-UX IA64 bits O.S.

---------------------------------------------------------------------------

Version 1.1 - July 2001 Development branch

Tagged as version_1_01 on 3 August 2001 (sorry should have been

Line 502

Line 843

When authentication framework is defined this component may need to be

modified to integrate with the framework.

8. (Sushma Fernandes - HP) Removed the ltoa() function call from Tracer.cpp.

Added a constant to define the maximum length of uint32.

---------------------------------------------------------------------------

Version 0.99.x (Fixes to version 0.99) in Process

Legend:

Removed from v.1.49.2.57
changed lines
	Added in v.1.76

No CVS admin address has been configured