Upgrading Instructions
Professional Version v3.5
For users of v3.4 only.

Note: Due to many significant changes, this upgrade will only work if you are currently running version 3.4. If you are running a version previous to version 3.4, you must perform an upgrade to version 3.4 first. Once your upgrade to version 3.4 has been completed, you can then upgrade to version 3.5.

1. We always recommend you backup your current version. .
    
2. The file WWCcontests.pl no longer exists. If you are still using links that point to WWCcontests.pl, you need to change them to the new EventHandler.pl file.
     
3. When upgrading, you should never replace the setup.pl file or the files in your 'data' directory.
     
4. When upgrading, you should never replace any of your existing template files. Only upload new template files if you do not already have them. If you replace any of your modified template files, you will have to modify them again.

If you are using ID's, you should notify your users that you are going to upgrade.

By default, all events will disabled for all users.

The users will not be able to login into the Event Admin screens until you have finished the upgrade and reset the main Script Variables.

After you have complete the steps below, your users will be able to login.  However their events will be disabled until they reset their user variables and the variables for each event.

Unzip the files to a location of your choice. 

After unzipping you should have two main folders called CGI and NONCGI. 

The directory and file structure for these should look like the charts:
(directories are in bold).

CGI
    |----- admin-event.pl
    |----- admin-member.pl
    |----- admin-script.pl
    |----- diagnose.pl
    |----- EventHandler.pl
    |----- readme.txt
    |----- SSI.pl
    |----- subs1.pl
    |----- subs2.pl
    |----- subs3.pl
    |----- subs4.pl
    |----- translator.pl
    |----- translate
                |----- English.pl
                |----- master.pl
    |----- plugins
                |----- UBB.member.pl

NONCGI
    |----- admin.htm
    |----- links.htm
    |----- welcome.htm

For full details on each of the files and directories, you can click here.

For UNIX servers. You may need to set the location of your Perl in the scripts. The default location set for Perl in the script is:

#!/usr/local/bin/perl

If this path is correct for your server, you can skip to the next section.

The Perl location is the first line of the following files:

admin-event.pl
admin-member.pl
admin-script.pl
diagnose.pl
EventHandler.pl
SSI.pl
subs2.pl
subs3.pl
subs4.pl
translator.pl

The line will look like this:

#!/usr/local/bin/perl

If your server allows you to run Perl scripts with the pl extension or you have other Perl scripts on your server that use the extension pl, you can skip this step. Most server will allow pl extensions. 

If your server only allows CGI extensions to be ran, at this point you must rename all the pl files to cgi files.

Example:

admin-event.cgi
admin-member.cgi
admin-script.cgi
date.cgi
EventHandler.cgi

Once you have renamed each of these files, you must edit the following files and indicate in them that you are using the CGI extension:

admin-event.cgi
admin-member.cgi
admin-script.cgi
diagnose.cgi
EventHandler.cgi
SSI.pl
subs2.cgi
subs3.cgi
subs4.cgi
translator.cgi

To edit them, open each file in a text editor. Find the line that says:

$cgiext = 'pl';

This line must be changed so that it reads:

$cgiext = 'cgi';

Once you have edited each file and saved them, you are ready to go using the CGI extension.

1. Login to your ftp server. This can be done using any FTP client such as CuteFTP.
   
2. Change to the directory where your cgi scripts are installed.
   
   Example: http://www.domain.com/cgi-bin/EventHandler
     
3. Upload all the newest versions of the files.  You will want to overwrite the following old files with the new ones.:
   
   admin-event.pl
   admin-member.pl
   admin-script.pl
   diagnose.pl
   EventHandler.pl
   subs1.pl
   subs2.pl
   subs3.pl
   subs4.pl
   translator.pl
     
4. Upload the new SSI.pl file to the directory above.
   
   
5. Upload the newest version of the following file to the plugins directory:
    
   UBB.member.pl
     
6. Upload the newest version of the following files to the translate directory:
   
   English.pl
   master.pl
   
   When uploading the .pl files, be sure to use ASCII mode transfer.
   

1.  Open the file links.htm in an editor of your choice. This is located in the NONCGI directory that was created when you unzipped the files.
   
2. In this file you will find a line that looks like the following:
   
   <BASE HREF="http://www.domain.com/cgi-bin/EventHandler/" target="main">
   
   Edit this line so that it points the location where your cgi script files exist.
   
   You will only edit the part that is in red above. Do not edit
   
   Examples:
   
   <BASE HREF="http://www.hotmail.com/cgi-bin/EventHandler/" target="main">
   <BASE HREF="http://www.microsoft.com/cgi-bin/EventHandler/" target="main">

Make sure you have the trailing / (slash) at the end.

The links.htm file has additional information in it for you to read.

1. Upload the new files for admin.htm, links.htm, and welcome.htm.

If NT server, you will want to give the IUSR_XXX (Internet Guest Account) account CHANGE (RWXD) (RWXD) permissions for both main EventHandler directories. These are the directories you created such as:

http://www.domain.com/cgi-bin/EventHandler/
http://www.domain.com/EventHandler/

When setting change permissions, you will want have NT propagate (apply) those permission to all subdirectories and files under each directory also.

Note: You may need to ask your system administrator to set the permissions for you.

For unix servers, please refer to the chart below for the permissions on the files.

cgi-bin/EventHandler - 777
    |----- admin-event.pl - 755
    |----- admin-member.pl - 755
    |----- admin-script.pl - 755
    |----- date.pl - 666
    |----- diagnose.pl - 755
    |----- EventHandler.pl - 755
    |----- readme.txt - 666
    |----- setup.pl - 666
    |----- SSI.pl - 755
    |----- subs1.pl - 666
    |----- subs2.pl - 755
    |----- subs3.pl - 755
    |----- subs4.pl - 755
    |----- translator.pl - 755
    |----- data - 777
    |----- translate- 777
                |----- English.pl - 666
                |----- master.pl - 666
    |----- plugins - 755
                |----- UBB.member.pl - 666

EventHandler - 777
    |----- templates - 777
    |           |----- cont_tpl.htm - 666
    |           |----- poll_tpl.htm - 666
    |           |----- quiz_tpl.htm - 666
    |           |----- surv_tpl.htm - 666
    |           |----- template.htm - 666
    |----- users- 777

Only the files listed above require special permissions. All other files can use the default permissions.

Go to your admin screen in your browser.

Click on the left hand side link labeled Script Variables. At this point you should check all of your Script Variables and re-submit them. Pay attention to any new settings and set them accordingly.

If you are translating into a language other than English, at this point you'll need to log into the Translator and translate any new lines as well as check all your existing translations.

If you have users, you should notify them that the upgrade has been complete.

They will need to submit their User Variables to update them to the new version format.

Once they have submitted their User Variables, they will then need to submit the Event Variables for each event to ensure they are operating.

You should also enform your users to check all of their settings to ensure they are correct.  They should also pay attention to any new settings that might need to be defined. 

Your upgrade should be complete.