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¶
Configure Percona repositories as described in Percona Software Repositories Documentation.
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
Start the Percona XtraDB Cluster server:
$ sudo service mysql start
Copy the automatically generated temporary password for the superuser account:
$ sudo grep 'temporary password' /var/log/mysqld.log
Use this password to log in as
root
:$ mysql -u root -p
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
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.