Installing Percona XtraDB Cluster on Debian or Ubuntu

Percona provides .deb packages for 64-bit versions of the following distributions:

  • Debian 9 (stretch)
  • Debian 10 (buster)
  • Ubuntu 16.04 LTS (Xenial Xerus)
  • Ubuntu 18.04 LTS (Bionic Beaver)
  • Ubuntu 20.04 LTS (Bionic Beaver)

Note

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 using apt.

Prerequisites

  • 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 sudo).

  • Make sure that the following ports are not blocked by firewall or used by other software. Percona XtraDB Cluster requires them for communication.

    • 3306
    • 4444
    • 4567
    • 4568
  • If you previously had MySQL installed on the server, there might be an AppArmor profile 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.

Installing from Repository

  1. Configure Percona repositories as described in Percona Software Repositories Documentation.

  2. Install the Percona XtraDB Cluster server package:

    $ sudo apt-get install percona-xtradb-cluster
    

    Note

    Alternatively, you can install the percona-xtradb-cluster-full meta package, which contains the following additional packages:

    • libperconaserverclient21-dev
    • libperconaserverclient21
    • percona-xtradb-cluster-client
    • percona-xtradb-cluster-common
    • percona-xtradb-cluster-dbg
    • percona-xtradb-cluster-full
    • percona-xtradb-cluster-garbd-debug
    • percona-xtradb-cluster-garbd
    • percona-xtradb-cluster-server-debug
    • percona-xtradb-cluster-server
    • percona-xtradb-cluster-source
    • percona-xtradb-cluster-test
    • percona-xtradb-cluster

    During the installation, you are requested to provide a password for the root user on the database node.

Next Steps

After you install Percona XtraDB Cluster and stop the mysql service, configure the node according to the procedure described in Configuring Nodes for Write-Set Replication.