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> --