RatingsHandler Installation

Upgrading from v1.0 to v1.1

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

Unzip the files to a location of your choice. After unzipping you should have the following directory and files. Directories are in bold. Files are not bolded.

CGI
  | -- admin_script.cgi
  | -- admin_user.cgi
  | -- RatingsHandler.cgi
  | -- subs_global.cgi
  | -- subs_main.cgi

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:

RatingsHandler.cgi
admin_script.cgi
admin_user.cgi

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

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

Example:

admin_script.pl
admin_user.pl
RatingsHandler.pl
subs_global.pl
subs_main.pl

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

RatingsHandler.pl
admin_script.pl
admin_user.pl

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

$cgiext = 'cgi';

This line must be changed so that it reads:

$cgiext = 'pl';

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

1. Login to your ftp server. This can be done using any FTP client such as CuteFTP.
    
2. Change to your cgi-bin/RatingsHandler directory where you have your current version installed.
         
3. Upload all the new files from the zip files.  You will be overwriting some of the old files at this point.
    
4. The admin.cgi file is no longer needed so you can delete it.
    
5. If UNIX, set chmod 755 to the admin_script.cgi and admin_user.cgi files.

1. Open your browser to the new admin_script.cgi file. Most likely this will be:
    
   http://www.domain.com/RatingsHandler/admin_script.cgi
     
   where domain is your domain.
    
2. When you are presented the login screen, use your Script Admin login information.
    
3. At this point, check all of your script settings to be correct. There are new settings that you might need to set at this point.

At this point, your upgrade is done.

You should now put RatingsHandler to a test to ensure everything is working properly.