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.

Prerequisites

Note

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

Note

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

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
    

    Note

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

    • percona-xtraDB-cluster-shared
    • percona-xtraDB-cluster-shared-compat
    • percona-xtradb-cluster-client
    • percona-xtradb-cluster-debuginfo
    • percona-xtradb-cluster-devel
    • percona-xtradb-cluster-garbd
    • percona-xtradb-cluster-server
    • percona-xtradb-cluster-test
  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';
    Query OK, 0 rows affected (0.00 sec)
    
    mysql> exit
    Bye
    
  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.

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.