First Time Installation

Free Edition v3.3

1. You can print this out an refer to it as needed.

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-main.pl
    |----- admin.pl
    |----- date.pl
    |----- diagnose.pl
    |----- EventHandler.pl
    |----- readme.txt
    |----- setup.pl
    |----- subs1.pl
    |----- subs2.pl
    |----- subs3.pl
    |----- data

NONCGI
    |----- admin.htm
    |----- links.htm
    |----- welcome.htm
    |----- images
    |           |----- bg.gif
    |           |----- bg2.gif
    |           |----- Blackdot.gif
    |           |----- Bluedot.gif
    |           |----- Browndot.gif
    |           |----- EventHandler.gif
    |           |----- Greendot.gif
    |           |----- hint.gif
    |           |----- link.gif
    |           |----- Orangedot.gif
    |           |----- Purpledot.gif
    |           |----- Reddot.gif
    |           |----- reset.gif
    |           |----- submit.gif
    |           |----- Whitedot.gif
    |           |----- Yellowdot.gif
    |----- templates
    |           |----- cont_tpl.htm
    |           |----- poll_tpl.htm
    |           |----- surv_tpl.htm
    |           |----- template.htm

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.pl
admin-main.pl
diagnose.pl
EventHandler.pl
subs2.pl
subs3.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.cgi
date.cgi
admin-main.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.pl
admin-main.pl
diagnose.pl
EventHandler.pl
subs2.pl
subs3.pl

To edit them, open each files 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. Create a directory called EventHandler on your server in which the script will run.  This most likely will be located as a subdirectory of your  cgi-bin directory.
   
   Example: http://www.domain.com/cgi-bin/EventHandler
     
3. Using your ftp client, change to the directory which you created in step 2 above.
   
4. On your server, created a directory structure that mimics the structure of the CGI directory which you unzipped.  This means you will create the following subdirectory:
   
   data
   
   This directory will be a subdirectory under the directory that you created in step two. Examples:
   
   http://www.domain.com/cgi-bin/EventHandler/data
   
5. Upload all files from the CGI directory to their respective directories on your server. Ignore the files under the NONCGI directory for now.
   
   When uploading the .pl files, you should 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 in which you uploaded the cgi files in the previous section.
   
   You will only edit the part that is in red above.
   
   Examples:
   
   <BASE HREF="http://www.hotmail.com/cgi-bin/EventHandler" target="main">
   <BASE HREF="http://www.microsoft.com/cgi-bin/EventHandler" target="main">

1. Login to your ftp server once again.  You may still be logged in from before.
   
2. Create a directory called EventHandler under the root directory (main directory for your website) for your website.
   
   Example: http://www.domain.com/EventHandler
   
3. Using your ftp client, change to the directory that you created above in step 2.
   
4. Create a directory structure that mimics the structure of the NONCGI directory. This means you will create the following directories.
   
   images
   templates
   
   These directories will be subdirectories under the directory that you created in step two. Examples:
   
   http://www.domain.com/EventHandler/images
   http://www.domain.com/EventHandler/templates
   
5. Upload all files from the NONCGI directory to their respective directories on your server.

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-main.pl - 755
    |----- admin.pl - 755
    |----- date.pl - 666
    |----- diagnose.pl - 755
    |----- EventHandler.pl - 755
    |----- readme.txt - 666
    |----- setup.pl - 666
    |----- subs1.pl - 666
    |----- subs2.pl - 755
    |----- subs3.pl - 755
    |----- data - 777

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

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

1. This step is not a must at this moment. It can be done at any point down the line.
    
   The templates files are used to make your script look as though it is part of your site. For details on template files, click here.
    
   Note: When editing the template file, you must always include the $REPLACE variable.  This is to indicate where the script should insert the HTML which is generates.

Point your browser to admin.htm file which you uploaded. Most likely this is:

http://www.domain.com/EventHandler/admin.htm

where domain is your domain.

Click on the left hand side link labeled Script Variables. This is under the Script Admin section.

For the first time login, you will leave the  login username and password blank.

Once you are in the Script Variables screen, you want to go through of the fields and set each and every variable.

Make sure you set a new username and password.

Once you have set all the fields properly, click on the button labeled Modify Main Variables.

At this point you are ready to start creating and administering your events.