Install Percona XtraDB Cluster on Red Hat Enterprise Linux and CentOS¶
A list of the supported platforms by products and versions is available in Percona Software and Platform Lifecycle.
We gather Telemetry data in the Percona packages and Docker images.
Check out our Get more help for ways that we can work with you.
You can install Percona XtraDB Cluster with the following methods:
-
Use the official repository using YUM
-
Download and manually install the Percona XtraDB Cluster packages from Percona Product Downloads.
-
Use the Percona Software repositories
This documentation describes using the Percona Software repositories.
Prerequisites¶
Installing Percona XtraDB Cluster requires that you either are logged in as a user with root privileges or can run commands with sudo.
The following ports enable communication between cluster nodes and ensure proper replication and synchronization:
| Port | Purpose |
|---|---|
| 3306 | Standard MySQL port for client connections and SST via mysqldump. |
| 4444 | Used for SST via rsync and Percona XtraBackup. |
| 4567 | Handles write-set replication (TCP) and multicast replication (UDP). |
| 4568 | Facilitates Incremental State Transfer (IST) for node synchronization. |
RHEL 8 and other EL8 systems enable the MySQL module by default. This module hides the Percona-provided packages and the module must be disabled to make these packages visible. The following command disables the module:
$ sudo dnf module disable mysql
SELinux should be disabled during installation, but it can be re-enabled once the process is complete.
Install from Percona Software Repository¶
For more information on the Percona Software repositories and configuring Percona Repositories with percona-release, see the Percona Software Repositories Documentation.
RHEL 8 and other EL8 systems enable the MySQL module by default. This module hides the Percona-provided packages and the module must be disabled to make these packages visible. The following command disables the module:
$ sudo dnf module disable mysql
With the release of RHEL 8, yum has been replaced by dnf, representing the next major development of the package manager. Nevertheless, many systems that now use dnf still recognize and support yum commands.
$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
$ sudo percona-release enable-only pxc-80 release
$ sudo percona-release enable tools release
$ sudo yum install percona-xtradb-cluster
$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
$ sudo percona-release setup pxc-80
$ sudo yum install percona-xtradb-cluster
After installation¶
After the installation, start the mysql service and find the temporary password using the grep command.
$ sudo service mysql start
$ sudo grep 'temporary password' /var/log/mysqld.log
Use the temporary password to log into the server:
$ mysql -u root -p
Run an ALTER USER statement to change the temporary password, exit the client, and stop the service.
mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY 'rootPass';
mysql> exit
$ sudo service mysql stop
Next steps¶
Configure the node according to the procedure described in Configuring Nodes for Write-Set Replication.