Qlog v1.20 Installation

Thanks for downloading qlog :-)

Qlog is a set of programs used to generate web page statistics based on
QuakeWorld frag log files.

How to Setup Qlog

Turn on your frag logging using the FRAGLOGFILE command. You may put this
command in your server.cfg file so that it is set correctly when the server
starts up.

You should place all the Qlog files in a single directory. The Qlog
executable will look for the qlog.cfg config file in the same directory it
is located.

You must have qstat installed to keep track of ping times. If you don't want
to use qstat, you can not run the get_ping.pl. Just comment out the "ping"
line in qlog.cfg.

Get qstat from the following URL:

     http://www.activesw.com/people/steve/qstat.html

You will need to compile it. See the qstat documentation for help on how to
do that.

You must also setup cron to run the get_ping.pl script once every minute.
The crontab entry should look like this:

     * * * * * /yourdirhere/get_ping.pl

You need to setup the following variables in get_ping.pl:
 Variable Name                           Function

 $ping_file    Location of the ping data file. This should match the value
               of ping in qlog.cfg.
 $qstat        Location of qstat executable.

 @servers      Lists you Quake/QuakeWorld servers. Can be listed as
               "dilbert.cninc.com" or "dilbert.cninc.com:27501".

Next you need to setup qlog.cfg. A default setup is provided in
qlog.cfg.dist. Start with that:

     cp qlog.cfg.dist qlog.cgf

Use your friendly UN*X editor to edit qlog.cfg. It's documented fairly well,
so I don't see the need to repeat it here. If you're curious, view the
sample config file here.

Now that you've setup qlog.cfg... you're ready to go. Run qlog by hand a few
times. Usage is:

     qlog

For a list of command line options, use:

     qlog -help

To get the Qlog version:

     qlog -v

Note: Qlog does some log file summarizing, so it will run much, much faster
after the initial run.

To display execution time:

     qlog -time

----------------------------------------------------------------------------
Author: Craig Knudsen - cknudsen@radix.net
Home Page: http://www.radix.net/~cknudsen/qlog/