AXYL Website Creation
=====================

This directory contains install scripts which create and build Axyl
database-backed websites.

create-axyl-website.sh
-----------------------
This is the main website creation script. Obviously Axyl has to be
installed first, but then presumably if you're reading this it has
been. ;-)

It was developed on a Linux system and is not appropriate for Windows-
based installations, however you might find pointers in it for that,
otherwise just use the SQL scripts in the 'db' directory to define
your database, and take a copy of the 'www' hierarchy for your
website.

The script adopts a Q&A approach and you can specify various things
such as your website/installation name, database name, database user
name, and password (optional). It will also let you define a simple
apache virtual host entry if you wish, in which case it will additionally
set up Php via the relevant php.ini files.

After the script has been run, you should find that it has created a
brand new website and, in its top directory, the configuration in
the 'application.xml' file should have been adjusted for your choices
of database name, username and password. Given a working apache
(and DNS settings) your Axyl website should be ready to run.


setup-axyl.sh
-------------
This is a script that you will use if you are a developer, and have
installed Axyl directly from CVS or tarball, into some working
directory. You then need to get the /etc/axyl/axyl.conf file set up,
and this script does that. It also optionally installs the Lucene Server
for you, and HTMLArea (a wysiwyg javascript editor). You can run this
multiple times without problems.


install-db.sh
-------------
This sub-script is usually called by create-axyl-website.sh and as its
name suggests it creates the Postgres database. However, you can run
it standalone, if you need to create or recreate an Axyl database. It
requires command-line parameters - run it without any to get a usage.


install-lucene.sh
-----------------
This sub-script is usually called by create-axyl-website.sh and is
responsible for setting up Lucene Server once-only on your system.
This only applies if the axyl-lucene package has been installed.


axyl-common.sh
--------------
Common sub-script included by other scripts to grab standard vars
and also define standard functions. Not meant to be run as a
standalone script.


config-apache.sh
----------------
This is a script which sets up an apache virtual host, when given
the details on the command line. It is designed to be run by the
'install-axyl.sh' script described above, but you could also run
it independently. Invoke it without arguments to see usage.


config-app-db.pl
----------------
This script simply adjusts the 'application.xml' configuration file
replacing the database name, username and passwrod sections with
the ones supplied on the command line. It is designed to be run by
the 'install-axyl.sh' script described above.

get-htmlarea.sh
---------------
Just a short script to auto-export the HTMLArea javascript app.
from its CVS repository, so as to get the latest for Axyl on
installation. Called from other install scripts.


setperms.sh
-----------
A script which sets the permissions of an Axyl website hierarchy.
You change directory into the top directory of your Axyl website and
then run the script to set all the perms and ownerships to what they
should be. This is used by other install scripts.
