# INSTALL
# Author: Luis M. Arteaga Mejia (lmiguel@arteaga.com.mx)
# Version :   0.0.0a LMA 05.02.2002 Initial version. Incomplete.
#             0.0.1  LMA 17.06.2002 Some text added. 

This is a short install description. 

Until now, I have tested this software both in GNU/Linux and HP/UX platforms.
On  both,  I was  able to  install PostgreSQL and Tcl, so *theorically* it is 
completely feasible to use other platforms as well. 

The installation procedure is as follows:

1. 
Of course, you must have GNU/Linux or other environment able to run Pagen. 

2. 
PostgreSQL installation, out of the scope of this document. 

3.
Create an empty database. This is done with the command:

   > createdb mydatabase
   
4. 
Create the tables found on the sql directory. This can be accomplished with:

   > cd sql
   > cat pg_table_setup.sql | psql pagen
  
5. 
Now you must change the configuring options.This is a delicate process that
may make a difference between a smooth system and other not running at all.

Go to the bin directory and open the file pagen.config  with  your  favorite 
text editor. (pico rulez).

Make necessary changes on that file, according to your system. Most  of  the 
problems that may arise using PaGEN are to be blame on a misconfiguration,so
be careful on what you write here and be sure all directories referenced are
writeable by the user that will run PaGEN.


# Error and Debug messages

PaGEN has a very complete (and sometimes annoying) debug system. Make sure you
read all the error and warning messages before complaining to me. If all 
possibilities are exhausted, contact me and I will be happy to help. 


