Bug#680476: release-notes: Note for SASL systems upgraded from Squeeze to Wheezy

[Julien Cristau]

On Fri, Jul  6, 2012 at 18:14:30 +1000, Russell Coker wrote:

> Package: release-notes
> Severity: normal
> 
> If a system using SASL authentication via a MySQL database is upgraded from
> Squeeze to Wheezy then it will stop working with no clear explanation.
> 
This is now included in a NEWS.Debian file in the package, but I'm going
to add the below to the release notes.  Please follow-up ASAP if you
want adjustments made.

diff --git a/en/issues.dbk b/en/issues.dbk
index 3c2852b..31f3cdf 100644
--- a/en/issues.dbk
+++ b/en/issues.dbk
@@ -363,4 +363,30 @@ master is able to manage a 2.6 client system.
   </para>
 </section>
 
+<section id="cyrus-sasl">
+  <title>Cyrus SASL SQL backends</title>
+  <para>
+    Configuration of SQL engine backends for Cyrus SASL, as provided in the
+    <systemitem role="package">libsasl2-modules-sql</systemitem> package, has
+    changed from database specific configuration (e.g.
+    <literal>mysql</literal>) to the generic <literal>sql</literal> auxprop
+    plugin.
+  </para>
+  <para>
+    Configuration files for applications using SASL have to be updated, for
+    example:
+    <screen>
+auxprop_plugin: mysql</screen>
+    should be replaced by:
+    <screen>
+auxprop_plugin: sql
+sql_engine: mysql</screen>
+  </para>
+  <para>
+    In addition, the SQL query (if used) needs to have <literal>%u</literal>
+    replaced with <literal>%u@%r</literal>, because user and realm are now
+    provided separately.
+  </para>
+</section>
+
 </chapter>

Cheers,
Julien
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-cyrus-sasl2-debian-devel/attachments/20130502/24601897/attachment.pgp>