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.6 and 1.7

version 1.6, 2001/05/22 12:48:06

version 1.7, 2001/05/24 00:48:34

Line 2

Author: Mike Brasher, Karl Schopmeyer

Version 0.97

May 20 2001

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

$Log$

Revision 1.6 2001/05/22 12:48:06 karl

change install and ACE comments

Revision 1.5 2001/02/26 10:36:34 karl

Clean Up Text

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

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 by The Open Group

Overview:

=========

Pegasus is an open-source object manager for DMTF CIM objects. It is written

in C++ and includes the Object manager, a set of defined interfaces, and SDKs

for both client, providers, and services extensions. It is maintained

Line 66

Line 42

http://www.opengroup.org/MSB

Availability of Pegasus

Availability of Pegasus:

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

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

Pegasus is distributed as open source. Today the distribution is limited

because we want to reach a predefined level of development before making the

Line 83

Line 59

k.schopmeyer@opengroup.org

Pegasus Major Components

Pegasus Major Components:

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

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

The major components of Pegasus are:

Line 121

Line 97

Pegasus MOF Compiler - FA standalone compiler for MOF files that can be used

to install MOF into the Pegasus schema repository and also to check syntax

Pegasus Dependencies

Pegasus Dependencies:

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

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

We have worked to minimize the dependence of Pegasus on other software

packages and tools. Currently Pegasus has the following dependencies

1. To simplify the building of Pegasus across multiple platforms we have

1. GNUMAKE - To simplify the building of Pegasus across multiple platforms we

standardized on a set of build tools including: GNUMAKE. We are using GNUAKE

have standardized on a set of build tools including: GNUMAKE. We are using

4.79.1 successfully both in Windows and Linux environments.

GNUAKE 4.79.1 successfully both in Windows and Linux environments.

GNUMAKE is available from

Line 137

Line 113

ATTN: I think we need to make our version available on the TOG site.

COMMENT: Unless other users of Pegasus demand it, we will NOT create any build

COMMENT: Unless other users of Pegasus demand it, we will NOT create

environment for Pegasus that does not require GNUMAKE (e.g., Visual C++). We

any build environment for Pegasus that does not require GNUMAKE (e.g.,

are open to other developers who want to contribute other build structures for

Visual C++). We are open to other developers who want to contribute

particular environments.

other build structures for particular environments.

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

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

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

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

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

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

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

effectively provides the functions of these utilities that GNUMAKE needs.

and effectively provides the functions of these utilities that GNUMAKE

MU is not required on UNIX or LINUX platforms.

needs. MU is not required on UNIX or LINUX platforms.

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

Line 163

Line 138

these tools.

4. DOC++ - The Pegasus documentation is taken from a combination of text files

and the Pegasus header files themselves. This documentation is formatted with

and the Pegasus header files themselves. This documentation is formatted

DOC++ and GAWK. These tools are required if the documentation is to be

with DOC++ and GAWK. These tools are required if the documentation is to

recreated but we expect that only the core team will be recreating

be recreated but we expect that only the core team will be recreating

documentaiton.

5. ACE_Wrappers communication package (NOTE: The ACE Wrappers dependency has

been removed. Effective version 0.9 Pegasus is not dependent on ACE Wrappers)

- The ACE Wrappers package is used for

communication and some low level functions within the MSB, the Pegasus client

SDK, and the Pegasus Provider SDK. ACE is available from the following site.

http://ace.cs.wustl.edu/cvsweb/ace-cvs.cgi/ACE_wrappers/

Currently we are using version 5.1 of ACE_Wrappers both in Linux and Windows.

http://www.cs.wustl.edu/~schmidt/ACE_wrappers/ACE-5.1.tar.gz

COMMENTS: Pegasus only uses limited facilities from ACE. We actively

discourage the Pegasus team from using other functions of ACE. We expect to

eliminate our dependence on ACE as the only TCP tool in the near future.

However, today Pegasus demands the installation of the complete ACE library.

One of the action items for the future is to provide a more limited ACE

library and possibly even to provide an environment independent of ACE.

The Pegasus Directory Structure

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

Line 249

Line 205

Service Extensions

Servers - Today the server executable is built from /server/test.

Installation

Installation:

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

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

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

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

and use it. Pegasus currently compiles and runs under Linux, AIX, HPUX,

NT environments.

Windows NT, and Windows 2000.

The installation of Pegasus involves expanding the snapshot distribution

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

repository.

Building from a Distribution --- General

Building Pegasus:

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

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

1. Check that you have requisite programs (listed in Pegasus Dependencies).

These include GNU Make, MU.EXE, Flex, and Bison

Be sure these are on your path.

2. Define the following two environment variables:

PEGASUS_HOME - to point to a directory to contain output binary files

(e.g., set it to $HOME/pegasus_home).

PEGASUS_PLATFORM - this must be set to a supported platform identifier.

The following are supported:

WIN32_IX86_MSVC

LINUX_IX86_GNU

AIX_RS_IBMCXX

HPUX_PARISC_ACC

This identifier has the following form:

<Operating-System>_<Architecture>_<Compiler>

Pegasus is buildable and runnable on either Linux or WIndows Platforms today.

Note: if you plan on doing parallel builds, you might consider setting

It uses a common build system for the two platforms based on build files in

PEGASUS_HOME to something like this:

each directory, a recursive build strucutre to execute the multiple makes and

GUNMAKE.

Generally we support the followingtargets in our make system:

$HOME/pegasus_home_LINUX_IX86_GNU

C:\> make clean - Clean out all objects, libs, and executables

That way, the output of each build will be placed in its own directory.

C:\> make depend - Create the dependencies

C:\> make

3. Now place $PEGASUS_HOME/bin on your path

C:\> make tests - Execute all tests except client server tests

C:\> make rebuild - Clean and rebuild including the respository

and

C:\> make world

Placd $PEGASUS_HOME/lib on your LD_LIBRARY_PATH (for Unix only).

4. Now change to the root of the Pegasus distrubution and type "make"

(where make referes to GNU make).

5. To test the build type "make tests".

The following make targets are supported:

<default> - Build everything.

clean - Clean out all objects, libs, and executables.

depend - Create the dependencies.

tests - Execute all tests (except client server tests).

rebuild - clean, depend, <default>

world - depend, <default>

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

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

Line 284

Line 275

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

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

each platform see the appropriate sections below:

Line 312

Line 302

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

Build Variables

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

The build system depends on the following environment variables build set.

These variables must be set as part of the installation of the Pegasus source

tree before you can compile or run Pegasus.

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

on any platform except windows you must change this before initiating

make.

PEGASUS_ROOT - Root directory of the Pegasus source tree.

PEGASUS_HOME - Home directory for all of the Pegasus runtime elements.

If this does not exist, $PEGASUS_ROOT$/build is assumed.

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

setting these variables today is manual.

The MU Utility

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

Line 360

Line 330

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

of the distribution of Pegasus.

Building Pegausu on Linux

Notes about Building Pegasus 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 distribution. For example

IMPORT PEGASUS_ACE_ROOT=\local\ACE_Wrappers

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

3. Define an environment variable PEGASUS_ROOT that points to the

root of the Pegasus Distribution

4. Define the environment variable PEGASUS_HOME where you want the

runtime elements (executables, objects, libraries, etc.) to go.

5. Unpack the ace distribution.

6. Append %PEGASUS_ROOT%/bin to your path

7. From the %PEGASUS_ROOT% directory build using the make commands

defined in the section on General Build.

make world

ATTN: put something here (but only what is not mentioned above).

make tests

Building Pegasus on NT or Windows 2000 With Microsoft Visual C++

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

Line 397

Line 343

versions 5 and 6) and the GNUMAKE make utility. The following is the basic

set up steps for the

Setup the environment variables and path for the Micrososft Visual C

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

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

Installing the Pegasus HTML Test Client:

root of the ACE_Wrappers distribution. For example:

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

C:\> set PEGASUS_ACE_ROOT=c:/ACE_wrappers

Now append %ACE_ROOT%/bin to the path like this:

C:\> set path=%path%;%PEGASUS_ACE_ROOT%/bin

3. Define an environment variable called PEGASUS_ROOT that points to

the root of the Pegasus distribution. For example:

C:\> set PEGASUS_ROOT=c:/pegasus

4. Setup the PEGASUS_HOME environment variable

set PEGASUS_HOME=c:/PegasusRun

Now append %PEGASUS_HOME%/bin to your path like this:

set path=%path%;%PEGASUS_HOME%/bin

5. Unpack and build the ACE_Wrappers distribution for windows.

As an example, we created a file called %ACE_ROOT%/ace/config.h

containing the following:

#include "ace/config-win32.h"

and then opened this DSW file in MSVC++ IDE:

%ACE_ROOT%/ace/ace.dsw

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

complaint.

The ACE package can be built in several configurations:

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.

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

builds.

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

6. Unpack the Pegasus distribution. On Windows systems, PKzip25 or

WINZIP can be used. Be certain to use the option that expands the

directory tree of the files. This expansion will create a directory

called ./pegasus

If you are using pkzip25.exe do this:

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

This will create a directory tree called ./pegasus under the

current directory.

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

general build section for the full set of make commands.

This builds Pegasus and all of its examples.

7. To verify that it built okay, run the tests

make tests

Installing the Pegasus HTML Test Client

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

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

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

Line 485

Line 357

instructions for setting up this environment are maintained in a separate

readme in the CGI directory.

Development with Pegasus and Pegasus Tools

Development with Pegasus and Pegasus Tools:

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

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

ATTN: This section needs to be completed. It should reference the more

complete documentation

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

Documentation:

Documentation

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

The documentation is currently in preperation. The preliminary documentation

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

Line 506

Line 378

Participate!

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

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

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.6
changed lines
	Added in v.1.7

No CVS admin address has been configured