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

[Vincent McIntyre]

On Sun, Feb 26, 2017 at 05:58:08PM +0100, Baptiste Jammet wrote:
> 
> I add an <important> for the note about binary data file formats
> not backwards compatible, and choose to add default-mysql-* next
> to virtual-mysql-*.
> Updated patch attached, for clarity.

Good idea. I added a 'for example' to the sentence about installing
default-mysql-server. Otherwise this seems ready to me.


Index: en/whats-new.dbk
===================================================================
--- en/whats-new.dbk	(r??vision 11372)
+++ en/whats-new.dbk	(copie de travail)
@@ -302,17 +302,15 @@
         <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>removed</entry>
       </row>
       <row id="new-nginx">
 	<entry>Nginx<indexterm><primary>Nginx</primary></indexterm></entry>
@@ -431,6 +429,46 @@
   </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.
+    For example, installing the metapackage
+    <systemitem role="package">default-mysql-server</systemitem>
+    will install
+    <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 install
+    <systemitem role="package">mariadb-client-10.1</systemitem>.
+    </para>
+    <important><para>
+    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>.
+    </para></important>
+    <para>
+    The <systemitem role="package">virtual-mysql-*</systemitem> and
+    <systemitem role="package">default-mysql-*</systemitem> packages
+    will continue to exist. MySQL continues to be maintained in Debian,
+    in the <literal>unstable</literal> release.
+    See the <ulink url="https://wiki.debian.org/Teams/MySQL">Debian MySQL Team
+    wiki page</ulink> for current information about the mysql-related
+    software available in Debian.
+  </para>
+</section>
+
 <section id="debug-archive">
   <!-- jessie to stretch -->
   <title>A new archive for debug symbols</title>




--