From: Alan T. DeKok <aland@freeradius.org>
Date: Fri, 10 Aug 2012 13:53:34 +0000 (+0200)
Subject: Document changes to SQL
X-Git-Tag: release_3_0_0_beta0~95
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d47d37bd160420b1c40cc0794d7ba9e0bc534549;p=thirdparty%2Ffreeradius-server.git

Document changes to SQL
---

diff --git a/raddb/README.rst b/raddb/README.rst
index d764b0e73f3..0e6b3b4026b 100644
--- a/raddb/README.rst
+++ b/raddb/README.rst
@@ -72,6 +72,32 @@ The pool configuration adds a number of new configuration options,
 which allow the administrator to better control how FreeRADIUS uses
 SQL connection pools.
 
+The following parameters have been changed::
+
+  trace				-> removed
+  tracefile			-> logfile
+
+The logfile is intended to log SQL queries performed.  If you need to
+debug the server, use debugging mode.  If ``logfile`` is set, then
+*all* SQL queries will go to ``logfile``.
+
+You can now use a NULL SQL database::
+
+  driver = rlm_sql_null
+
+This is an empty driver which will always return "success".  It is
+intended to be used to replace the ``sql_log`` module, and in
+conjunction with the ``radsqlrelay`` program.  Simply take your normal
+configuration for raddb/mods-enabled/sql, and set::
+
+  driver = rlm_sql_null
+  ...
+  logfile = ${radacctdir}/log.sql
+
+And all of the SQL queries will be logged to that file.  The
+connection pool	will still need to be configured for the NULL SQL
+driver, but the defaults will work.
+
 
 EAP
 ---