GUACAMOLE-728: Document MySQL SSL peculiarities.
diff --git a/src/chapters/jdbc-auth.xml b/src/chapters/jdbc-auth.xml
index d2918f0..235d60b 100644
--- a/src/chapters/jdbc-auth.xml
+++ b/src/chapters/jdbc-auth.xml
@@ -100,7 +100,12 @@
</para>
<para>The MySQL Driver implements several parameters specific to configuring
SSL for secure connections to MySQL servers that support or require
- encrypted communications. The parameters are as follows:</para>
+ encrypted communications. <emphasis>Older versions of MySQL Connector/J
+ have known issues with SSL verification - if you experience problems
+ connecting to SSL-secured MySQL databases it is recommended that
+ you update to a current version of the driver.</emphasis></para>
+ <para>Configuration parameters for MySQL-compatible SSL support are as
+ follows:</para>
<informaltable frame="all">
<tgroup cols="2">
<colspec colname="c1" colnum="1" colwidth="1*"/>
@@ -125,7 +130,11 @@
<term>disabled</term>
<listitem>
<para>Do not use SSL, and fail if the
- server requires it.</para>
+ server requires it. For compatibility
+ this will also set the legacy JDBC
+ driver property
+ <property>useSSL</property> to false.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
