INSTALLATION

This installation documentation is currently very rudimentary, but I hope it
will help nevertheless.

1. Compile the package and create HTML documentation:

   $ ./build

2. Create a CGI directory on your system, for global installation i.e.
   /usr/local/psp/cgi-bin:

   $ mkdir -p /usr/local/psp/cgi-bin

3. Copy the content of the ./bin directory to the new CGI directory:

   $ cp -r bin/* /usr/local/psp/cgi-bin

4. Place the psp.conf configuration file in the same directory as psp.cgi:

   $ cp psp.conf /usr/local/psp/cgi-bin

5. The files should already have the right permissions, but ensure the
   directories and files are owned by root and are not writable for other users:

   $ chown -R root:root /usr/local/psp
   $ chmod -R o-w,g-w /usr/local/psp

6. Edit your Apache configuration, add the following directives:

   ScriptAlias /psp-cgi/ /usr/local/psp/cgi-bin/
   AddHandler script/psp .psp
   Action script/psp /psp-cgi/psp.cgi
   DirectoryIndex index.psp index.html index.shtml index.htm index.php

7. Edit the psp.conf file to meet your environment. Usually it may remain
   as it is.

8. Copy the ./support/test.psp file to any place in your document root and
   point a webbrowser to that location to run some simple tests.
