*****************************************************************************************
*											*
*	tesTerra(c) 2006								*
*	by Max Konovalov - maxkonov@netscape.net					*
*	University of Alaska Anchorage							*
*	Senior Project									*
*											*
*****************************************************************************************	
*											*
* THIS FILE CONTAINS SOME TECHNICAL DETAILS ON HOW TO INSTALL TESTERRA SYSTEM		*
*											*
*****************************************************************************************



BRIEF OVERVIEW.
tesTerra is an online testing system. It allows instructors creating online tests for
their students to take.  Instructors can create three types of questions (Multiple 
Choice - Single Answer, True - False, and Essay), assign points to the questions and 
organize then in the tests.

*****************************************************************************************

SYSTEM REQUIREMENTS:
The application was successfully tested in the following environment:

	- MS windows XP(R) SP2
	- IIS 5.1
	- SMTP Server (make sure to make appropriate changes to your PHP.INI file)
	- MySQL 5.0
	- PHP 5.1
	- MS Internet Explorer 6.0
	- Mozilla FireFox 1.5
	- JavaScript MUST BE enabled on the clients' Web Browsers !!!

The following setting are required in PHP configuration:
	
	magic_quotes_gpc = On
	enable extension=php_gd2.dll
	odbc.allow_persistent = On
	mysql.allow_persistent = On
	mysql.max_links = -1

The system was NOT tested on Linux and Apache.

*****************************************************************************************

HOW TO INSTALL:

1.	Unzip all the files and folders from the tesTerra.zip archive into your web server root folder

2.	Setup appropriate permissions on the folders

3.	Located file named sys.inc.php in the tesTerra root folder and modify the following parameters to 
	match your system:
	
	$MySQL_Server = ""; --> specify either IP address or DNS name of the MySQL server you want to hold tesTerra's data;
	$MySQL_Login = "";  --> specify valid admins username to login to the MySQL server;
	$MySQL_Password = ""; --> specify valid password for the admins username;
	$db_name = "tesTerra";  --> you can either leave this parameter or name the database the way you like;
	$admin_email = ""; --> specify admins e-mail which will be used as a reply e-mail address for notifications messages;

4.	Make sure your IIS and MySQL servers are up and running

5.	Run MS Internet Explorer or Mozilla FireFox

6.	Using one of the web browsers mentioned in step 4, open file SETUP.PHP from the webfolder where
	you have extracted all the files and folders from the tesTerra.zip.  Make sure you do NOT open the
	file locally, but specifying full URL path to the file including "HTTP://" in the address bar of your
	internet browser

7.	The file will create tesTerra database and all the required tables

8.	If everything is OK, the "installer" will prompt you to create an administrator's account.  It is recommended
	that you provide all the required information, otherwise, you would not be able to login into the system

9.	After creation of the administrator's account you will be automatically redirected to the login page

10.	Login to the tesTerra using username and password you're just created at step 7

11.	That's about it.  I would recommend to delete files SETUP.PHP and confirmation.php from the root of the 
	tesTerra folder to keep your data safe.  Next time you or other tesTerra users you create will be able
	to login directly from page named login.php

12.	If you are experiencing any problems setting up tesTerra or running the application, feel free to bother me
	at maxkonov@netscape.net

13.	More user-friendly help can be found in the Help folder in the root of the tesTerra folder.


*****************************************************************************************

QUESTIONS?  COMMENTS?  -->  maxkonov@netscape.net

*****************************************************************************************
 

 
