This files in this package are © 2002-2006 Spencer Olson except where explicitly stated otherwise.

This software is licensed under the GPL:
** This program is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public License
** as published by the Free Software Foundation; either version 2
** of the License, or (at your option) any later version.
** This program is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
** GNU General Public License for more details.
** You should have received a copy of the GNU General Public License
** along with this program; if not, write to the Free Software
** Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

If you use it, send me a note. If you fix it, please send me a patch.

REQUIREMENTS:

• A web server (I prefer apache 2.0) with the following installed:
  • PHP,
  • pgsql PHP extension,
  • PDFLib (I'm using 5.0.4 right now),
  • PDFLib PHP extension (easy to install along with main PDFLib install)
  • SSL.
• Postgres database
  I'm using 7.4.8 (with redhat enterprise 4) version >=8.x.x might require some small tweaks in authentication model for the apache, apache_admin users. I expect everything else to work fine though with new Postgres versions.

To install:

1. Edit Makefile to customize configuration
2. make install
3. You may have to edit pg_ident.conf as well as pg_hba.conf to get the httpd users to authenticate to the postgres server.
4. Configure the web authentication for your users. I use the following in an .htaccess file on apache:
   1. SSLRequireSSL # so only SSL connections are acceptable.
   2. Basic authentication # require your users to login
   I have included the .htaccess files that I use in both the php/ directory as well as the php/admin/ subdirectory.
5. Populate the essential elements of the database:
   1. Login as a user in the admin group (see step 4 and my example .htaccess files).
   2. Add obvious items to grouprooms, accounts, shiptoaddresses, personnel tables.
   3. Add an initial set of vendors if desired. (I've included a large set of vendors that we used at UMICH in the vendors.sql file. For using my initial set, use 'make install-vendors'.)
6. Good luck!

The admin subdirectory contains modified php files from a third party package. I can't remember where I got this from and a google search doesn't seem to be enlightening me at all. If you know where this comes from, please send me a note so that I can include the Copyright notice as well as license.