README

Version 5.0.2 was released on Dec 28, 2003.  It contains 
significant bug fixes in the 5.01 xam.cgi, eval.cgi and
evaltoolkit.cgi scripts.  

1. Extract the files from the evalsuite tar or zip file
into an empty directory.  This directory will be a 
temporary directory used only for the installation of or 
upgrade to the Evalsuite version 5.0.2 software.  It must 
not be the target directory where the Evalsuite software 
will be installed.It should not contain any other files.

2. If you are upgrading an earlier version of Evalsuite,
make sure your existing superusers.pwd file contains the ID
of at least one account that will have superuser priveleges.
Older versions of Evalsuite used any made up passcode for
superuser access.  Version 5.0 and above requires that all  
IDs and passcodes used must belong to real Evalsuite  
accounts. Make an account if you need to and enter the ID
(not the passcode) of the superuser account into the 
existing superusers.pwd file (usually located under 
evaldata/admindata/security).  This insures that once the
upgrade has finished, you will have at least one account 
which is authorized to log into evaladmin.cgi .

3. Edit Evalsuite_custom.pm .  This is the only file of
the Evalsuite software system which may be modified and 
must be modified.  This file specifies the directory 
locations where your Evalsuite software is (or will be)
installed, your system settings, and your site information.

4. Run ES502_install.pl from the account or process id from
which the cgi scipts will be run by your web server.

5. Read ES502_install.log to verify that the installation
completed successfully.  Carefully review this log each 
time you run ES502_install.pl.  You may repeat steps 3-5
as many times as is needed.  When ES502_install has 
successfully completed, follow through with the manual
installation steps listed at the end of its log.

6. You may delete the temporary installation directory and
its contents when the installation has completed.  However,
you might want to consider keeping ES502_install.log and the 
*_release_notes.txt files for future reference.

7. If this is a new installation of the Evalsuite software
rather than an upgrade, make sure you disable the Evalsuite
INSTALL account after you have created a permanent account 
using the evaladmin.cgi script.  This must be done to protect 
the security of your Evalsuite system.