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. Shutdown MariaDB 5.3
  2. Take a backup (this is the perfect time to take a backup of your databases)
  3. Uninstall MariaDB 5.3
  4. Install MariaDB 5.5 [1]
  5. 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)
  6. 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
innodb_change_bufferinginsertsall
innodb_flush_neighbor_pages1area

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.

Notes

  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

Comments loading...
Loading