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

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.