Upgrading from MariaDB 5.3 to MariaDB 5.5

What you need to know

There are no changes in table or index formats between MariaDB 5.3 and MariaDB 5.5, so on most servers the upgrade should be painless.

How to upgrade

The suggested upgrade procedure is:

  1. For Windows, see Upgrading MariaDB on Windows instead.
  2. Shutdown MariaDB 5.3
  3. Take a backup (this is the perfect time to take a backup of your databases)
  4. Uninstall MariaDB 5.3
  5. Install MariaDB 5.5 [1]
  6. Run mysql_upgrade
    • Ubuntu and Debian packages do this automatically when they are installed; Red Hat, CentOS, and Fedora packages do not
    • mysql_upgrade does two things:
      1. Upgrades the permission tables in the mysql database with some new fields
      2. Does a very quick check of all tables and marks them as compatible with MariaDB 5.5
    • In most cases this should be a fast operation (depending of course on the number of tables)
  7. Add new options to my.cnf to enable features
    • If you change my.cnf then you need to restart mysqld

Incompatible changes between 5.3 and 5.5

As mentioned previously, on most servers upgrading from 5.5 should be painless. However, there are some things that have changed which could affect an upgrade:

XtraDB options that have changed default values

OptionOld valueNew value

Options that have been removed or renamed

Percona, the provider of XtraDB, does not provide all earlier XtraDB features in the 5.5 code base. Because of that, MariaDB 5.5 can't provide them either. The following options are not supported by XtraDB 5.5. If you are using them in any of your my.cnf files, you should remove them before upgrading to 5.5.


  1. If using a MariaDB apt or yum repository, it is often enough to replace instances of '5.3' with '5.5' and then run an update/upgrade. For example, in Ubuntu/Debian update the MariaDB sources.list entry from something that looks similar to this:
    deb http://ftp.osuosl.org/pub/mariadb/repo/5.3/ubuntu trusty main
    To something like this:
    deb http://ftp.osuosl.org/pub/mariadb/repo/5.5/ubuntu trusty main
    And then run
    apt-get update && apt-get upgrade
    And in Red Hat, CentOS, and Fedora, change the baseurl line from something that looks like this:
    baseurl = http://yum.mariadb.org/5.3/centos6-amd64
    To something that looks like this:
    baseurl = http://yum.mariadb.org/5.5/centos6-amd64
    And then run
    yum update

See also


Comments loading...
Content reproduced on this site is the property of its respective owners, and this content is not reviewed in advance by MariaDB. The views, information and opinions expressed by this content do not necessarily represent those of MariaDB or any other party.