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


IMPORTANT: These instructions assume that your NT/2000/2003 web server has
	   already been set up correctly, and ready to run perl scripts.

           If you need assistance setting up your server, then follow these
	   step by step tutorials first:
	   http://www.wonderdesk.com/serversetup


	   You can find more helpful information here:
	   http://www.wonderdesk.com/faq.html



Quick installation summary:

1. Configure the db.cgi and default.cfg files.
1. Upload the tester files to your web server.
2. With your browser, run the db.cgi file



========================================================================
=       Detailed Windows NT/2000/2003 Installation instructions:         =
========================================================================


Step 1. Edit the db.cgi file with a text editor (like notepad or wordpad)
	and specify the $db_script_path. Set it to the full hard drive path
	of where the files will be installed. 

        Example:
	$db_script_path = "D:/Inetpub/wwwroot/cgi-bin/tester"; 

        (Notice the use of forward / slashes. Do not use back \ slashes.)
	


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

	$db_dir_url     = "http://yoursite.com/cgi-bin/tester";
                          (Change this to reflect your URL)

	$db_on_NT   = 1;  
                     (change the 0 to 1)

	$db_NT_SMTP     = "smtp.server.com";
                         (change this to your SMTP server name or IP address)       





Step 3. Create a /tester subdirectory on your server under your cgi-bin.

	If you do not have a cgi-bin directory on your server, then follow
	this tutorial:

	http://www.wonderdesk.com/serversetup




Step 4. Copy or upload (via an FTP program) the tester files to the 
        /cgi-bin/tester directory. Reproduce the same directory structure that
 	you see after you unzipped it.



Step 5. Increase NTFS permissions on the entire /tester directory and all
 	of it's files and sub folder. Grant Everyone Full Control.



Step 6. 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

	  1. it shows me the text code of the db.cgi file or gives me the file
          to download.

	  or

	  2. it gives me a "%1 is not a valid Windows NT application error"

	  or

	  3. it just hangs and eventually times out.


Solution: Install Perl and make sure you have configured the .cgi association.
	  Tutorial on how to do that can be found here:			    

	  http://www.wonderdesk.com/serversetup


	  When your server is configured properly, it will present you with
	  a login page.

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

Problem:  When running test #1, I get:
	  CGI ERROR
	  ==========================================

	  Error Message : fatal error: Can't send mail: No To: field specified...

Solution:  http://66.226.100.37/cgi-bin/contact/wonderdesk.cgi?db=faq&uid=default&view_records=1&ID=74&ww=1


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


Problem:  When running test #5, some Perl modules are showing as not installed.

Solution: http://www.wonderdesk.com/serversetup


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

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

Solution: Increase permissions on the /auth subdirectory. Grant Everyone Full Control.

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


More info can be found here:
http://www.wonderdesk.com/faq.html

or feel free to contact us:
http://www.wonderdesk.com/contactus.html














	

