1 files changed, 69 insertions, 19 deletions

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...)
+
+   # <path>/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 <your path to Apache libexec>/mod_log_mysql.so
+        chmod 755 <your path to Apache libexec>/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
    </VirtualHost>
 
 
+   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