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".


Installing the sample application
---------------------------------

To install the sample application and fill the database with some sample data,
you can simply call the "setup-db.sh" script given in this directory.


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 this directory (where you found this file)
and typing "gnue-forms sample.gfd".  Please refer to gnue-forms's documentation
for more details.

Alternatively, you can let AppServer generate the form dynamically by calling
"gnue-forms appserver://appserver/form/address_person".


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

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

  gnue_useraccess.gfd

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

    NOTE: in order to use gnue_useraccess you have to install auth.gcd and
          auth.gsd. Run "gnue-readgcd --connection=gnue auth.gcd" to create the
          auth-classes and "gnue-schema --connection=gnue auth.gsd" to import
          the sample accounts.

          To make appserver use these authentication information you have to
          add 'authentication = True' to you gnue.conf configuration file.
