From 6eff371018e78925510ff71cb255a64a441a9fc8 Mon Sep 17 00:00:00 2001 From: Christopher Powell Date: Mon, 3 Dec 2001 19:54:02 +0000 Subject: Big changes including reworked cookie code, new directives, SSL logging, new formatting characters, bugfixes, etc. --- INSTALL | 88 +++++++++++++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 69 insertions(+), 19 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index 0229879..4963123 100644 --- a/INSTALL +++ b/INSTALL @@ -1,30 +1,68 @@ -$Id: INSTALL,v 1.1 2001/11/28 05:26:54 helios Exp $ +$Id: INSTALL,v 1.2 2001/12/03 19:54:02 helios Exp $ Requirements ============ -0) I run a Red Hat 6.2 system, but these instructions should easily - adapt to any modern distro. +* I run a Red Hat 6.2 system, but these instructions should easily + adapt to any modern distro. -1) Apache 1.2.x or higher installed. (I run 1.3.22 and it works fine). - You should have already successfully compiled Apache and know what - you're doing there. In fact, you should already have any other - modules and add-ons like mod_ssl or PHP configured and installed - before you start this process. +* Apache 1.2.x or higher installed. (I run 1.3.22 and it works fine). + You should have already successfully compiled Apache and know what + you're doing there. In fact, you should already have any other + modules and add-ons like mod_ssl or PHP configured and installed + before you start this process. -2) The MySQL development headers. (I run MySQL-devel-3.23.44-1.i386.rpm). +* The MySQL development headers. (I run MySQL-devel-3.23.44-1.i386.rpm). -3) MySQL configured, installed and running on either localhost or an - accessible networked machine. You should already have a basic - understanding of MySQL and how it functions. +* MySQL configured, installed and running on either localhost or an + accessible networked machine. You should already have a basic + understanding of MySQL and how it functions. -4) Again, basic administrative skills with Apache and MySQL. I try to - make things as easy as possible in this README, but its purpose is - not to be an administrative tutorial. +* Again, basic administrative skills with Apache and MySQL. I try to + make things as easy as possible in this README, but its purpose is + not to be an administrative tutorial. -Installation -============ +* Additionally, if you want to be able to log SSL information such as + keysize or cipher, you need OpenSSL and glibc-devel installed. Both + are available as RPMs. + + +Installation (as an Apache DSO) +=============================== + +For folks interested in using this module as an Apache DSO, these +instructions are currently UNTESTED but should work. (I would be +grateful to hear back from a DSO user as to my accuracy with these +instructions.) + +0) Perform all the following steps as root so that you have install + privs, etc. + +1) Unpack the archive into a working directory. + + # tar zxf mod_log_mysql.tar.gz -C /usr/local/src + # cd /usr/local/src/mod_log_mysql + +2) Instruct apxs to compile and install the module as a DSO. (My apxs is + in /usr/local/Apache/bin, perform a "locate" to find yours...) + + # /apxs -i -a -c mod_log_mysql.c + + You should see something like this: + + gcc -fpic -DSHARED_MODULE -I/usr/local/Apache/include -c mod_log_mysql.c + ld -Bshareable -o mod_log_mysql.so mod_log_mysql.o + cp mod_log_mysql.so /mod_log_mysql.so + chmod 755 /mod_log_mysql.so + [activating module foo' in /path/to/apache/etc/httpd.conf] + +3) Now go to step (9) in the instructions below to configure httpd.conf... + + +Installation (as a static module compiled into httpd) +===================================================== +[This is what I do, FYI.] 0) Perform all the following steps as root so that you have install privs, etc. @@ -117,6 +155,15 @@ Installation + 9a) For users who have a DSO-enabled httpd: + + If you you are building mod_log_mysql as a static module BUT + your httpd is enabled for DSOs, add the following line to your + httpd.conf: + + AddModule mod_log_mysql.c + + 10) Create a database and table to hold the new log data. I log the same data as the regular "combined log" plus a little extra information that can be useful. @@ -128,8 +175,11 @@ Installation # mysql -uadmin -pmypassword mysql> create database apache; - Then I created the table called "access_log". You should use the - enclosed SQL file to do this for you. + Then create the table called "access_log". I enclosed an SQL file + that will create every column type that mod_log_mysql supports. + Unless you're just testing or playing around, this is probably NOT + what you want, so edit the file first and delete the lines that + don't pertain to you. Then: mysql> source access_log.sql -- cgit