--------------------------------------------------------------------
|                                                                  |
| PROGRES - An integrated environment and very high level language |
|           for PROgrammed Graph REwriting Systems.                |
|           RESEARCH PROTOTYPE                                     |
|                                                                  |
| Copyright (C) 1991-98  Lehrstuhl Informatik III, RWTH Aachen     |
|                                                                  |
| Version      :  9.2                                              |
| Release Date :  December 1998                                    |
|                                                                  |
| This release is available for Solaris 2.x and Linux machines!    |
|                                                                  |
| The release comprises two parts:                                 | 
|  - progres-common-9.2.tar.gz contains the os independent parts   |
|    of the release, i.e. this part is needed for every            | 
|    installation.                                                 |
|  - progres-solaris-9.2.tar.gz is needed if you want to run       |
|    PROGRES on Solaris2.x machines.                               | 
|  - progres-linux-9.2.tar.gz is needed if you want to run         |
|    PROGRES on Linux machines.                                    |
| You may of course install all three parts and use them at the    |
| same time.                                                       |
|                                                                  |
| The latest release (9.2) is available via ftp from:              |
|    ftp-i3.informatik.rwth-aachen.de   (137.226.168.10)           |
|           in directory: pub/PROGRES                              |
| and from:                                                        |
|    ftp.qucis.queensu.ca               (130.15.1.93)              |
|           in directory: pub/PROGRES                              |
|                                                                  |
| PROGRES Homepage:                                                |
|  http://www-i3.informatik.rwth-aachen.de/research/progres/       |
|                                                                  |
| Distribution of release announcements:                           |
|  via graph grammar mailing list (see README file)                |
|                                                                  |
--------------------------------------------------------------------

The PROGRES Release
===================

The main tar-file of the release contains the following files and
directories:

	README		this file
        .<files>	a number of examples for window manager
			configuration files etc.
	bin		for all executable files (not graph browser)
        browser		for all graph browser executables etc.
	data		for all user modifiable data and examples
        etc		place for additional configuration files
	import		sources and o-files of external type def.
	lib		for (dynamic) libraries (Interviews etc.)
	man		for information files
	prototype	templates etc. for prototype generation


Installation Procedure
======================

You have to start with transfering the tar-files

	progres-common-9.2.tar.gz
    and
	progres-solaris-9.2.tar.gz
    or: progres-linux-9.2.tar.gz

        (depending on which system you have)

to your site. Currently, it is only avaible via anonymous
ftp from 

	ftp-i3.informatik.rwth-aachen.de (137.226.168.10)
        in directory pub/PROGRES
        (site location: Aachen, North-Rhine-Westfalia, Germany)

and from

	ftp.qucis.queensu.ca (130.15.1.93)
        in directory pub/PROGRES 
        (site location: Kingston, Ontario, Canada).

The following instructions create a new directory "progres" with the
above mentioned files and subdirectories:

	gunzip progres-common-9.2.tar.gz
	tar -pxvf progres-common-9.2.tar

	gunzip progres-solaris-9.2.tar.gz
	tar -pxvf progres-solaris-9.2.tar

        (or "linux" instead of "solaris" where applicable)

In the case of more than one user of the PROGRES environment at your
site please create ONE account or directory containing all delivered
files with read/execute permissions for all PROGRES users.

Depending on the hardware platform you wish to run PROGRES on, you
will need either the Solaris or the Linux part of the release,
too. Please unpack it to the same location as the common part.

Every user of the PROGRES environment should use an adapted version
of the delivered script ".progres.cshrc" to initialize required
environment variables appropriately (especially the variable
$PROGRESROOT, which should point to the root of the progres directory
tree at your site).

Furthermore, you have to create a file with needed "trusted host
information" for the underlying database system GRAS (which is part
of the PROGRES release). You have the following options:

1) All PROGRES processes are running on the same workstation (you
   may get swap space problems resulting in heap overflow or
   segmentation fault messages): 
   In that case you have to check whether starting remote shells
   using the symbolic name "localhost" is possible in your account.
   Test this using the command

	rsh localhost echo "anything"

   which should simply print "anything" on standard output and not
   an error message! If returning an error message then insert an
   appropriate line into your $HOME/.rhosts file.
   
2) All PROGRES users on your site may start PROGRES processes on 
   any workstation out of a set of "trusted" hosts:
   In that case create an appropriate file ghosts in directory
   $PROGRESROOT/etc (cf. file $PROGRESROOT/etc/README), which
   contains the list of permissible workstations.

3) A PROGRES user has specific preferences where to start PROGRES
   database system processes (and where not):
   In that case create an own directory $HOME/progresdata/etc with a
   private version of the file ghosts.

Test the installation of the database system GRAS by calling
first 

	$PROGRESROOT/bin/StartGanimed 

(starts the central control process of GRAS) and then 

	$PROGRESROOT/bin/StopGanimed.

Finally, start the PROGRES environment itself by calling the script 

	$PROGRESROOT/bin/Progres.

For more detailed information please read the document GUIDED_TOUR
in $PROGRESROOT/man.

Do not forget to SUBSCRIBE to the graph grammar mailing list so
that announcements of new releases are propagated to you!


Copyright Remarks
=================

PROGRES bears no relation to the database and application development
tool PROGRESS, produced by PROGRESS Software Corporation (or any
other product with name PROGRESS).
 
It is a research prototype available as binary code only for Linux and
Solaris 2 workstations. The source code will be made available upon
request under the terms of the GNU Library General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.

But note that a large number of different free software libraries,
compilers, and generator tools have been used for producing the
final binary code (which must be available at your site for making
any "real" source code modifications).

This release of the PROGRES environment's binary code (and optionally
the complete source code) is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Library General Public License for more details (from Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA).

In case of any troubles please contact 

    Andy Schuerr
    Institute for Software Technology
    Department of Computer Science 
    University of the Federal Armed Forces Munich 
    D-85577 Neubiberg, Germany

    Andreas J. Winter or Manfred Muench
    Lehrstuhl fuer Informatik III,
    University of Technology Aachen (RWTH Aachen),
    Ahornstr. 55,
    D-52074 Aachen, Germany

Email to
    progres@i3.informatik.rwth-aachen.de


=======================================================================
========================= D I S C L A I M E R =========================
=======================================================================

ATTENTION: Please don't expect a commercial product which is
completely free of errors and runs like greased lightning - it's just
a research prototype.  But we will try to help you as fast as possible
in case of any difficulties and to provide bug fixes on a regular
basis.

This remark is especially true for the Linux release. We are quite
aware of the variety of Linux platforms. While the Solaris release is
compiled, linked, and tested on Sun workstations under Solaris 2 and
X11R5 we cannot regard all possible Linux configurations concerning
the reliability of the release. We have only tested this release on
a RedHat 5.1 system. Therefore, please tell us about any problems that
might occur in your environment.
