diff options
Diffstat (limited to 'index.xml')
-rw-r--r-- | index.xml | 260 |
1 files changed, 260 insertions, 0 deletions
diff --git a/index.xml b/index.xml new file mode 100644 index 0000000..1db68be --- /dev/null +++ b/index.xml | |||
@@ -0,0 +1,260 @@ | |||
1 | <?xml version="1.0"?> | ||
2 | <?xml-stylesheet type="text/xsl" href="../../../../xsl/projects.xsl"?> | ||
3 | <ooo title="mod_log_sql" path="/projects/apache/mod_log_sql/" osi="on"> | ||
4 | <section title="Abstract"> | ||
5 | <content> | ||
6 | <div xmlns="http://www.w3.org/1999/xhtml"> | ||
7 | <p>mod_log_sql is a logging module for Apache 1.3 and 2.0 which logs all requests to a database. This began a port of the Apache 1.3 version of the module by Chris Powell, and as of February 6th, 2004 Chris Powell and I have decided to switch maintainer-ship of the module over to me. <br/> | ||
8 | This module now compiles under Apache 1.3 and Apache 2.0 from the same source.</p> | ||
9 | <p>The 1.9x versions are to be considered beta quality, as they contain new features | ||
10 | and some major code cleanups. If you are using Apache 1.3 it is recommended that you use | ||
11 | mod_log_sql version 1.18. Only use the 1.9x releases if you need the new features they provide.</p> | ||
12 | </div> | ||
13 | </content> | ||
14 | </section> | ||
15 | |||
16 | <changelog> | ||
17 | <entry version="1.101"> | ||
18 | <content type="docbook"> | ||
19 | <para> | ||
20 | This release adds more documentation of the all the log formats and also adds documentation | ||
21 | of the tabletype DBParam for the mysql driver. Using LogSQLDBParam tabletype ARCHIVE will | ||
22 | set the tabletype for autocreated tables to ARCHIVE (and save TONS of space too) | ||
23 | </para> | ||
24 | <para> | ||
25 | Segfaulting due to not loading a driver module no longer occurs and an error message is | ||
26 | logged to the log file stating that you didn't load the driver module. | ||
27 | </para> | ||
28 | <para> | ||
29 | This release also adds another sub-module that will log incoming and outgoing bytes (logio) | ||
30 | This modules is EXCLUSIVE to the mod_logio module. Meaning if you use the mod_log_sql version | ||
31 | you must NOT load the standard apache version. Currenlty due to how logging of outgoing bytes | ||
32 | is done in the apache core there is NO workaround for this, you either log outgoing bytes | ||
33 | in the text access logs OR mod_log_sql. | ||
34 | </para> | ||
35 | <para> | ||
36 | To actually USE the new logging fields you just need to add the "i" and "o" LogSQLLogFormat options. | ||
37 | Please note that these are lowercase instead of uppercase like they are in mod_logio. | ||
38 | </para> | ||
39 | <note> | ||
40 | <para> | ||
41 | Due to the addition of the logio two new fields are added to the log tables. If you wish to use | ||
42 | logging if IO then you MUST alter your existing tables adding fields bytes_in and bytes out of type int unsigned. | ||
43 | </para> | ||
44 | <programlisting>ALTER TABLE mylogingtable ADD COLUMN bytes_in INT UNSIGNED, ADD COLUMN bytes_out INT UNSIGNED</programlisting> | ||
45 | </note> | ||
46 | </content> | ||
47 | </entry> | ||
48 | <entry version="1.100"> | ||
49 | <content type="docbook"> | ||
50 | <para> | ||
51 | This release adds a new "V" log format which logs the requested hostname into | ||
52 | virtual_host instead of the ServerName. This is exclusive to "v", Only one or the other | ||
53 | can be used. | ||
54 | </para> | ||
55 | <para> | ||
56 | There are several fixes in the configure system to not error out if an optional library | ||
57 | or file is not found. And there are several fixes to the SQL generation code fixing | ||
58 | escaping, table names, and NULL values. | ||
59 | </para> | ||
60 | </content> | ||
61 | </entry> | ||
62 | <entry version="1.99"> | ||
63 | <content type="docbook"> | ||
64 | <para> | ||
65 | This release fixes segmentation faults of apache that occured when the preserve file | ||
66 | was used. The errors printed to the error log are also more informative. And several | ||
67 | autoconf detection routines were fixed. | ||
68 | </para> | ||
69 | <para> | ||
70 | It also adds the dbi provider which works for adding SQL content to postgresql and mysql servers, | ||
71 | but does not support the auto creation of tables in either database. | ||
72 | The pgsql driver stub is also included, which is no where near completed. | ||
73 | </para> | ||
74 | <para> | ||
75 | For win32 users, the build scripts are included in the distribution now, read the | ||
76 | changelog for the 1.98 release for more information. If anyone wishes to contribute a | ||
77 | MSVC project file they will be welcomed. | ||
78 | </para> | ||
79 | </content> | ||
80 | </entry> | ||
81 | <entry version="1.98"> | ||
82 | <content type="docbook"> | ||
83 | <para> | ||
84 | Contains a new configuration directives to control the Preserve file, | ||
85 | LogSQLDisablePreserve. This option completely disables the preserve | ||
86 | file, so if the Database cannot be contacted, those records will be | ||
87 | lost and not logged. Also the LogSQLPreserveFile is now relative, if | ||
88 | it does not begin with a "/", to the ServerRoot and defaults | ||
89 | to logs/mod_log_sql-preserve. It will appear with your log files now. | ||
90 | </para> | ||
91 | <para> | ||
92 | Also in this release is the much requested Win32 support. I have added 2 | ||
93 | batch scripts to compile mod_log_sql for apache 1.3 and apache 2.0. You | ||
94 | will need to edit the files to setup the include and library paths for | ||
95 | compiling. I compiled this with the free Command line compiler provided | ||
96 | by Microsoft, Apache 2.0.49 and 1.3.29, Mysql 4.0, and the MS SDK from | ||
97 | Microsoft's website. I had to obtain the msvcrt.lib file from a MS VS | ||
98 | installation to get the dlls to compile, however. If anybody can | ||
99 | contribute a MSVC 6 project or nmake Makefiles I would greatly | ||
100 | appreciate it. | ||
101 | </para> | ||
102 | <note role="important"> | ||
103 | <simpara> | ||
104 | Unfortunately due to the license that the free compiler from Microsoft | ||
105 | has I can not distribute binaries for Win32. | ||
106 | </simpara> | ||
107 | </note> | ||
108 | </content> | ||
109 | </entry> | ||
110 | <entry version="1.97"> | ||
111 | <content type="docbook"> | ||
112 | <para> | ||
113 | This release has several changes so be sure to read the | ||
114 | documentation and Changelog. Changes are a new LogSQLLoginInfo syntax which | ||
115 | better allows configuring mod_log_sql with multiple databases.. basic example. | ||
116 | </para> | ||
117 | <programlisting>mysql://loguser:Mypass@dbhost/apache_log</programlisting> | ||
118 | <para> | ||
119 | Also the mysql code is not in a separate module that must be loaded after | ||
120 | the core mod_log_sql.so, so you will NEED to add this to your httpd.conf | ||
121 | file. | ||
122 | </para> | ||
123 | <programlisting>LoadModule log_sql_mysql_module modules/mod_log_sql_mysql.so</programlisting> | ||
124 | </content> | ||
125 | </entry> | ||
126 | <entry version="1.9.6"> | ||
127 | <content type="docbook"> | ||
128 | <para> | ||
129 | This release offers a new configuration directive to configure Database | ||
130 | configuration options. LogSQLDBParam should be used over LogSQLTcpPort, | ||
131 | LogSQLDatabase, and LogSQLSocketFile. as they are deprecated, and will | ||
132 | most likely be removed in future versions. | ||
133 | </para> | ||
134 | </content> | ||
135 | </entry> | ||
136 | </changelog> | ||
137 | |||
138 | <section title="Documentation"> | ||
139 | <content> | ||
140 | <div xmlns="http://www.w3.org/1999/xhtml"> | ||
141 | <a href="docs/">mod_log_sql 1.18 documentation</a><br/> | ||
142 | <a href="docs-2.0/">mod_log_sql 2.0 documentation</a> | ||
143 | </div> | ||
144 | </content> | ||
145 | </section> | ||
146 | |||
147 | <requirements> | ||
148 | <title>Prerequisites</title> | ||
149 | <software name="MySQL" url="http://www.mysql.com/"> | ||
150 | <requirement version="3.23.30" type="minimum"/> | ||
151 | </software> | ||
152 | <software name="libDBI" url="http://libdbi.sourceforge.net/" optional="1"> | ||
153 | <requirement version="0.7.0" type="minimum"/> | ||
154 | </software> | ||
155 | <software name="Apache HTTPd" url="http://httpd.apache.org/"> | ||
156 | <requirement version="2.0.40" type="minimum"/> | ||
157 | <requirement version="1.3.20" type="minimum"/> | ||
158 | </software> | ||
159 | </requirements> | ||
160 | |||
161 | <downloads | ||
162 | name="mod_log_sql" | ||
163 | baseref="/downloads/mod_log_sql/"> | ||
164 | <category branch="development" latest="1.99" extension="tar.gz"> | ||
165 | <download version="1.101" extension="tar.bz2" md5sum="16157f311eba364d8ee467078e7cc086"/> | ||
166 | <download version="1.100" extension="tar.bz2" md5sum="b54657ad270cffc34dfab12302c53306"/> | ||
167 | <download version="1.99" md5sum="e246a3d8e96d2d62715eb34f75c7c11d"> | ||
168 | <patch shortname="config Patch" version="1.99" extension="diff"> | ||
169 | This patch stops configure from erroring out if libdbi is not detected | ||
170 | on the system. | ||
171 | </patch> | ||
172 | <patch shortname="config Patch" version="1.99-2" extension="diff"> | ||
173 | This patch fixes loggin request_args(a) and fixes the MySQL reconnect segfault. | ||
174 | </patch> | ||
175 | </download> | ||
176 | <download version="1.98" md5sum="122a7f8a42876ff8ab0d1369dfe4d201"/> | ||
177 | <download version="1.97" md5sum="6e5616dbb6eec5e1acd2d3fd8b42e5be"> | ||
178 | <patch shortname="config Patch" version="1.97" extension="diff"> | ||
179 | This patch fixes a compile issues with certain builds of Apache 2 which | ||
180 | generate the "PACKAGE_NAME" redefined error. | ||
181 | </patch> | ||
182 | </download> | ||
183 | <download version="1.96" md5sum="3212f333fc29d013d0b6d9f7dd477fa2"/> | ||
184 | <download version="1.95" md5sum="fcbacbac6e180e9ec46631b181ba12d9"/> | ||
185 | <download version="1.94" md5sum="0a6d403f29ec00cf10dbeb282b85c49c"/> | ||
186 | <download version="1.93" md5sum="5314a79fd78b9014cc1952b873168e8f"/> | ||
187 | <download version="1.92" md5sum="5f8c17fd6f7bda1c2dc8513b747e7468"/> | ||
188 | <download name="mod-log-sql" version="1.91" md5sum="a5da1e34368e74848a9464cb45094bcc"/> | ||
189 | <download name="mod-log-sql" version="1.90" md5sum="f9dc3814f375f6a36a32cb2ebc69c11e"/> | ||
190 | </category> | ||
191 | <category branch="stable"> | ||
192 | <title>Historic version 1.18 (Last stable release for Apache 1.3 only)</title> | ||
193 | <download extension="tar.bz2" version="1.18" md5sum="27a83f0555a53353ab1a7adf8c4b25ad"/> | ||
194 | </category> | ||
195 | <category> | ||
196 | <title>Repositories</title> | ||
197 | <repository | ||
198 | type="svn" | ||
199 | name="mod_log_sql" | ||
200 | baseref="http://svn.outoforder.cc/" | ||
201 | view="chora"/> | ||
202 | </category> | ||
203 | </downloads> | ||
204 | |||
205 | <section title="Unofficial Binaries" position="bottom"> | ||
206 | <content> | ||
207 | <div xmlns="http://www.w3.org/1999/xhtml"> | ||
208 | <h4>Debian</h4> | ||
209 | <p> | ||
210 | Thanks to Thomas Goirand, Debian users can add the following repository to | ||
211 | their /etc/apt/sources.list if using stable branch of Debian (mod_log_sql 1.18 only):</p> | ||
212 | |||
213 | <p><code>deb ftp://ftp.gplhost.com/debian stable main</code></p> | ||
214 | <p>This repository also includes the following packages: dtc, qmail, ucspi-tcp,mysqmail | ||
215 | and checklocalpasswd.</p> | ||
216 | <p>The packages can also be downloaded separately for version 1.18 and 1.9x on the | ||
217 | <a href="http://www.gplhost.com/?rub=softwares&sousrub=logsql">GPLHost website.</a> | ||
218 | <p><b>NOTE:</b> Please direct any issues with these binary releases to Thomas Goirand (links on | ||
219 | the his website), or to the mod_log_sql mailing list.</p> | ||
220 | </p> | ||
221 | </div> | ||
222 | <div xmlns="http://www.w3.org/1999/xhtml"> | ||
223 | <h4>Win32</h4> | ||
224 | <p>There are no win32 binaries provided by anyone at this time. If you wish to build them | ||
225 | there is a build.bat provided in the source distribution to build with MySQL and Apache 1.3.x and | ||
226 | Apache 2.0.x. However, remember that win32 is an unsupported platform for running mod_log_sql.</p> | ||
227 | </div> | ||
228 | </content> | ||
229 | </section> | ||
230 | |||
231 | <mailinglists spam="warning"> | ||
232 | <content type="docbook"> | ||
233 | <para> | ||
234 | There are two mailing lists for mod_log_sql. The first is the generic announcement mailing list which | ||
235 | provides announcements for all software releases on OutOfOrder.cc, but can be filtered by | ||
236 | choosing topics in the mailing list options page. The second is the user mailing list specific to | ||
237 | mod_log_sql only. Release announcements will be cross posted to both lists. | ||
238 | </para> | ||
239 | </content> | ||
240 | <list> | ||
241 | <mailinglist name="announce" type="mailman" host="lists.outoforder.cc"/> | ||
242 | <mailinglist name="mod_log_sql" type="mailman" host="lists.outoforder.cc"/> | ||
243 | </list> | ||
244 | </mailinglists> | ||
245 | |||
246 | <section position="bottom"> | ||
247 | <title>Contact & Help</title> | ||
248 | <content type="docbook"> | ||
249 | <para> | ||
250 | E-Mail me, <ulink url="/email/?Alias=Edward+Rudd&Subject=mod_log_sql">Edward Rudd</ulink>, about mod_log_sql. | ||
251 | </para> | ||
252 | <para> | ||
253 | Send an e-mail to the <link linkend="mailinglist">mod_log_sql mailing list</link>. | ||
254 | </para> | ||
255 | <para> | ||
256 | Bugs should be reported to the <ulink url="http://bugs.outoforder.cc">OutOfOrder.cc Bug Tracker</ulink>. | ||
257 | </para> | ||
258 | </content> | ||
259 | </section> | ||
260 | </ooo> | ||