Installing Percona XtraDB Cluster on Debian or Ubuntu

Specific information on the supported platforms, products, and versions is described in Percona Software and Platform Lifecycle.

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

Note

To view the listening ports, enter the following command:

$ sudo ss -tunlp

If MySQL Is Installed

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.

Dependencies on Ubuntu

When installing on a Ubuntu system, make sure that the universe repository is enabled to satisfy all essential dependencies.

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-57
    

    Note

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

    • percona-xtradb-cluster-test-5.7
    • percona-xtradb-cluster-5.7-dbg
    • percona-xtradb-cluster-garbd-3.x
    • percona-xtradb-cluster-galera-3.x-dbg
    • percona-xtradb-cluster-garbd-3.x-dbg
    • libmysqlclient18

    During installation, you will be prompted to provide a password for the root user on the database node.

  3. Stop the mysql service:

    $ sudo service mysql stop
    

    Note

    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.

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.

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.