Installation Instructions for PTS                    07/09/97
-------------------------------------------------------------
$Id: install,v 1.3 1997/07/09 22:39:11 shevett Exp $
-------------------------------------------------------------

PTS Requirements:
	
	A Unix system
	A functional web server:
		Apache (can use the php/fi module)
		Something supporting CGI
	PHP/FI (available from www.vex.net/php)
		Version 2.0b10 or later required.
	An active SQL database server:  
		MSQL (available from hughes.com.au) (2.0b4 or later)
		OR
		(recommended)
		MySQL (available from www.tcx.se)
	Access to the database space (to create the db)
	Access to at least one web-accessible directory.
	Gnu-ZIP


Steps

1	Download the distribution from www.homeport.org/~shevett/pts/

2	Select the home directory for PTS.  It can be anywhere.  
	It's best to choose an empty directory (since pts has an
	'index.html', which is the normal default document for most
	web servers)

3	Unpack the distribution into that directory.  The distribution
	is a gzipped tar file.  The tar file automatically creates a
	few subdirectories.  When you're finished, you'll have something
	like this:

		(php home dir)
			|
			+------ struct
			|
			+------ docs
			|
			+------ graphics

	The php home directory will have all the .phtml files that make
	up the PTS system.  

4	Create the database.  This may need to be done by your 
	system administrator.  Make sure the server is running on 
	system, and type:

		for MSQL systems:
			msqladmin create pts

		for MySQL systems:
			mysqladmin create pts

		for PostGresSQL systems:
			createdb pts

	(if for some ungodly reason you already _have_ a database called
	'pts' within your server, you can choose a different name, but
	you'll have to edit the default database name within 'header.phtml'.

5	Create the tables.  cd into the 'struct' directory.  The files here
	are generated from 'msqldump' and 'mysqldump', and are designed to 
	be read directly into the command line utility.  Process all the files here
	by typing:

		for MSQL systems:
			msql pts < people.struct

		for MySQL systems:
			mysql pts < people.mysql

		for PostGresSQL systems:
			psql -f people.psql pts

	You'll get a screenful of 'query ok' messages.  Do this for each
	file within this directory.  MSQL servers should use the 'struct' 
	files, MySQL systems should use the 'mysql' files.

6	Select how to reference the pages.  If you are running the apache
	php/fi module, make sure you have the .phtml MIME type enabled
	within your server.  You'll also need to edit the 'index.html' file
	and make the FORM ACTION reference simple 'login.phtml' rather than
	the full path.  

	If you're not running the apache module, make sure the action path
	for that form is correct and that the php.cgi CGI handler is 
	installed correctly.

7	Set your configuration options.  Edit the 'db.phtml' file and
	check over the following variables, setting there where necessary:

		dbhost	The machine where your database server resides (if it's
			on the same machine as your web server, use 'localhost')
		dbname	The name of the database on your server (usually 'pts')
		server	The type of database server used (msql, mysql, or
			postgresql)
		rowid		In 'mysql' and 'msql' this should be set to '_rowid'.  In
			postgresql, it should be set to 'oid')

	Open the header.phtml file, and check through the settings there 
	as well:

		mt_addr		Mailto address for the local PTS admin
		mt_name		The name of the PTS administrator
		mlevel		The userlevel needed to do Maintenance
		maint		Is PTS in maintenance mode?
		version		The current version
		graphics	The path to the .gif graphics files
		gui				Support tables and colors?
	

8	LOG IN!  Point your web browser at the URL where the index.html
	file is stored, and you should be off and running.  

	Things you should do first:

		o	Create users via the maintenance function.
		o	Review the 'status' picks.
		o	Review the default preferences for your users. (see
			the 'prefs' document.)
		o	Define groups


IF YOU HAVE PROBLEMS...

There is a PTS-users Mailing list.  

Send email to 'majordomo@homeport.org, with the words 'subscribe
pts-users' within the body of the text.  Any questions you have about
PTS should be emailed to 'pts-users@homeport.org'.