Installing Percona XtraDB Cluster on Red Hat Enterprise Linux and CentOS

Installing Percona XtraDB Cluster on Red Hat Enterprise Linux and CentOS

Percona provides .rpm packages for 64-bit versions of Red Hat Enterprise Linux 7 (Maipo) and Red Hat Enterprise Linux 8 (Ootpa) including its derivatives that claim full binary compatibility, for example: CentOS, Oracle Linux, Amazon Linux AMI, and so on.

Note

Percona XtraDB Cluster should work on other RPM-based distributions,

but it is tested only on RHEL and CentOS versions 7 and 8.

The packages are available in the official Percona software repository and on the download page. It is recommended to intall 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.

Download PDF Manual

Table Of Contents

This Page

Percona XtraDB Cluster Series