First Time Installation
Free Edition v3.3
- You can print this out an refer to it as
Unzip the files to a location of your
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).
| |----- 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
| |----- cont_tpl.htm
| |----- poll_tpl.htm
| |----- surv_tpl.htm
| |----- template.htm
|Set Perl Location in PL Files
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:
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:
The line will look like this:
to run CGI extensions
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
If your server only allows CGI extensions to be ran, at this
point you must rename all the pl files to 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:
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.
cgi-bin Directories and Upload CGI Files
Login to your ftp server.
This can be done using any FTP client such as CuteFTP.
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
Using your ftp client, change to the directory which you created in
step 2 above.
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:
This directory will be a subdirectory under the directory that
you created in step two. Examples:
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.
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.
In this file you will find a line that looks like the following:
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.
non cgi-bin Directories and Upload NONCGI Files
Login to your ftp server once again. You may still be logged in
Create a directory called EventHandler under the root directory
(main directory for your website) for your website.
Using your ftp client, change to the directory that you created above
in step 2.
Create a directory
structure that mimics the structure of the NONCGI directory. This
means you will create the following directories.
These directories will be subdirectories under the directory that
you created in step two. Examples:
Upload all files from the NONCGI directory to their respective
directories on your server.
for NT servers
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:
When setting change permissions, you will
want have NT propagate (apply) those permission to all subdirectories
and files under each directory also.
You may need to ask your system administrator
to set the permissions for you.
for UNIX servers
For unix servers, please refer to the
chart below for the permissions on the files.
|----- 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
|----- 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.
Some UNIX servers will not allow 777
permissions to be set on the cgi EventHandler directory. If you follow the instructions completely
and you continue to get a server error while attempting to run the
scripts, set the permissions to 755 or 775 on the '/cgi-bin/EventHandler'
- 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
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.
administration page in your browser
Point your browser to admin.htm
file which you uploaded. Most likely this is:
where domain is your domain.
Main Script Variables
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
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
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.
|If you are having problems, please
check out our support forums. The answer to your question
may already be there. If not, just leave your question and we will answer it as soon as