Minor but significant updates to the instructions for apxs users.

3 files changed, 53 insertions, 12 deletions

diff --git a/CHANGELOG b/CHANGELOG
index 7d9fba0..b0da0a2 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -1,4 +1,4 @@
-$Id: CHANGELOG,v 1.5 2002/01/15 18:40:14 helios Exp $
+$Id: CHANGELOG,v 1.6 2002/02/24 20:17:16 helios Exp $
 
 
 TODO:
@@ -9,6 +9,13 @@ TODO:
 
 CHANGES:
 
+1.14:
+* Improved the apxs instructions based on user feedback, including the
+  mysql.sock define issue.
+* Corrected the INSTALL example directives to the new format.
+* Some improvements to 'make distro'
+
+
 1.13:
 
 * Now use ap_get_server_name() in extract_virtual_host() to fix the
@@ -22,6 +29,7 @@ CHANGES:
   machine and is ignored in that case (although it still must be defined
   for the connect to work).
 
+
 1.12:
 
 * Added a mysql_close() call to get rid of those annoying MySQL
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>
diff --git a/Makefile b/Makefile
index 65e0cd5..e46bdfe 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
-# $Id: Makefile,v 1.5 2002/01/15 18:40:14 helios Exp $
-MLMVERS = 1.13
+# $Id: Makefile,v 1.6 2002/02/24 20:17:16 helios Exp $
+MLMVERS = 1.14
 
 # Where you unpacked your Apache tarball -- the source.
 APACHESOURCE = /usr/local/src/apache_1.3.22
@@ -63,6 +63,8 @@ distro: all
         cp -f README ${APACHEINST}/html/mod_log_mysql/
         cp -f CHANGELOG ${APACHEINST}/html/mod_log_mysql/
         cd ..; tar zcf mod_log_mysql-${MLMVERS}.tar.gz --exclude mod_log_mysql/CVS mod_log_mysql/; $(INSTALL) mod_log_mysql-${MLMVERS}.tar.gz ${APACHEINST}/html/mod_log_mysql/; rm -f mod_log_mysql-${MLMVERS}.tar.gz
-        
+        rm -f /usr/local/Apache/html/mod_log_mysql/mod_log_mysql.tar.gz 
+        ln -s mod_log_mysql-1.14.tar.gz /usr/local/Apache/html/mod_log_mysql/mod_log_mysql.tar.gz
+
 clean:
         rm -f *.o *~