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

Quick Ref: (read below for more info)
------------------------------------

1. Install the GNUe common package. 

2. then run :

 $ python setup.py install  (depending on your OS, this could
                              also be python2.1 or python2.2)


General information:
====================

GNUe-Application Server needs some prerequisites to work. You need a 
database managment system, a rpc-interface library, python as programming
language and a xml-handling library.  As of this writting GNUe Appserver
allows you to use a variety of database systems, and two different
rpc-interfaces (py-xmlrpc and Pythonware xmlrpc).

The next part of this document describes the steps to install GNUe-forms on
a Debian 3.0, i386 platform.

Debian packages to be installed:
================================
You should apt-get install the following packages:

  python2.1-dev
  python2.1-egenix-mxdatetime
  python2.1-psycopg  (if needed -- for PostgreSQL support)
  python2.1-mysqldb  (if needed -- for MySQL support)
  python-xmlrpc      ( available in Debian since version 3.0)

This will also install other packages, such as postgresql-client, et al.


Setting GNUe Application Server up 
==================================


To use appserver you have to adapt you connection.conf file.

1. add an entry for the database appserver should use.

   The default database name in appserver is "gnue".
   You can change it with the command line option "--database".
   If you don't use postgresql you have to set the username and
   password for the database you want to use by command line options.

2. Set up the database for appserver. 

3. for using GNUe Forms or Reports with appserver, you have to add a
   section similar to the following:

[appserver]
comment = Connection to the GNUe Application Server
provider = appserver
rpctype = xmlrpc
host = localhost
port = 8765
transport = http




