Skip to content

Installing Percona XtraDB Cluster on Red Hat Enterprise Linux and CentOS

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



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


The SELinux security module can constrain access to data for Percona XtraDB Cluster. The best solution is to change the mode from enforcing to permissive by running the following command:

setenforce 0

This only changes the mode at runtime. To run SELinux in permissive mode after a reboot, set SELINUX=permissive in the /etc/selinux/config configuration file.

Installing from Percona Repository

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

  2. Install the Percona XtraDB Cluster packages:

    $ sudo yum install Percona-XtraDB-Cluster-57


    Alternatively you can install the Percona-XtraDB-Cluster-full-57 meta package, which contains the following additional packages:

    • Percona-XtraDB-Cluster-devel-57

    • Percona-XtraDB-Cluster-test-57

    • Percona-XtraDB-Cluster-debuginfo-57

    • Percona-XtraDB-Cluster-galera-3-debuginfo

    • Percona-XtraDB-Cluster-shared-57

  3. Start the Percona XtraDB Cluster server:

    $ sudo service mysql start
  4. Copy the automatically generated temporary password for the superuser account:

    $ sudo grep 'temporary password' /var/log/mysqld.log
  5. Use this password to log in as root:

    $ mysql -u root -p
  6. Change the password for the superuser account and log out. For example:

    mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY 'rootPass';

    The example of the output is the following:

    Query OK, 0 rows affected (0.00 sec)
    mysql> exit
  7. Stop the mysql service:

    $ sudo service mysql stop

Next Steps

After you install Percona XtraDB Cluster and change the superuser account password, configure the node according to the procedure described in Configuring Nodes for Write-Set Replication.