From: travis%sedsystems.ca <>
Date: Sat, 5 Feb 2005 12:33:42 +0000 (+0000)
Subject: Bug 258494 : checksetup fails with out-of-sync DBD::mysql modues - document fix and... 
X-Git-Tag: bugzilla-2.18.1~50
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4d334cb59e143cb7f43be5c4d0cb26e425120db4;p=thirdparty%2Fbugzilla.git

Bug 258494 : checksetup fails with out-of-sync DBD::mysql modues - document fix and workaround
Patch by Shane H. W. Travis <travis@sedsystems.ca>   r=justdave
---

diff --git a/docs/xml/troubleshooting.xml b/docs/xml/troubleshooting.xml
index 2f07a7cb65..f4977db683 100644
--- 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