Installation instructions for GNUe Application Server
=====================================================


Requirements
------------

To install gnue-appserver, you need at least the following prerequisites
installed on your system [Debian packages in brackets]:

* Python 2.3 or greater [python python-dev]

* XML Tools for Python [python-xml]

* Egenix MX DateTime tools for Python [python-egenix-mxdatetime]

* at least one of the following database interfaces, depending on the database
  you want to use:
  - psycopg (preferred for PostgreSQL) [python-psycopg]
  - pyPgSQL (also possible for PostgreSQL) [python-pgsql]
  - pygresql (also possible for PostgreSQL) [python-pygresql]
  - python-mysqldb (for MySQL) [python-mysqldb]
  - KInterbasDB (for Interbase/Firebird) [python-kinterbasdb]
  - PySQLite (for SQLite) [python-sqlite]
  You can find more information about possible database backends on the web
  page http://www.gnuenterprise.org/tools/common/databases/.

* GNUe Common 0.6.1 or greater [gnue-common]

To build the documentation, you need GNU Texinfo 4.0 or newer installed.

You also need a running database server (one of those supported by GNUe) on the
local or on a remote machine, and you need the corresponding database client
installed on the local machine.  We very much recommend that you make sure that
you can access the database with the databases's normal client tools before you
try to install and run gnue-appserver.

It is of course suggested that you have GNUe's front end tools installed either
on the local or on a remote machine.


Installation
------------

* Make sure that you have write permission in the directory /usr/local and its
  subdirectories.

* From the shell prompt, change into the directory containing the file
  "setup.py" and type "./setup.py install".  If you have all prerequisites
  installed, the installation process should run without errors.  If any error
  occures although you have fulfilled all dependencies described above, this is
  probably a bug, either in the installation program or in the documentation.
  Please report it.


Configuration
-------------

Please refer to the file "configuration.txt" in the "doc" directory for a
explanation of the necessary configuration steps.
