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

Preconditions¶

To upgrade Percona Distribution for MySQL, install the percona-release repository management tool or update it to the latest version.

Important

Run the following commands as the root user or via sudo.

Upgrade Percona Server-based variantUpgrade Percona XtraDBCluster-based variant

Enable Percona repository

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:
```
$ sudo percona-release setup pdps-XXX 
```
where XXX is the required version.

Read more about major and Minor release repositories in Repository overview.
Stop mysql service
```
$ sudo systemctl mysql stop
```
Install new version packages using the package manager of your operating system.
Restart mysql service:
```
$ sudo systemctl mysql start
```

Complete these steps sequentially on all nodes:

Enable Percona repository

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:
```
$ sudo percona-release setup pdpxc-XXX 
```
where XXX is the required version.

Read more about major and Minor release repositories in Repository overview.
Stop mysql service
```
$ sudo systemctl mysql stop
```
Install new version packages using the package manager of your operating system.
Back up the grastate.dat file
Restart mysql service
```
$ sudo systemctl mysql start
```