Trying out GNUe Application Server
==================================

If you want to try gnue-appserver, first make sure you have followed the
installation instructions you can find in the file "INSTALL".


Create an entry in your connections.conf
----------------------------------------

Add a section for your database to the connections.conf file. If you followed
the default setup this file has already an entry 'gnue'. Please check if it
fits your needs (provider, hostname, dbname and so on)


Creating the database
---------------------

Before you can start gnue-appserver, you have to create a database and fill it
with some basic information.

For PostgreSQL, Interbase/Firebird, or SQLite:
----------------------------------------------

Execute the script 'setup-db.sh' and you're done. This script will do all the
dirty work for you


All other backends:
-------------------

First create your database as described in your database documentation. Make
sure you have access to this database and it fits your settings in the
connections.conf. The call the following programs

gnue-schema --connection=gnue base.gsd

  This will create all tables needed for the classrepository

gnue-gcd2sql --connection=gnue auth.gcd sample.gcd

  This will create the sample classes and updates the classrepository

gnue-schema --connection=gnue sample.gsd

  This will add sample data for the sample classes



Running the Application Server
------------------------------

If you have installed gnue-appserver and set up the database correctly, you
should be able to run "gnue-appserver" from the command line prompt.

If you have problems, you might want to try "gnue-appserver -Z --debug-level 9"
to get debugging information.

As soon as gnue-appserver runs, you can try to connect to it.  If you have
gnue-forms installed, you can try running the "sample.gfd" form.  Basically,
you can do this by changing into the "samples" directory and typing
"gnue-forms sample.gfd".  Please refer to gnue-forms's documentation for more
details.

There are two users you can choose from to test: "test" (with password "test")
and "hacker" (with password "secret")


Other Samples
=============

Apart from the basic "sample.gfd" you will find the following other samples in
this directory:

  classrepository.gfd

    This GNUe Forms Definition allows you to edit modules, classes, properties
    and procedures in the Class Repository used by GNUe Appserver.

    In default setup, only the user "hacker" has the permission to access the
    Class Repository.

  gnue_useraccess.gfd

    This form allows you to edit users and the classes they have access to.

  (more samples to follow, please contribute)
