Getting Started

To get started using the CGI Download Manager, just follow these simple instructions. The whole setup process should only take 5 to 10 minutes.

Step 1: Order and Download

If you haven't already, place your order and download the CGI Download Manager now. Once you have the ZIP file containing the script, return to this page to continue with the installation.

Step 2: Unzip the CGI Download Manager

Once you have downloaded the CGI Download Manager ZIP file. Unzip the ZIP file. You should have all of the following files. If anything is missing, please contact us so we can assist you.

• files-upload-handler.cgi
• files-rebuild-cron.cgi
• files.tmpl
• files.theme
• files.style
• files.lib
• files.key.lib
• files.html.lib
• files.files.lib
• files.email.lib
• files.dates.lib
• files.config
• files.cgi

Step 3: Configure the CGI Download Manager

Open up the main configuration file for CGI Download Manager:

files.config

Read the file carefully and follow the instructions in the file to enter the correct values for your configuration. Pay particular attention to whether or not you need to add or leave out the slash "/". (The configuration file will let you know if you need to add a trailing slash "/" or not.)

Step 4: Setup Perl

Now that you've setup your configuration, you need to ensure that CGI Download Manager is using the proper command to run Perl on your server. Typically, the default value of of:

/usr/bin/perl

will work fine. But, you should check just to make sure. To check where Perl is on your server try one of the following:

1. Using Shell Access:
   1. If you have shell access to your server, log in, run the command:
      
      which perl
      
      
   2. If this command produces any result other than:
      
      /usr/bin/perl
      
      you need to make a simple change to the files.cgi script to reflect the proper location of Perl.
      
      
   3. If you need to change your files.cgi script, open files.cgi script file and change the location of Perl in the first line of the script. By default it is setup to be:
      
      #!/usr/bin/perl
      
      Change it to be:
      
      #!/your/perl/location
      
      Of course you will need to substitute "/your/perl/location" for the location indicated by the which command.
      
      
2. Ask your System Administrator: If you do not have Telnet or SSH access, ask your System Administrator or Web Host where your Perl install is located. If possible have them set up the proper location of Perl in the files.cgi script for you.

Step 5: Setup the Template File

The CGI Download Manager uses a template to produce the Download Directory pages. This allows you to customize the template to make the Download Directory look and feel like the rest of your web site.

The file:

• files.tmpl

is the Template file that the CGI Download Manager uses to build the pages of the Download Directory. You can leave this file as is, for a basic no-frills set of pages in your Download Directory.

Or if you want to customize the output of the script so that it matches your web site, you will need to edit the this file. Simply edit the file so that it contains the HTML needed to match the look and feel of your website.

The only thing to remember is to be sure to place the special:

<FilesContentHere>

tag in the file where you want the CGI Download Manager script to put the file directory information on the page.

Once your done making your changes - save the file.

Step 6: Upload the CGI Download Manager Files

Your configuration should be completed. Now, all you need to do is upload the CGI Download Manager files to your server.

The location that you place the CGI Download Manager files should match the location you specified in the files.config configuration file in Step 3 above. Be sure that you upload the script files to the proper location on your server. If you need to upload them to a different location than you specified in files.config - that is fine. Just be sure to update files.config so that it reflects the proper location. Then reupload files.config to the server.

Once all the files are in place on the server, you need to ensure the correct permissions are configured on the script files. All of the CGI Download Manager files should be set to permissions 755. If the files are not set to the proper permissions, you will have difficulty running the script. You can configure the script with these permissions in your FTP client, or by running the following commands on the Unix Shell command line, if you have shell access:

• cd [Location of CGI Download Manager Files]
• chmod 755 *

Step 7: Access the CGI Download Manager and Get Started

Now that the script is configured, its time to get started using it. Access the URL for the script on your server to get started. Depending on where you uploaded the script, the URL will be different, but in most cases it will look something like this:

• http://www.yourname.com/cgi-bin/files/files.cgi

Once you access the script, simply follow the onscreen instructions to get started.