Info about Stats.pl:

• Online configuration script. No more variables to mess with!
• Completely written in Perl so you have the source code to modify!
• Concurrent running with the server.
• Processes at up to 900 lines/sec (Varies on different log files).
• HTML or Non-HTML output

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

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. :)

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.

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

Make sure the files are in their proper places:
• stats.prg and statsconfig.pl go in your cgi-bin directory.
• statsconfig.html and statsbar.gif go in your htdocs (or root web server) directory.

Run the configuration HTML file (http://yoursite.com/statsconfig.shtml) and enter the appropriate variables.

If successful, the config script will give you a button to test it out on (see below for code to paste on other pages).

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!

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.

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

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.

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. :)

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

• Changed output arangement.
• Added browser stats option.
• Fixed potentialy bad logic bug in browser grabbing code...
• Added referrer stats to code (internal only, to be implemented later).
• Tried adding more explanetory comments for would-be hackers. Plan to do more...
• Added hash tables instead of arrays. This should speed up logs with many different files.

• Made config script.
• Minor tweaks here and there.
• This version will soon follow Omni 2.0's log format.

• Changed look of HTML output.
• Added time access feature.
• Default limit now doesn't act as a restraint, only a guideline.
• Misc speed improvements.

• Added background image and color options.
• Amazingly, no bugs to fix.

• Decided "It's been a month and to hell with it, let's say it's 1.0"
• Yet another date bug fix

• Date bug fix

• Misc bug fixes

• Added today's results.
• Added Top addresses results.
• Misc. bug fixes.

• Added most requested files.
• Fixed date errors, added variable customization.

• Completely rewrote script from C++ to Perl.
• Error recovery is much more gracefull. Never crashes from bad input. Simply ignores bad input lines.
• Can now be run while Omni is running! This is the coolest feature.

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

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