1. unpack the tar ball 

2. set the location of the perl interpreter in log2mysql
   by default it is set to /usr/bin/perl which is a commonly used location

   dont forget to set the mysql connection settings at about line 33 in 
   log2mysql.

   variable          default            describtion
   =======================================================================
   datebin           /bin/date          what is your date binary
   serverName        localhost          the name of the DB server
   serverPort        3306               the port of the mysql server
   serverUser        root               the user for connections
   serverPass        [empty]            password of the user
   serverDb          apache2            the name of the database.      

   notify_mail_on    0                  should the admin be informed in case
                                        of that the errorcount >= errortrigger
   errortrigger      20                 whats the maximum of errors tolerable
   smtp_host         localhost          host to use for sending mails (no need for sendmail!)
   adminmail         root\@localhost    the receiver of the mails

3. install the perl modules

   DBI
   DBI::DBD
   Time::ParseDate
   mysql
   Socket

   For a guide how to install perl modules read the FAQ

4. copy log2mysql into e.g. /usr/sbin and chmod 755 log2mysql

5. create database structure 
   create a database called "apache2" and few tables with 

   mysql < db.sql

6. convert an existing log file
   call "log2mysql <access_log>"

   i hope it works ;-)

7. activate the online-log-facility
   open your http.conf an insert following line
   "TransferLog |/usr/sbin/log2mysql" and restart your apache
   "CustomLog  |/usr/sbin/log2mysql combined" and restart your apache

Follow these steps only if you want to use PHP online reports.

8. edit the php/include.php
   - change the SQL connection options

   - HOSTNAME contains the name of the server which produced the logs. E.g.
     in my case it is "http://yasd.dhs.org"

   - ROWCOL contains the color for the menue and table headers

   - VISIT_TIMEOUT is used for the calculation of visits and is set by default 
     to 30 minutes.

   - CGIBIN	should be set to the directory where your CGI resides. By default set to "/cgi-bin/"
   
9. copy php-files
   create a subdir called e.g. apachedb under your http-root and copy
   all php-files to this subdir. php should have mysql support compiled in.


10. open with your browser http://<server>/<location of the php-files>/ 

11. enjoy it
