Installing Percona XtraDB Cluster on Debian or Ubuntu¶
.deb packages for 64-bit versions
of the following distributions:
- Debian 7 (“wheezy”)
- Debian 8 (“jessie”)
- Ubuntu 12.04 LTS (Precise Pangolin)
- Ubuntu 14.04 LTS (Trusty Tahr)
- Ubuntu 16.04 LTS (Xenial Xerus)
- Ubuntu 18.04 LTS (Bionic Beaver)
- Ubuntu 18.10 (Cosmic Cuttlefish)
Percona XtraDB Cluster should work on other DEB-based distributions, but it is tested only on platforms listed above.
The packages are available in the official Percona software repository
and on the download page.
It is recommended to install Percona XtraDB Cluster from the official repository
You need to have root access on the node where you will be installing
Percona XtraDB Cluster (either logged in as a user with root privileges or be able
to run commands with
Make sure that the following ports are not blocked by firewall or used by other software. Percona XtraDB Cluster requires them for communication.
If MySQL Is Installed
If you previously had MySQL installed on the server, there might be an
which will prevent Percona XtraDB Cluster nodes from communicating with each other.
The best solution is to remove the
apparmor package entirely:
$ sudo apt-get remove apparmor
If you need to have AppArmor enabled due to security policies or for other reasons, it is possible to disable or extend the MySQL profile.
Dependencies on Ubuntu
When installating on a Ubuntu system, make sure that the
repository is enabled to satisfy all essential dependencies.
- Ubuntu Documentation: Repositories
Installing from Repository¶
Configure Percona repositories as described in Percona Software Repositories Documentation.
Install the Percona XtraDB Cluster server package:
$ sudo apt-get install percona-xtradb-cluster-57
Alternatively, you can install the
percona-xtradb-cluster-full-57meta package, which contains the following additional packages:
During installation, you will be prompted to provide a password for the
rootuser on the database node.
$ sudo service mysql stop
All Debian-based distributions start services as soon as the corresponding package is installed. Before starting a Percona XtraDB Cluster node, it needs to be properly configured. For more information, see Configuring Nodes for Write-Set Replication.