AccountHandler Installation

Version 1.2x

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 files.

AccountHandler.cgi
admin.cgi
readme.txt
subs_list.cgi
subs_main.cgi
subs_member.cgi
template.htm
vars_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:

AccountHandler.cgi
admin.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 servers 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:

AccountHandler.pl
admin.pl
subs_list.pl
subs_main.pl
subs_member.pl
vars_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:

AccountHandler.pl
admin.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. Create a directory called AccountHandler 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/AccountHandler 
     
3. Using your ftp client, change to the directory which you created in step 2 above.
    
4. Upload all files into the directory that you just created.
     
   When uploading the .cgi files, you should be sure to use ASCII mode transfer.

If NT server, you will want to give the IUSR_XXX (Internet Guest Account) account CHANGE (RWXD) (RWXD) permissions for the directory that you created above which was:

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

When setting change permissions, you will want to have NT propagate (apply) those permission to all files under the directory as well.

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

For unix servers, follow the steps below to set permissions.

1. Set CHMOD 777 on the AccountHandler directory that you created above.
     
   Some UNIX servers will not allow you to run scripts in a directory using 777 permissions. If this is true for your server, you will get a server error while attempting to run the scripts. In this case, set the permissions to 755 or 775.
   Use 777 at all times if possible.
     
2. Set CHMOD 755 on ALL .cgi files (.pl if you changed them).
     
3. Set CHMOD 666 on the file vars_main.cgi.

1. This step is not a must at this moment. It can be done at any point down the line.
    
   The template file (template.htm) is 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.

1. Point your browser to admin.cgi file which you uploaded. Most likely this is:
    
   http://www.domain.com/cgi-bin/AccountHandler/admin.cgi
     
   where domain is your domain.
     
2. You will now be presented a login screen.
     
   Leave the ID and Password blank and click the login button.
     
3. Once logged in you will be taken to the Script Variables Screen.
     
4. Here you will define all of your script settings.
     
5. Once this is done,  you will click the submit button to submit the changes you just made.
     

Note: This is the admin screen you will be using at all times for admin purposes.

If you are not going to use AccountHandler for managing password protected areas, you can skip this step.

1. Using the admin navigation at either the top or bottom, go to the  Protected Areas section under Protected Area Administration.
       
2. In this area, you will follow the instructions to define the information for the password protected area that you will be managing
      

At this point, your setup is done.

We highly recommend take a look at all screens to get familiar with them.  Each screen will contain help and documentation to help you through using AccountHandler. 

Click here for information on using AccountHandler.