Installation and User Notes
Download a1s.zip and unzip the file into a temporary directory on your PC
Create a directory on your server for your statistics data. It is recommended that you call the directory "a1stats" but it doesn't really matter what you call it.
Upload all files with the .cgi extension into the cgi directory on your server. Make sure these files are uploaded in ASCII mode.
Upload a1vars.txt into the cgi directory on your server. Make sure this files is uploaded in ASCII mode.
Upload pixel.gif, graph.gif and del.gif into the data directory (a1stats) created in step 2 above. Make sure these files are uploaded in Binary mode.
Ensure that all of the scripts are world-executable. Use: chmod 755 scriptname. The file a1vars.txt should be world-writable. Use chmod 777 a1vars.txt. The data directory that you created in step 2 should also be world writable but for security reasons you might want to make this a password protected directory.
Make sure that the first lines of each file with the .cgi extension points correctly to the location of Perl on your server. The first lines are currently: #!/usr/bin/perl. You may need to change this to #!/usr/local/bin/perl. Failing that, contact your system administrator and ask for the perl path on your server.
Now bring up a1conf.cgi in your browser: http://www.yourserver.com/cgi-bin/a1conf.cgi. Ensure that all your path names and URLs are correct. Be very careful about this as an error in any of these details will prevent the script from working.
Now upload a1admin.txt to your cgi directory and make sure it is world-readable. Use: chmod 777 a1admin.txt. Ensure that the file is uploaded in ASCII mode.
If you need to access the administration screen again, which you probably won't if you got it all right the first time, then the default administration password is "ecap08". It is important to change this to a password of your choice to prevent unauthorised access.
The installation is now complete. In order to monitor the statistics for any of your web pages, you should enter the following piece of javascript code. The only bit you need to change is the bit in red:
<script language="javascript">
gadm1="&url=" + document.URL;
gadm1+="&ref=" + document.referrer +"'>";
gadm2="<img src='http://www.yourserver.com/cgi-bin/a1count.cgi?";
document.write(gadm2+gadm1);
</script>You will need to change the red bit to point to the script in your cgi directory.
To check your statistics, you should access the following URL in your browser:
http://www.yourserver.com/cgi-bin/a1disp.cgi
That's all there is to it. Please let me know what you think of this software and how you would like it to develop.
Email Contact: Drummond Miles