Installation instructions

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.youserver.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 above 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.

$adcafeUrlData = 'http://www.youserver.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.
