This page is outdated! For latest statuses, it is suggested to browse https://salsa.debian.org/mariadb-team
Milestones
- [2013-09-30] 5.5.32 first version to enter Debian NEW queue
- [2013-12-22] 5.5.32 first version to enter Debian unstable
- [2014-03-24] 5.5.36 first version to enter Debian testing
- [2014-04-24] 10.0.10 entered Debian NEW queue
- [2014-07-19] mariadb-client-lgpl 2.0.0 entered Debian NEW queue
- [2014-10-01] 10.0.14 entered Debian experimental
- [2014-10-22] 10.0.14 entered Debian unstable
- [2014-11-01] 10.0.14 entered Debian testing
- [2015-04-26] 10.0.16 released as a MySQL alternative in of Debian 8 "Jessie"
- [2015-06-20] galera-3 25.3.10 entered Debian NEW queue
- [2016-12-21] 10.1.20 entered Debian NEW queue
- [2016-12-24] 10.1.20 entered Debian unstable
- [2017-05-01] 10.3.0 entered Debian NEW queue
- [2017-05-02] 10.3.0 entered Debian unstable
- [2017-06-18] 10.1.23 released as the only MySQL variant in Debian 9 "Stretch"
- [2019-06-06] 10.3 releases with Buster
- [2020-02-23] 10.4.12 entered Debian experimental
Contribute
Please contribute by sending Merge Requests at https://salsa.debian.org/mariadb-team/mariadb-10.5
Old notes
Debian
* Complete Debian package listings: mariadb
5.5
ITP closed: 565308
- 5.5 was removed from Debian in November 2014 when it was replaced by 10.0
10.0
ITP closed: 740473
Current master (for debian/* packaging) at http://git.debian.org/?p=pkg-mysql/mariadb-10.0.git (mirrored at https://github.com/ottok/mariadb-10.0 for easy public pull requests)
Build status: https://buildd.debian.org/status/package.php?p=mariadb-10.0
Quality assurance page: mariadb-10.0
Piuparts status: https://piuparts.debian.org/sid/source/m/mariadb-10.0.html
5.5 Galera
ITP: 740472
- Progress has gone past this, not relevant anymore.
10.0 Galera
ITP: 740474
- Progress has gone past this, not relevant anymore.
10.1 (includes Galera WSREP consumer patches)
Current master (for debian/* packaging) at http://git.debian.org/?p=pkg-mysql/mariadb-10.1.git (mirrored at https://github.com/ottok/mariadb-10.1 for easy public pull requests)
Build status: https://buildd.debian.org/status/package.php?p=mariadb-10.1
Quality assurance page: mariadb-10.1
Piuparts status: https://piuparts.debian.org/sid/source/m/mariadb-10.1.html
Galera package (WSREP provider)
See separate page Galera
MariaDB Connector C++ (LGPL version)
MariaDB Manager and Admin Tools
MariaDB recommends MONyog & SQLyog: Not- but nothing gpl ? https://mariadb.com/kb/en/mariadb/graphical-and-enhanced-clients/
- Some say, that mysql-workbench works - and it is in Stretch
Downstream
Ubuntu inherits packages from Debian:
Ubuntu package listings: http://packages.ubuntu.com/search?keywords=mariadb&searchon=names&suite=all§ion=all
Official Ubuntu versions (inherited from Debian): https://launchpad.net/ubuntu/+source/mariadb-5.5
Development PPA: https://launchpad.net/~mysql-ubuntu/+archive/mariadb
- As of 2014-01-11 mariadb-5.5 landed in UNIVERSE and is released in Ubuntu 14.04 LTS
https://blueprints.launchpad.net/ubuntu/+spec/servercloud-s-database-alternatives
Note that Ubuntu automatically also provides debug packages. For details see
As of the release of Debian 9, now also Debian provides debug packages. For details see:
Ubuntu micro release procedure (security update):
- MRE status granted by the Ubuntu technical board on May 15th, 2014
branch https://code.launchpad.net/~ubuntu-branches/ubuntu/trusty/mariadb-5.5/trusty
send with bzr lp-propose and get review and sponsor upload
Binaries for public testing
The directory http://labs.seravo.fi/~otto/mariadb-repo/ is browseable and there you can find build logs and both binary and source packages. Build logs have the git hash appended so it is possible to track build logs per commit.
Latest test packages can be installed after adding the sources.list line corresponding to your distro:
# Debian unstable deb http://labs.seravo.fi/~otto/mariadb-repo/ mariadb-10.1-sid-amd64/ deb http://labs.seravo.fi/~otto/mariadb-repo/ mariadb-10.1-sid-i386/ deb http://labs.seravo.fi/~otto/mariadb-repo/ mysql-defaults-sid-amd64/ deb http://labs.seravo.fi/~otto/mariadb-repo/ mysql-defaults-sid-i386/ # Debian stable deb http://labs.seravo.fi/~otto/mariadb-repo/ mariadb-10.0-jessie-amd64/ deb http://labs.seravo.fi/~otto/mariadb-repo/ mariadb-10.0-jessie-i386/ # Ubuntu latest LTS deb http://labs.seravo.fi/~otto/mariadb-repo/ mariadb-5.5-trusty-amd64/ deb http://labs.seravo.fi/~otto/mariadb-repo/ mariadb-5.5-trusty-i386/ deb http://labs.seravo.fi/~otto/mariadb-repo/ mariadb-10.0-xenial-amd64/ deb http://labs.seravo.fi/~otto/mariadb-repo/ mariadb-10.0-xenail-i386/
For a full list of available repositories, please browse http://labs.seravo.fi/~otto/mariadb-repo/
There is also a Launchpad page that provides public build logs and testable binaries via PPA repository. See https://launchpad.net/~mysql-ubuntu/+archive/ubuntu/mariadb-10.0/+builds?build_text=&build_state=all (link to 10.0 - other series also available)
Building yourself
Basically you can just run gbp-clone --pristine-tar git://github.com/ottok/mariadb-X.git to check out the code in all branches and then run git-buildpackage --git-pristine-tar to build directly on your own computer, on with --git-pbuilder to use separate chroot environments for installing build dependencies and building. Without pbuilder you need to manually install the build dependencies with apt-get.
See more commands in script at http://labs.seravo.fi/~otto/mariadb-repo/build.sh
Also see the debian/README.Maintaner file inside the package.
TODO
Want to help out? See wishlist/TODO items at https://bugs.debian.org/cgi-bin/pkgreport.cgi?repeatmerged=no&src=mariadb-10.1
Packaging background (historical info)
How MariaDB works
Simply writing apt-get install mariadb-server will install MariaDB 5.5.x and replace any existing MySQL 5.5.x installation and inherit the databases and configuration files of it. Installing mysql-server will do the opposite. However running mysql-server might raise issues if my.cnf contains something MariaDB-specific or if the database files have some MariaDB-specific table metadata. In those cases MySQL should fail gracefully by simply refusing to start until conditions are correct.
Most MariaDB packages have in the control files Provides+Breaks+Replaces for equivalent MySQL packages, so that it is impossible to install both at the same time. Many of the packages contain the same (and thus conflicting) file names and paths as in equivalent MySQL packages.
- Upstream MariaDB 5.5.x advertises to be a binary-compatible replacement for MySQL 5.5.x (but not anymore for MySQL 5.6 vs. MariaDB 10.0). Anything that works with MySQL 5.5 will work with MariaDB 5.5. Migrating from MySQL 5.5 to MariaDB 5.5 will always work. The contrary might not always be true, as at least MariaDB 5.5 libraries (/usr/lib/x86_64-linux-gnu/libmariadbclient.so.18.0.0) have more symbols (e.g. async support) than the MySQL version and some MariaDB enhanced database tables may be unreadable by MySQL 5.5.
Possible "interfaces" of MySQL 5.5 are the server and client binaries (can be used e.g. in shell scripts), the actual server interface (used remotely via port 3306 or locally via socket /var/run/mysqld/mysqld.sock) and the binary interfaces (/usr/lib/x86_64-linux-gnu/libmysqlclient.so.18 and some symbolic links to it, installable from package libmysqlclient18). MariaDB has all of these interfaces, plus the extra libmariadbclient18.so.18.
As upstream MariaDB 5.5 is quite a young fork of MySQL, all of the internal file names still have mysql in them, the database files are in the same location, the configuration file /etc/mysql/my.cnf is the same, the port 3306 is the same etc.
In Debian packages, libmysqlclient.so.* has been renamed to libmariadbclient.so.* to enable both versions to be installable side-by-side. Initial checking did not find that MySQL nor MariaDB would themselves use the shared libs, but have their own libs statically linked in. These shared libs are meant only for third party usage, and the libs themselves will use whatever server is installed (MySQL or MariaDB). While libmysqlclient18 and libmariadbclient18 are co-installable, the -dev versions have files with same filenames and they conflict, thus making -dev versions NOT co-installable.
However in Oct 2014 the libmariadbclient package was completely removed in favor of mariadb-client-lgpl library package: http://anonscm.debian.org/cgit/pkg-mysql/mariadb-10.0.git/commit/?id=24ed76b33cb076ef886b9637d96aa310cb8efa88
Mariadb-common is an empty metapackage that depends on mysql-common. MariaDB 5.5 can always use a my.cnf that originates from MySQL 5.5, but it might not work the other way around if the user has added some MariaDB-specific parameters in the my.cnf. The default my.cnf should always be compatible with all MySQL and MariaDB versions (5.5, 5.6, 10.0 and foreseeable future). Any options which are unique to one or the other must never appear in a shipped my.cnf.
- To mitigate migration confusion, installing MariaDB will show a dialog notifying about the potential one-wayness of the migration.
- As MariaDB stores data in /var/lib/mysql, there might be issues if somebody wants to run MySQL after using MariaDB for some time. We could ask upstream to copy /var/lib/mysql into /var/lib/mariadb to be on the safe side. In Debian installing MySQL after MariaDB could also be seen as a downgrade, and trigger the mariadb-server-5.5.preinst:77 downgrade warning. The current solution is simply to issue a warning at MariaDB installation time that the migration for some parts in a one-way migration.
Regarding circular dependencies:
Regarding symbol and soname changes in MariaDB:
Notes related to licensing
In the future it might be possible to run something like
licensecheck --copyright -r . -c . | /usr/lib/cdbs/licensecheck2dep5 > /tmp/copyright
..but at the moment it does not work, so the license file is a hybrid with automation plus manual clean up.
Script license-reconcile can be used to lint the copyright file, but it cannot generate a correct file.
Related issue filed upstream: https://mariadb.atlassian.net/browse/MDEV-5483
Notes about security updates to stable releases
Import latest upstream: git-import-orig --verbose --uscan --pristine-tar 1½. Review and clean up or document any upstream changes to debian/*.
Refresh patches: while quilt push; do quilt refresh; done; quilt pop -a
Update changelog with CVE entries from release notes or https://mariadb.com/kb/en/mariadb/security/
Commit, build locally and upload to https://launchpad.net/~mysql-ubuntu/+archive/ubuntu/mariadb-10.0/+builds?build_text=&build_state=all to verify that the build and test suite is successful on multiple different architectures.
If testing does not reveal regressions, make a signed tag with git tag -s debian/10.0.30-0+deb8u1 and push to git.
Review once more the full diff or and separately just the debian/ directory changes, e.g. https://anonscm.debian.org/cgit/pkg-mysql/mariadb-10.0.git/diff/?id=debian/10.0.30-0%2bdeb8u1&id2=debian/10.0.29-0%2bdeb8u1 and https://anonscm.debian.org/cgit/pkg-mysql/mariadb-10.0.git/diff/debian/?id=debian/10.0.30-0%2bdeb8u1&id2=debian/10.0.29-0%2bdeb8u1
- Make again the final build with scripts that make sure the build is the latest git head and built using a clean stable release chroot OR build a source only package in any recent Debian environment.
Create compressed debdiff: debdiff old/mariadb-10.0_10.0.29-0+deb8u1.dsc mariadb-10.0_10.0.30-0+deb8u1.dsc | xz > mariadb-10.0_10.0.29-0+deb8u1--10.0.30-0+deb8u1.debdiff.xz
- Send debdiff to security@ for review.
Upload when given permission: dput security-master mariadb-10.0_10.0.30-0+deb8u1.dsc
See also https://www.debian.org/doc/manuals/developers-reference/ch05.en.html#bug-security