Office Hours Scheduling System Files

README.TXT
==========

Welcome to the Office Hours Scheduling System.

Here are the installation steps.

1) Copy the release file (release-name.tar.gz) into a single directory on your LAMP server 
(or a directory that is accessible to your lamp server).   Typically, this would be somewhere 
in the document root of your LAMP server.   OH requires access to a Linux/Unix system, 
an Apache web server (or equivalent), PHP 4 or 5, and a MySQL 4.1+ system. 

2) Uncompress the release file.  The file was created with the Unix command:
	tar -cf - * | gzip > release-name.tar.gz
You would typically uncompress it with (subsitute the name of the release file for 
"release-name.tar.gz"):
	zcat release-name.tar.gz | tar -xvf -
	
3) Set the permissions on the extracted files, and the OH directory, such that you and Apache can 
read/write/execute the files, but no-one else can.  This is VERY IMPORTANT.  The OH system stores 
the un-encrypted MySQL database password in a file it creates called "parms.inc.php".  You must 
insure that this file cannot be read by arbitrary users.  You should also protect all of the OH 
files from being read by arbitrary users. A typical way of doing this is to assign group ownership 
of the files and directory to the same group as the Apache server, to turn on the "set-group-id"
bit for the OH directory (so that files created in this directory inherit the group ownership
of the directory), and set the directory permission to 770 and the file permissions to 750.  Assuming 
you have the appropriate rights, you could do this with the following Unix commands (from the OH 
directory ... You must substitute the group of the Apache server for "apache-group" in these 
commands):
	chgrp apache-group .
	chmod 2770 .
	chgrp apache-group *
	chmod 750 *
	
4) Invoke the install.php script from a web browser (just about any browser will do).  

The install.php script will take you through the installation procedure.  You can use this same 
script to maintain your system. The install script will attempt to create a file named 
parms.inc.php ... you must make sure that apache/php can write into the directory where you have 
extracted the OH distribution.

Good luck.

Serge Goldstein
Princeton University OIT
serge@princeton.edu