--------------------------------------------------------------------
|                                                                  |
| 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      :  11.2                                             |
| Release Date :  March 2004                                       |
|                                                                  |
| This release is available for Linux machines!                    |
|                                                                  |
| The release comprises two parts:                                 | 
|  - progres-common-11.2.tar.gz contains the os independent parts  |
|    of the release, i.e. this part is needed for every            | 
|    installation.                                                 |
|  - progres-linux-11.2.tar.gz is needed if you want to run        |
|    PROGRES on Linux machines.                                    |
|                                                                  |
| The latest release (11.2) is available via ftp from:             |
|    ftp-i3.informatik.rwth-aachen.de   (137.226.168.10)           |
|           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-11.2.tar.gz
    and
        progres-linux-11.2.tar.gz

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)

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

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

	gunzip progres-linux-11.2.tar.gz
	tar -pxvf progres-linux-11.2.tar

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.

You will need 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
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 

    Prof. Dr. Andy Schuerr
    Real-Time Systems
    TU Darmstadt
    D-64283 Darmstadt, Germany

    Ulrike Ranger
    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. 
We cannot regard all possible Linux configurations concerning
the reliability of the release. We have only tested this release on
a SUSE-7.3 and a Debian-3.1 system. Therefore, please tell us about any problems that
might occur in your environment.
