Bug 258494 : checksetup fails with out-of-sync DBD::mysql modues - document fix and...

Patch by Shane H. W. Travis <travis@sedsystems.ca>   r=justdave

diff --git a/docs/xml/troubleshooting.xml b/docs/xml/troubleshooting.xml
index 2f07a7cb65db295a49be991982169d9ead07d14c..f4977db683fdd1070f4b5744ea39bc72b5e85549 100644 (file)
--- a/docs/xml/troubleshooting.xml
+++ b/docs/xml/troubleshooting.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: troubleshooting.xml,v 1.2.2.3 2004/12/21 20:55:52 jake%bugzilla.org Exp $ -->
+<!-- $Id: troubleshooting.xml,v 1.2.2.4 2005/02/05 04:33:42 travis%sedsystems.ca Exp $ -->
 
 <appendix id="troubleshooting">
 <title>Troubleshooting</title>
@@ -306,6 +306,31 @@ at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.</programlisting>
 
   </section>
 
+  <section id="trbl-passwd-encryption">
+    <title>
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </title>
+
+    <para>
+      This error is occurring because you are using the new password
+      encryption that comes with MySQL 4.1, while your
+      <filename>DBD::mysql</filename> module was compiled against an
+      older version of MySQL. If you recompile <filename>DBD::mysql</filename>
+      against the current MySQL libraries (or just obtain a newer version
+      of this module) then the error may go away.
+    </para>
+
+    <para>
+      If that does not fix the problem, or if you cannot recompile the
+      existing module (e.g. you're running Windows) and/or don't want to
+      replace it (e.g. you want to keep using a packaged version), then a
+      workaround is available from the MySQL docs:
+      <ulink url="http://dev.mysql.com/doc/mysql/en/Old_client.html"/>
+    </para>
+
+  </section>
+
 </appendix> 
 
 <!-- Keep this comment at the end of the file