Minor but significant updates to the instructions for apxs users.

1 files changed, 39 insertions, 8 deletions

diff --git a/INSTALL b/INSTALL
index 7f2e061..0391e88 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,4 +1,4 @@
-$Id: INSTALL,v 1.4 2002/01/15 18:40:14 helios Exp $
+$Id: INSTALL,v 1.5 2002/02/24 20:17:16 helios Exp $
 
 
 Requirements
@@ -28,6 +28,16 @@ Requirements
   are available as RPMs.
 
 
+Do I want a DSO?
+================
+You need to know the answer to this question before you proceed.  The
+answer is pretty straightforward:  what have you done in the past?  If
+you like all your Apache modules to be dynamic, then you should keep
+doing that.  If you're more of an old-school type and prefer to compile
+the modules right into apache, do that.  Both methods work equally
+well.
+
+
 Installation (as an Apache DSO)
 ===============================
 
@@ -45,11 +55,19 @@ For folks interested in using this module as an Apache DSO:
    fully explained in the Makefile.
 
 3) Instruct apxs to compile and install the module as a DSO.  You need
-   to know two things before you run apxs:
+   to know three things before you run apxs:
    - The location of the apxs binary, find using 'locate apxs'
    - The location of your MySQL libraries, find using 'locate libmysqlclient'
+   - The location of your mysql.sock socket file.  If your MySQL is running on
+     a different machine (in other words, communication is via TCP/IP and not
+     sockets), this value will be ignored BUT IT STILL MUST BE DEFINED
+     AS SOMETHING/ANYTHING FOR COMPILATION TO WORK.
 
-   # <path>/apxs -i -a -c -L<path to MySQL libs> -lmysqlclient -lz mod_log_mysql.c
+   FORMAT:
+   # <path>/apxs -i -c -DMYSQLSOCKET='\"/path/to/mysql.sock\"' -L/path/to/mysqllibs -lmysqlclient -lz mod_log_mysql.c
+
+   EXAMPLE:
+   # /usr/sbin/apxs -i -c -DMYSQLSOCKET='\"/var/lib/mysql/mysql.sock\"' -L/usr/lib/mysql -lmysqlclient -lz mod_log_mysql.c
 
    You should see something like this:
 
@@ -59,7 +77,20 @@ For folks interested in using this module as an Apache DSO:
         chmod 755 <your path to Apache libexec>/mod_log_mysql.so
         [activating module blah in /path/to/apache/etc/httpd.conf]
 
-4) Now go to step (9) in the instructions below to configure httpd.conf...
+4) Add the following stanzas to your httpd.conf file.  Put the second stanza
+   somewhere after the ClearModuleList directive.
+
+        <IfDefine HAVE_LOG_MYSQL>
+           LoadModule mysql_log_module modules/mod_log_mysql.so
+        </IfDefine>
+
+
+        <IfDefine HAVE_LOG_MYSQL>
+           AddModule mod_log_mysql.c
+        </IfDefine>
+
+
+5) Now go to step (9) in the instructions below to configure httpd.conf...
 
 
 Installation (as a static module compiled into httpd)
@@ -143,14 +174,14 @@ Installation (as a static module compiled into httpd)
    INSERTed into the table called "access_log".
 
 
-   LogMySQLInfo dbmachine.foo.com loguser l0gger
-   LogMySQLDB apache
+   MySQLLoginInfo dbmachine.foo.com loguser l0gger
+   MySQLDatabase apache
 
    <VirtualHost 1.2.3.4>
         [snip]
 
-        TransferLogMySQLTable access_log
-        TransferLogMySQLFormat huSUsbTvRA
+        MySQLTransferLogTable access_log
+        MySQLTransferLogFormat huSUsbTvRA
 
         [snip]
    </VirtualHost>