DownloadTimes Installation Guide
Instructions for a Linux/Unix installation.

Please report and problems with or corrections to this documentation to ianr@rnrtech.com.

Step 1. Download DownloadTimes

You will first need to download DownloadTimes. DownloadTimes is available for download on R&R Technologies, Inc. website, the download page is at:

http://scripts.rnrtech.com/DownloadTimes.html

Step 2. Install required Perl modules

If you already have LWP::UserAgent installed on your system then skip this step. If you are unsure then finish the rest of the steps (3,4,5) first and try running the script. If the script does not run then proceed with this step.

If you do not have shell access this would be VERY difficult to do and is probably not worth your time. You should contact your system administrator and see if they will install the modules if they are not already installed. Even if you do have shell access it may be worth it to see if your system administrator will install the modules you need. You need the following Perl module installed:
LWP::UserAgent

If your system administrator will not install the modules on their system (or you are the system administrator) and you have shell access then you may continue on.

If you have CPAN or are not sure you can try installing the LWP modules by typing:

perl -MCPAN -e 'install LWP::UserAgent'

If that works then you are done with the step and you can skip on down to the next step.

If that doesn't work, you may first need to download the CPAN module. The download page for the CPAN module is at:

http://search.cpan.org/search?dist=CPAN

Upload the file you just downloaded to your web server. Then uncompress the CPAN module on your server by typing the following (replace FILE_NAME with the name of the file you just uploaded):

tar -xvzf FILE_NAME.tar.gz

Now change into the directory that was made when the file was uncompressed ("cpan-1.61" for example) and type the following lines to build and install the CPAN module:

perl Makefile.PL
make
make test
make install

Now try the method mentioned above.

If it still does not work or if you would rather install everything by hand then you can search for modules using the CPAN search engine to search the CPAN network for modules to download at:

http://search.cpan.org

You will then follow the same procedure as the installation of the CPAN module above for each module you download. If you do not have required dependencies for the module you are tyring to install then when you are on the make step of the build it will inform you of the modules you will need to install before the current one. On a bare/new Perl installation this can require QUITE a few modules to be installed just to get one or two modules that you want installed. That is why using the CPAN module to install for you can save a lot of time and effort.

We will now assume you have the required modules installed, you are now past the most difficult part of the installation.

Step 4. Upload DownloadTimes and set permissions

If you have shell (telnet) access to your web server then you can upload the compressed .zip file to your server in binary mode and extract the script on the server into your cgi-bin directory if you have one.

If you do not have shell access you will need to extract the script (download_times.cgi) and then upload it to your server in ASCII or Text Mode, DO NOT upload download_times.cgi in binary format. If you upload in binary mode the scipt will not work. If you have a cgi-bin directory you should upload it there.

Now you will need to give the script read and execute permissions so it can be run. To do this you will need to type "chmod 755 download_times.cgi" if you have shell access. If you do not have shell (telnet) access, you will need to use your FTP program to set the read and execute permissions. Most FTP programs have a way of doing that, be sure to set the permssions to 755, or atleast 555 (read and execute permissions for everybody).

Step 5. Configure DownloadTimes

You may need to change the path to Perl if your server does not have it in the standard location. You can do this by editing the first line of the download_times.cgi file. You will need to ask your system administrator if you do not know the location. However the first line should ALWAYS start with a # (pound/number sign) followed by the path and name of perl.

The rest of the configuration is optional. There are a few variables which may be changed inside of the download_times.cgi file. They are all listed near the top (in a section called "Configuration Variables"). Change any of these you would like. There is a brief description of each of the variables directly above them.

Please report and problems with or corrections to this documentation to ianr@rnrtech.com.