AdCafe Install Instructions
AdCafe requires that Perl 5.2 be installed on the server. If this is not the case, please make arrangements for Perl 5 to be installed. It is freely available from various archives. You must install a version for the particuliar hardware and operating system that runs your web server.

The other main requirement is that permissions need to be setup for the perl scripts to create and update data files. This is typically controlled by the directory permissions and the privileges of the perl scripts. In UNIX for example, the data directory should have permissions of 666. The cgi files should have permissions of 755. Also, your server may require that the cgi scripts be executed from a specific directory.

1) Unzip or untar all the files into the directory where the adcafe data and graphics will be stored. All the cgi, htm, and gif files should be in this directory. This directory must have privileges that will allow the creation of files by a browser client. This is on the server. You must transfer (ie. ftp) the files to the server. This should be the directory where the adcafe data will be stored ($adcafeDirData below).

2) Edit the install.cgi file. You may want to do this before you transfer the files to the server. Enter a value for the following variables. This script will install and filter the files with the values that you enter. It will copy the cgi files to a cgi directory if that is necessary. The following variables need to be setup. Replace the current value of the variable that is between the 'quotes'.

#!/usr/local/bin/perl This line tells the install.cgi where the perl executable is. If this is incorrect install.cgi will not execute. This line must be the 1st line of install.cgi and must start with #! followed the path to the perl executable.
$newPathToPerl = '/usr/local/bin/perl' This is the location of the perl executable on your server. If this is not correct you will NOT be able to run any scripts. This path should be the same as the entry above this.
$adcafeUrlCgi = 'http://www.yourserver.com/cgi-bin/' This is the Url of the cgi files for this server. If this server requires cgi scripts to be in a specific directory, enter it here. If cgi can be executed from any directory, our suggestion would be to make it the same as the data directory.
$serverDirCgi = '/www/cgi-bin/' This is the same location as $adcafeUrlCgi entry but it is based on the file system of this server. This is so the install script can copy the cgi files to where they must be.
$adcafeUrlCgi = 'http://www.yourserver.com/data/' This is the Url of the adcafe data files for this server. This should be the same location as $adcafeDirData below.
$adcafeDirData = '/www/data/' This is the location of the data and graphic files for adcafe on this server. This directory will need to allow a browser client create and update data files.
$adcafeDirTotals = '/www/totals/' This is the location of the totals files for adcafe on this server. This directory will need to allow a browser client create and update totals files.
$adcafeDirLogs = '/www/logs/' This is the location of the log files for adcafe on this server. This directory will need to allow a browser client create and update log files.
$adCafeServer = 'YourName, Inc.' Enter the name of your web site that you want to be displayed on the AdCafe admin and statistics pages. These will be viewed internally and externally by sponsors checking on their statistics.
$adCafeMailAddr = 'email@yourServer.com' Enter the email address that you want your sponsors to contact you at for questions regarding the ads.
$adDefGifUrl = 'http://www.yourserver.com/gifs/' Enter the full URL for a default URL location for an ad banner. When a new no ad is added, this will be put in the GIFs field (to save typing).
$adDefGif = 'http://www.yourserver.com/default.gif' Enter the full URL for a default ad banner. When no ads are available to be deliverd or one can not be delivered due to errors, this gif will be delivered instead.
$adDefUrl = 'http://www.yourserver.com/default.htm' Enter the full URL to go to when the default ad banner is clicked on. When no ads are available to be deliverd or one can not be delivered due to errors, this URL will become the HREF for ad clicks.
$adcafeAdminId = 'AdCafe' Enter the Login Id for the administrative functions.
$adcafeAdminPswd = 'admin' Enter the password for the administrative functions. (used with login id above) This allows access to the functions that let the user add, delete, and edit ads, sites, and groups on the server.
$adcafeAdminTots = 'tots'; Enter the password for the administrative totals. (used with login id above) This allows access to the totals for all of AdCafe on the server.
$adcafeAdminStats = 'stats'; Enter the password for the day by day totals for all of the AdCafe site. (used with login id above)

3) Telnet into the server to execute the 'install.cgi' script. ie 'perl install.cgi'. You could also enter a 'chmod 0755 install.cgi' (only on unix boxes). This should allow you just to execute 'install.cgi'. adCafe should now be setup on your server so that you can execute the cgi scripts that come with it. It will change to file permissions of all the cgi, html, and gif files.

4) Test your installation of AdCafe by running the script adcafe_setup.cgi from your browser. Enter in the address field 'http://www.yourcompany.com/adcafeCgiDirectory/adcafe_setup.cgi'. This should brng up a field that lets you enter the main site you will advertise for (these may be the only site you want or need). Submit this entry - adcafe will report if it was able to create the initial data files for you. If it did not there is probably a problem with your file permissions that didn't allow you to create files from your browser.

5) The setup script will display two links. The first one will display more information about how to use AdCafe and deliver the dafault ad in a frame at the top of the page using the sample file frame.htm. The 2nd link just displays the AdCafe information without testing ad deliver.

6) AdCafe should now be installed and able to be used to deliver ads.

Infohiway, Inc.

AdCafe is a product of Infohiway, Inc.