Make your own free website on Tripod.com
Stats.pl 3.0 beta 2
- A more in depth stats program for OmniHTTPDd
I ask absolutely nothing for this program except that if you find the time, to come by my site and check it out.

Info about Stats.pl:

Table of Contents:
  1. Intro
  2. Known Conflicts
  3. Setup
  4. Command arguments
  5. Problems/Suggestions
  6. Making your own script changes
  7. Future Updates
  8. Varible Explanations

Intro

This program is a statistics generator for OmniHTTPd. It is meant as a cumulative statistics generator. It is meant for the hobbyist who is currious about the usage of their server. This by no means a comprehensive stats program and is not meant to be anything more than an interesting diversion from oridinary webmaster life. If you want something more, go buy it. :)


Known Conflicts/Restrictions

A long log file amy take a long time to process online so you may want to limit online access to a shortend version of the log file if it get's to be so big you think it takes too many resources to be online.


Setup

Here's a quick and dirty setup guide to running stats.pl on your web server.

 

To access it from the web, do the following:

  1. Add the following code to the page you want it on:

    <FORM action="/cgi-bin/stats.pl" METHOD="POST">
    <INPUT type="submit" Value="Run Stats">
    </FORM>

    or

    <A HREF="/cgi-bin/stats.pl">Run Stats</A>

    The first code will produce a button on the page and the second just a link. You can also use "/cgi-bin/stats.pl?#" to produce results for the last # entries.

  2. Now load up that page and hit the button or link!
To simply run it from the command line, do this:
  1. Change directories to your cgi-bin driectory.
  2. Type the following command:

    C:\perl\perl.exe stats.pl [arguments]

    Where C:\perl\perl.exe is the location of your perl interpreter.


Command arguments

"nohtml"Produces the output without any HTML tags. Handy for simple readings.
#Will produce statistics for the last # of entries. For example, if I were to say:

C:\perl\perl stats.pl nohtml 25

It would generate stats for the last 25 log entries and output it without HTML tags.

"debug"This turns on extra debugging info at the bottom of each output.
"today"Creates results for only items served on the current date.
"listlog:password"Provides a direct listing of the log over the web. Ex:

http://www.yoursite.com/cgi-bin/stats.pl?listlog:password

Where password is the password you assign in the script.

Order of these tags is not important but if more than 1 number is specified, only the last one will be used.


Problems/Suggestions

Now since you didn't pay for this, I don't have a toll-free technical support line to help you (Not that Microsoft has one mind you) but I will try to help you out if I can. Keep in mind that I am a student as well and as much as I would like computer time to come first, it can't always. Also, any suggestions are welcome. My current email is reflux@u.washington.edu.


Making your own script changes

If you want to make any changes to the script feel free. The main body of the code is in the file stats.prg which should have been put in your cgi-bin directory. This file is basicaly dumped into the script after the variables when the user runs the config script so put your changes in there. Mind you I code messy and will clean it up and add comments eventually. No, I don't know when. If you have made any good changes to the script and would like to include them in stats.pl for all to use, send them to me and I will incorporate them into a future release. You will, of course, get credit. :)


Future Updates

I will dedicate a page on my server for a while to it. Check it for updates:

http://weber.u.washington.edu/~reflux/stats/

Things added:

Ver 3.0 beta 2

Ver 3.0 beta 1 Ver 2.0 Ver 1.1 Ver 1.0 Ver .96.11.08 Ver .96.11.03 Ver .96.10.27 Ver .96.10.20 Ver .96.10.11
Varible Explanations

I have removed this section due to the explanations on the config script HTML page.


DISCLAIMER

Now I know that this part sucks but I have to do it.

Since the Software is provided free of charge, Omnicron Technologies Corporation and Joseph Downs (the "software providers") shall not be held responsible for any damages arising from the use of the Software. The Software is provided on an AS IS basis, without warranty of any kind, including without limitation the warranties of merchantability, fitness for a particular purpose and non-infringement. The entire risk as to the quality and performance of the Software is borne by you. Should the Software prove defective, you and not the software providers, assume the entire cost of any service and repair.
Whew...I hate that crap. I hope you have fun with the program and let me know if you're using it!