Upgrading Percona Distribution for MySQL

Minor releases include bug fixes and feature enhancements. We recommend to have Percona Distribution for MySQL updated to the latest version.

Though minor releases don’t change the behavior, even a minor upgrade is a risky process. We recommend to back up your data before upgrading.

As with installing Percona Distribution for MySQL, the recommended way to upgrade it is from Percona repositories.

Enable Percona repository

Percona repositories are enabled using the percona-release utility. Install percona-release if you haven’t done it already. Otherwise, update it to the latest version. Please refer to Percona repositories documentation for installation and update instructions.

The Major Release repository automatically includes new version packages of Percona Distribution for MySQL. If you installed Percona Distribution for MySQL from a Minor Release repository, enable the new version repository. For more information about Percona Distribution for MySQL repositories, refer to Repository overview.

Upgrading Percona Server for MySQL-based deployment of Percona Distribution for MySQL

Important

Run all commands as root or via sudo.

The upgrade steps are:

  1. Stop mysql service: sudo systemctl mysql stop
  2. Install new version packages. Please refer to Installing Percona Distribution for MySQL for installation instructions relevant to your operating system.
  3. Restart mysql service: sudo systemctl mysql start

Upgrading Percona XtraDB Cluster-based deployment of Percona Distribution for MySQL

Important

Run all commands as root or via sudo.

To upgrade Percona XtraDB Cluster, complete these steps sequentially on all nodes:

  1. Make sure that all Percona XtraDB Cluster nodes are in sync.
  2. Stop mysql service: sudo systemctl mysql stop
  3. Install new version packages. Please refer to Installing Percona Distribution for MySQL for installation instructions relevant to your operating system.
  4. Back up the grastate.dat file
  5. Start mysql service: sudo systemctl mysql start

To upgrade the components, refer to Installing Percona Distribution for MySQL for installation instructions relevant to your operating system.

Contact Us

For free technical help, visit the Percona Community Forum.
To report bugs or submit feature requests, open a JIRA ticket.
For paid support and managed or professional services, contact Percona Sales.