WWW Stat 1.0

1. Installation
2. Documentation

Installation

To install the wwwstat.pl script, telnet to your Virtual Server and do the following:

1. Untar the WWW Stat tar file located in the /usr/local/contrib area:

     % cd    (this will put you in your home directory)
     % tar -xvf /usr/local/contrib/wwwstat.tar
   

2. Customize the wwwstat.pl script for you domain name. To do this you will need to do the following:
   a. Change the AppendToLocalhost definition on line 113 to represent your domain name.
   b. Change the mydom1 and mydom2 definitions on lines 121 and 122 to represent your domain name.
   

3. Run the wwwstat.pl script by typing the following at a command prompt:

     % /usr/local/bin/virtual /usr/local/etc/wwwstat-1.0/wwwstat.pl > ~/www/htdocs/wwwstat.html
   

   NOTE: you can use the sample cron file included in the WWW Stat tar file to automate your stat generation.

Documentation

Usage:
   
       wwwstat [-helLoOuUrvx]  [-s srmfile] [-i pathname]
               [-a IP_address] [-c code] [-d date] [-t hour] [-n archive_name]
               [-A IP_address] [-C code] [-D date] [-T hour] [-N archive_name]
               [logfile ...]   [logfile.gz ...]    [logfile.Z ...]
   
Display Options:
     -h  Help -- just display this message and quit.
     -e  Display all invalid log entries on STDERR.
     -l  Do display full IP address of clients in my domain. 
     -L  Don't (i.e. strip the machine name from local addresses).
     -o  Do display full IP address of clients from other domains.
     -O  Don't (i.e. strip the machine name from non-local addresses).
     -u  Do display IP address from unresolved domain names. 
     -U  Don't (i.e. group all "unresolved" addresses under that name). 
     -r  Display table of requests by each remote ident or authuser.
     -v  Verbose display (to STDERR) of each log entry processed.
     -x  Display all requests of nonexistant files to STDERR. 
Input Options:
     -s  Get the server directives from the following srm.conf file.
     -i  Include the following file (assumed to be a prior wwwstat output).
    ...  Process the sequence of logfiles (compressed if extension (gz|Z|z)).
Search Options (include in summary only those log entries):
     -a  Containing a  hostname/IP address  matching the given perl regexp.
     -A  Not containing   "      "     "       "      "      "   "    "
     -c  Containing a  server response code matching the given perl regexp.
     -C  Not containing   "      "     "       "      "      "   "    "
     -d  Containing a  date ("Feb  2 1994") matching the given perl regexp.
     -D  Not containing   "      "     "       "      "      "   "    "
     -t  Containing an hour ("00" -- "23")  matching the given perl regexp.
     -T  Not containing   "      "     "       "      "      "   "    "
     -n  Containing an archive (URL) name   matching perl regexp (except +.).
     -N  Not containing   "      "     "       "      "      "   "    "