summaryrefslogtreecommitdiffstats
path: root/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL47
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 @@
1$Id: INSTALL,v 1.4 2002/01/15 18:40:14 helios Exp $ 1$Id: INSTALL,v 1.5 2002/02/24 20:17:16 helios Exp $
2 2
3 3
4Requirements 4Requirements
@@ -28,6 +28,16 @@ Requirements
28 are available as RPMs. 28 are available as RPMs.
29 29
30 30
31Do I want a DSO?
32================
33You need to know the answer to this question before you proceed. The
34answer is pretty straightforward: what have you done in the past? If
35you like all your Apache modules to be dynamic, then you should keep
36doing that. If you're more of an old-school type and prefer to compile
37the modules right into apache, do that. Both methods work equally
38well.
39
40
31Installation (as an Apache DSO) 41Installation (as an Apache DSO)
32=============================== 42===============================
33 43
@@ -45,11 +55,19 @@ For folks interested in using this module as an Apache DSO:
45 fully explained in the Makefile. 55 fully explained in the Makefile.
46 56
473) Instruct apxs to compile and install the module as a DSO. You need 573) Instruct apxs to compile and install the module as a DSO. You need
48 to know two things before you run apxs: 58 to know three things before you run apxs:
49 - The location of the apxs binary, find using 'locate apxs' 59 - The location of the apxs binary, find using 'locate apxs'
50 - The location of your MySQL libraries, find using 'locate libmysqlclient' 60 - The location of your MySQL libraries, find using 'locate libmysqlclient'
61 - The location of your mysql.sock socket file. If your MySQL is running on
62 a different machine (in other words, communication is via TCP/IP and not
63 sockets), this value will be ignored BUT IT STILL MUST BE DEFINED
64 AS SOMETHING/ANYTHING FOR COMPILATION TO WORK.
51 65
52 # <path>/apxs -i -a -c -L<path to MySQL libs> -lmysqlclient -lz mod_log_mysql.c 66 FORMAT:
67 # <path>/apxs -i -c -DMYSQLSOCKET='\"/path/to/mysql.sock\"' -L/path/to/mysqllibs -lmysqlclient -lz mod_log_mysql.c
68
69 EXAMPLE:
70 # /usr/sbin/apxs -i -c -DMYSQLSOCKET='\"/var/lib/mysql/mysql.sock\"' -L/usr/lib/mysql -lmysqlclient -lz mod_log_mysql.c
53 71
54 You should see something like this: 72 You should see something like this:
55 73
@@ -59,7 +77,20 @@ For folks interested in using this module as an Apache DSO:
59 chmod 755 <your path to Apache libexec>/mod_log_mysql.so 77 chmod 755 <your path to Apache libexec>/mod_log_mysql.so
60 [activating module blah in /path/to/apache/etc/httpd.conf] 78 [activating module blah in /path/to/apache/etc/httpd.conf]
61 79
624) Now go to step (9) in the instructions below to configure httpd.conf... 804) Add the following stanzas to your httpd.conf file. Put the second stanza
81 somewhere after the ClearModuleList directive.
82
83 <IfDefine HAVE_LOG_MYSQL>
84 LoadModule mysql_log_module modules/mod_log_mysql.so
85 </IfDefine>
86
87
88 <IfDefine HAVE_LOG_MYSQL>
89 AddModule mod_log_mysql.c
90 </IfDefine>
91
92
935) Now go to step (9) in the instructions below to configure httpd.conf...
63 94
64 95
65Installation (as a static module compiled into httpd) 96Installation (as a static module compiled into httpd)
@@ -143,14 +174,14 @@ Installation (as a static module compiled into httpd)
143 INSERTed into the table called "access_log". 174 INSERTed into the table called "access_log".
144 175
145 176
146 LogMySQLInfo dbmachine.foo.com loguser l0gger 177 MySQLLoginInfo dbmachine.foo.com loguser l0gger
147 LogMySQLDB apache 178 MySQLDatabase apache
148 179
149 <VirtualHost 1.2.3.4> 180 <VirtualHost 1.2.3.4>
150 [snip] 181 [snip]
151 182
152 TransferLogMySQLTable access_log 183 MySQLTransferLogTable access_log
153 TransferLogMySQLFormat huSUsbTvRA 184 MySQLTransferLogFormat huSUsbTvRA
154 185
155 [snip] 186 [snip]
156 </VirtualHost> 187 </VirtualHost>