###########################################################################
#                           Tester Script                                 #
#                                                                         #
#           This tester script will verify that you can                   #
#           run the WonderDesk successfully on your server.               #
#                                                                         #
#               Unix/Linux Installation Intructions                       #
#                                                                         #
#  This tester script is based off of a cgi-script called DBMan which     #
#  can be found at http://www.gossamer-threads.com/                       #
#                                                                         #
###########################################################################


Quick installation summary:

1. Edit the default.cfg file
2. Upload the tester files to your web server.
3. Change permissions on the files.
4. With your browser, run db.cgi file



========================================================================
=       Detailed Unix/Linux Installation instructions:                 =
========================================================================



Step 1. If your perl path is different than #!/usr/bin/perl, then with a
	text editor, edit the first line in the db.cgi file accordingly.




Step 2. Edit the default.cfg file with a text editor, and define 2 settings:

	$db_dir_url  = "http://yoursite.com/cgi-bin/tester";
                       (change this to reflect your URL)
                          
        $db_sendmail = "/usr/lib/sendmail";
        		(change this to where your sendmail program is)                



Step 3. Upload the tester directory in ASCII mode to your cgi-bin. Reproduce
	the same directory structure that you see after you unzipped it.
	


Step 4. Chmod everything to 777.  Yes, everything! Including /auth subdirectory.
	This is only a test, and you'll end up deleting this test script after
	you verify everything works ok. (Some servers don't let you 777 a cgi file,
	in this case, set the db.cgi to 755)


Step 5. Point your browser to http://yoursite.com/cgi-bin/tester/db.cgi
        (replace yoursite.com with the appropriate location)

	At this point, you should see the login page. Log in with:
	username: admin
	password: admin

	You should then be presented with a colorful page and some tests to run.
        When the tests pass, then you can be certain that the WonderDesk will also
        run successfully on your server.

	Done!
	
	
	

###########################################################################
#                        Troubleshooting                                  #
###########################################################################
========================================================================

Problem:  When pointing my browser to http://yoursite.com/cgi-bin/tester/db.cgi
	  I get an "Internal Server Error".
	 
	 
Solution: 1. Verify that you've uploaded the files in ASCII mode. Not Binary or Auto.

	  2. Change the db.cgi permission from 777 to 755.

 	  3. Make sure the perl path is correct in the db.cgi file.

========================================================================

Problem:  Error Message : unable to open auth file: ./auth/. Reason: Permission denied

Solution: Increase permissions on the /auth subdirectory. Chmod to 777

========================================================================

	
