[debian-mysql] release-notes: update on mysql/mariadb for stretch

[Vincent McIntyre]

Package: release-notes
Severity: normal
Tags: patch


Hello

this is a start on the notes needed regarding mysql/mariadb.
This has been developed in consultation with the mysql package
maintainers. It is probably missing a few pieces that should go
in other chapters, such as upgrading.dbk. Comments welcome.

Index: en/whats-new.dbk
===================================================================
--- en/whats-new.dbk	(revision 11370)
+++ en/whats-new.dbk	(working copy)
@@ -302,17 +302,17 @@
         <entry>3.16 series</entry>
         <entry>4.8 series</entry>
       </row>
-<!--
+
       <row id="new-mariadb">
 	<entry>MariaDB<indexterm><primary>MariaDB</primary></indexterm></entry>
 	<entry>10.0</entry>
-	<entry>10.0?</entry>
+	<entry>10.1</entry>
       </row>
--->
+
       <row id="new-mysql">
 	<entry>MySQL<indexterm><primary>MySQL</primary></indexterm></entry>
 	<entry>5.5</entry>
-	<entry>5.6</entry>
+	<entry>-</entry>
       </row>
       <row id="new-nginx">
 	<entry>Nginx<indexterm><primary>Nginx</primary></indexterm></entry>
@@ -431,6 +431,40 @@
   </para>
 
 </section>
+
+<section id="mariadb-replaces-mysql">
+  <title>MariaDB replaces MySQL</title>
+  <para>
+    MariaDB is now the default MySQL variant in Debian, at version 10.1.
+    The &Releasename; release introduces a new mechanism for switching the
+    default variant, using metapackages created from the
+    <systemitem role="package">mysql-defaults</systemitem> source package.
+    Installing the metapackage 
+    <systemitem role="package">default-mysql-server</systemitem>
+    will pull in 
+    <systemitem role="package">mariadb-server-10.1</systemitem>.
+    Users who had
+    <systemitem role="package">mysql-server-5.5</systemitem> or
+    <systemitem role="package">mysql-server-5.6</systemitem> will have it
+    removed and replaced by the MariaDB equivalent.
+    Similarly, installing
+    <systemitem role="package">default-mysql-client</systemitem>
+    will pull in
+    <systemitem role="package">mariadb-client-10.1</systemitem>.
+    Note that the database binary data file formats are not backwards
+    compatible, so once you have upgraded to MariaDB 10.1 you will
+    not be able to switch back to any previous version of MariaDB or
+    MySQL unless you have a proper database dump. Therefore, before
+    upgrading, please make backups of all important databases with
+    an appropriate tool such as <command>mysqldump</command>.
+    The <systemitem role="package">virtual-mysql-*</systemitem> packages
+    will continue to exist. MySQL continues to be maintained in Debian,
+    in the <literal>unstable</literal> release.
+    See the <ulink url="http://wiki.debian.org/Teams/MySQL">Debian MySQL Team
+    wiki page</ulink> for current information about the mysql-related
+    software availble in Debian.
+  </para>
+
 <section id="debug-archive">
   <!-- jessie to stretch -->
   <title>A new archive for debug symbols</title>

--