pegasus/Attic/readme.txt - diff

Return to readme.txt CVS log

Up to [Pegasus] / pegasus / Attic

Diff for /pegasus/Attic/readme.txt between version 1.3 and 1.4

version 1.3, 2001/01/22 15:09:29

version 1.4, 2001/01/26 20:20:36

Line 2

Author: Mike Brasher, Karl Schopmeyer

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

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

$Log$

Revision 1.4 2001/01/26 20:20:36 karl

Clean up Readme with MB comments

Revision 1.3 2001/01/22 15:09:29 mike

Reworking indentation and breaking width of lines below 80 columns (not finished). Also

Reworking indentation and breaking width of lines below 80 columns (not

finished). Also

inserted comments and suggestions following "MEB:" annotations.

Revision 1.1 2001/01/15 04:26:04 karl

added Readme

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

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

Tagline: Pegasus is an object manager for DMTF CIM objects written in C++

and supported buy The Open Group

Line 138

Line 144

3. MU.EXE - To minimize the difference between Linux and Windows for GUNMAKE,

we have created a utility called MU.exe. The source for this is available

we have created a utility called MU.exe. This utility is required for Pegasus

with the distribution and the binary is distributed in the bin directory of

make with Windows environment. It is provided as an alternative to requiring a

the the snapshots for now.

number of UNIX utilities (SH, RM, etc.) on the windows platform and

effectively provides the functions of these utilities that GNUMAKE needs.

[MEB: the binary for MU.EXE is not distributed in the bin directory; you

MU is not required on UNIX or LINUX platforms

have to build it at this time]

NOTE: The binary for MU.EXE is not distributed in the Pegasus bin directory.

You must build it separately. MU source code is part of the distribution

in the directory src/utils/MU with its own make file. You must compile MU

before you initiate the Pegausu make.

[MEB: MU.EXE is only needed on Windows]

NOTE: We will make a copy of the binary available on the MSB WEB site to

eliminate the requirement to build this utility.

[STOPPED]

The Pegasus Directory Structure

Line 158

Line 167

This structure is generally as follows

Pegasus Root directory

Pegasus Pegasus Root directory

bin

build Destination for all intermediate files from build

bin Destination for executable and DLL modules from

Pegasus build

lib

lib Destination for Pegasus LIB modules

obj

obj Destination for object modules

cgi-bin Source and make for the Pegasus WEB Based Test client software

cgi-bin Source for the Pegasus WEB Based Test client

doc Miscelaneous Pegasus Documents. Includes the DMTF XML for CIM 2.4

doc Miscelaneous Pegasus Documents.

DevManual Source and build files for developes manual

html HTML files for the Browser test client.

mak General make files (used by the root make and other makes)

mak General make files (used by other makes)

Repository This Directory containes the created repository

src All Pegasus Source Files

ACEExamples Test directrory with examples of the use of ACE (developers)

ACEExample Test directrory with examples of the use of ACE

Clients Source for various test clients and client SDK

CGICLIENT Pegasus test client that uses a WEB browser

Pegasus

CGI CGI files for the WEB test client

Client Pegasus Client API Tests

CGIClient

Client Pegasus Client SDK and Test client using the SDK

depends

tests

Common Pegasus Common Functions (C++ source and headers

tests Test programs for the common functions

Protocol Pegasus Client HTTP/XML Protocol Modules

depends

Repository Pegasus Repository Interfaces and Simple Repository

Provider Pegasus Provider interface functions

Repository Pegasus Repository Interfaces and Simple

Repository

tests Tests for Repository Functions

Server Pegasus Server Modules

depends

Providers Pegasus Provider SDK and tes providers

tests

Utils

manual Pegasus User/developer manual source modules

html Output from the Pegasus Manual compilartion.

HTML Output from the Pegasus Manual compilartion.

In the near future we will add directories for:

Service Extensions

Providers

Installation

============

Pegasus today is provided only as a source distribution. You download compile and use it.

Pegasus today is provided only as a source distribution. You download compile

Pegasus currently compiles and runs under both Linux and Windows NT environments.

and use it. Pegasus currently compiles and runs under both Linux and Windows

NT environments.

The installation of Pegasus involves expanding the snapshot distribution files, building the

runtime, the test files and test clients, and building the repository.

The installation of Pegasus involves expanding the snapshot distribution

files, building the runtime, the test files and test clients, and building the

NOTE: Since the compiler integration is not complete today, the class repository is populated

repository.

from the XML defintions for the complete CIM schema. This process is included in the build

process so that at the end of a complete build, the class repository is completely populated

NOTE: Since the compiler integration is not complete today, the class

from the CIM 2.4 release schema.

repository is populated from the XML defintions for the complete CIM schema.

This process is included in the build process so that at the end of a complete

build, the class repository is completely populated from the CIM 2.4 release

schema.

Building from a Distribution --- General

Line 228

Line 237

C:\> make

C:\> make tests

The Pegasus Client server tests are executed separately from the above because they require

The Pegasus Client server tests are executed separately from the above because

the initiation of separate process for the Pegasus server and Pegasus client. These tests can

they require the initiation of separate process for the Pegasus server and

be executed as follows:

Pegasus client. These tests can be executed as follows:

ATTN: Add the procedure for Client/Server Test start here.

For information on particular installation characteristics, tools, etc. for each platform see

For information on particular installation characteristics, tools, etc. for

each platform see

the appropriate sections below:

Generally the build commands are as follows:

1. There is a Makefile in the Pegasus root. Simply executing make in the Pegasus

1. There is a Makefile in the Pegasus root. Simply executing make in the

root directory will make everything.

Pegasus root directory will make everything.

2. In order to provide a working class repository for Pegasus until the MOF compiler

2. In order to provide a working class repository for Pegasus until the

is integrated, There is a utility to load the CIM Schema from XML into the repository.

MOF compiler is integrated, There is a utility to load the CIM Schema from

This executes the LoadRepository executable which is defined in

XML into the repository. This executes the LoadRepository executable which

is defined in

pegasus/src/Pegasus/Repository/tests/LoadRepository

with the binary in pegasus/bin. This program will load the CIM XML repository

with the binary in pegasus/bin. This program will load the CIM XML

definitions into the class repository.

repository definitions into the class repository.

3. To test a fresh release, go to the pegasus root and type

Line 271

Line 282

Running "make -s tests" suppresses extraneous output such as the

enter/leave directory messages.

6. "Make Clean" removes all object and library files from the

6. "Make Clean" removes all object and library files from the structure.

structure.

Build Variables

===============

The build system depends on the following environment variables

PEGASUS_ACE_ROOT - required (points to ACE_wrappers directory). This must be set

PEGASUS_ACE_ROOT - required (points to ACE_wrappers directory). This must

before you initiate make

be set before you initiate make

PEGASUS_BUILD - optional (points to build directory; defaults to build

directory under root of pegasus distribution). This must be set before you iniiate

directory under root of pegasus distribution). This must be set before you

iniiate

make

PEGASUS_OS_TYPE - optional. The is currently set to windows. If you build on Linux

PEGASUS_OS_TYPE - optional. The is currently set to windows. If you build

you must change this before initiating make.

on Linux you must change this before initiating make.

PEGASUS_ROOT - Points to the root directory of the Pegasus tree.

COMMENTS: In the future, we will probably automate this more. However, setting these

COMMENTS: In the future, we will probably automate this more. However,

variables today is manual.

setting these variables today is manual.

The MU Utility

==============

In order to provide a consistent build structure across multiple platforms, we developed a

In order to provide a consistent build structure across multiple platforms, we

small utility to provide a consistent set of small utilities across these platforms. The MU

developed a small utility to provide a consistent set of small utilities

utilityis a simple utility that contains many commands. For example:

across these platforms. The MU utilityis a simple utility that contains many

commands. For example:

C:\> mu rm myfile.cpp yourfile.cpp

Line 317

Line 331

C:\> mu rm *.obj *.exe

MU is required to build under the Windows environment.MU is available as part of the

MU is required to build under the Windows environment.MU is available as part

distribution of Pegasus.

of the distribution of Pegasus.

Building Pegausu on Linux

=========================

1. Obtain, unpack and build the ACE_Wrappers package for Linux.

2. Define an environment variable called ACE_ROOT that points to the root of the ACE_WRAPPERS

2. Define an environment variable called ACE_ROOT that points to the root of

distribution. For example

the ACE_WRAPPERS distribution. For example

IMPORT ACE_ROOT=\local\ACE_Wrappers

IMPORT PEGASUS_ACE_ROOT=\local\ACE_Wrappers

ATTN: Mike. what is a viable directory for Linux (what do you use)

Line 355

Line 369

set up steps for the

1. Setup the environment variables and path for the Micrososft Visual C compiler.

1. Setup the environment variables and path for the Micrososft Visual C

Typically this can be done by running the VCVARS32.BAT file supplied with Microsoft Visual

compiler.

Typically this can be done by running the VCVARS32.BAT file supplied with

Microsoft Visual

C++. (contained in the same directory as cl.exe).

2. Define an environment variable called ACE_ROOT that points to the

Line 388

Line 404

%ACE_ROOT%/ace/ace.dsw

From the build menu we picked "aced.dll". For me it built without complaint.

From the build menu we picked "ace.dll". For me it built without complaint.

BUG: there is still one open problem that has not been resolved. With

The ACE package can be built in several configurations:

the Visucal C++ version 6 compiler, the ace libraries default to

acemfc.dll

ace.dll - The basic package without debugging

aced.dll - debugging added to the basic package

acemfc.dll - ACE with Microsoft MFC support

acemfcd.dll - The ACE MFC version with debugging.

With the version 5 visual C, apparently they default to the names

ace.dll is used for the server build acemfc is used for the client builds.

ace.dll

aced.dll (debug verions

We will correct this in a future snapshot.

NOTE: In the near future we will be building debugging options into Pegasus

and at that time the aced and acemfcd libraries will also be required.

Each library can be built separately from Microsoft Visual C++.

5. Unpack the Pegasus distribution. On Windows systems, PKzip25 or WINZIP can be used.

5. Unpack the Pegasus distribution. On Windows systems, PKzip25 or WINZIP can

Be certain to use the option that expands the directory tree of the files. This expansionwill

be used. Be certain to use the option that expands the directory tree of the

create a directory called ./pegasus

files. This expansion will create a directory called ./pegasus

If you are using pkzip25.exe do this:

C:\> pkzip25 -extract -recurse -directories pegasus.zip

Line 416

Line 432

ATTN: Define for Linux also

6. Change directory to %PEGASUS_ROOT% and type "make world". See the general build section

6. Change directory to %PEGASUS_ROOT% and type "make world". See the general

for the full set of make commands.

build section for the full set of make commands.

This builds Pegasus and all of its examples.

Line 428

Line 444

Installing the Pegasus HTML Test Client

=======================================

This is a separate test tool that allows Pegasus requests to be initiated from any WEB browser

This is a separate test tool that allows Pegasus requests to be initiated from

and that uses a WEB browser, CGI scritps and HTML pages for the formating and connections. It

any WEB browser and that uses a WEB browser, CGI scritps and HTML pages for

requires a WEB server, etc. The instructions for setting up this environment are maintained

the formating and connections. It requires a WEB server, etc. The

in a separate readme in the CGI directory.

instructions for setting up this environment are maintained in a separate

readme in the CGI directory.

Development with Pegasus and Pegasus Tools

==========================================

Line 442

Line 459

===================

Documentation

The documentation is currently in preperation. The preliminary documentation is not provided

The documentation is currently in preperation. The preliminary documentation

with this snapshot but is avialable from the OpenGroup Pegasus WEB pages. The current

is not provided with this snapshot but is avialable from the OpenGroup Pegasus

documentation is maintained both as a manual created under the tool DOC++ in the

WEB pages. The current documentation is maintained both as a manual created

subdirectory manual/html and as other miscelaneous documentation in the doc directory.

under the tool DOC++ in the subdirectory manual/html and as other miscelaneous

documentation in the doc directory.

Note that the Pegasus WEB site at The Open Group will be the source of most documentation in

the future and today is the source of most discussion and design documentation.

Note that the Pegasus WEB site at The Open Group will be the source of most

documentation in the future and today is the source of most discussion and

design documentation.

Participate!

============

We are looking for people who want to join the effort of getting this

We are looking for people who want to join the Pegasus work group and

next release off the ground. Please send me email for details.

contribute to effort of getting this Pegasus off the ground. Please send

email for details to k.schopmeyer@opengroup.org or m.kirk@opengroup.org or

m.brasher@opengroup.org

Legend:

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

No CVS admin address has been configured