EXPENSE MANAGER SET-UP
==========================
** THIS ASSUMES YOU ARE ALREADY RUNNING APACHE, AND YOU HAVE CGI WORKING

** YOU MUST INSTALL "Apache::Htpasswd" module before going ahead here.

Instructions on getting Apache::Htpasswd...

Get the module from http://search.cpan.org
This link might work:
http://search.cpan.org/search?dist=Apache-Htpasswd

Once downloaded, and as root:
  % tar zxvf Apache-Htpasswd-x.x.x.tar.gz
  % cd Apache-Htpasswd-x.x.x
  % perl Makefile.PL
  % make
  % make test
  % make install

Should be installed! Known to work on:
* freeBSD 4.4, 4.6
* Debian 3.0 (woody)

PLEASE EMAIL ME IF YOU HAVE TROUBLE GETTING IT TO WORK, I'VE ONLY TESTED IT FREEBSD AND LATELY (DEBIAN) LINUX, SO OTHER PLATFORM MAY HAVE DIFFERENCES WHICH I NEED TO FIX. FEEDBACK WANTED!!

==========================
(1)
* login in as root, change dir to your cgi-bin

* move the exp-X.tar.gz archive to the CGI-BIN of your web server,
  and unpack it into that directory (your probably already here).

* It should unpack into a folder called "sem" (simple expenses manager)

* Run the "set_up.pl" script (in a terminal, NOT a browser) in the directory that "exp" and "exp_admin" are located.

* This script will ask you several question concerning your system set-up. After it has been run you should have these files in your "sem" folder:

	PERL SCRIPTS:
		- exp (the user cgi)
		- exp_admin (the admin controls)
	DIRECTORIES:
		- admin
		- users
		- templates
	FILES:
		- "passwords" (in admin/)
		- "options.db" (in templates/ - this may look different if
		you're using perl 5.6.*)
		- Install.txt (your reading it!)
		- Readme.txt (How-to, info, etc)
--------
(2)
* Lauch a browser and goto:
	"http://your_computer/cgi-bin/sem/exp_admin"

* You will be asked your admin name and password. If first time, it should
be admin/admin, CHANGE THIS PASSWORD TO SOMETHING MORE SECURE ONCE YOU
LOG IN!

* Set up your defaults for user menus, etc (only basic controls at the moment).

--------

* Launch the user script:
	"http://your_computer/cgi-bin/sem/exp" (or where-ever)

	...and sign up, test it out, let me know what you think.
	
==========================

TROUBLESHOOTING:

* Check your apache error log and it should (i hope) complain about not being able to access some file. Usually its to do with:

* Permissions: Check that your user/group settings are set that the server can alter files, but no human (aside from root and direct computer access) can alter content. FreeBSD is happy with nobody/nobody, Debian (woody) uses www-data/www-data. Your set may be different. The set_up.pl script can perform these alterations for you (note: the set_up script will not over-write existing directories and files, they must be removed by hand first).

* Let me know if you have particular trouble getting it set-up. I want to make it as painless as possible.

Chris Poole
echo_anomie@yahoo.com.au