Installing Percona Server on Red Hat Enterprise Linux and CentOS¶
Ready-to-use packages are available from the Percona Server software repositories and the download page. The Percona yum repository supports popular RPM-based operating systems, including the Amazon Linux AMI.
The easiest way to install the Percona Yum repository is to install an RPM that configures yum and installs the Percona GPG key.
- RHEL 6 (Current Stable) 
- RHEL 7
- RHEL 8
- Amazon Linux AMI (works the same as CentOS 6)
We support red Hat Enterprise Linux (RHEL) and the derivatives: CentOS, Oracle Enterprises Linux, and Amazon Linux for the selected version.
The CentOS repositories should work well with Red Hat Enterprise Linux provided that yum is installed on the server.
CentOS 6 offers an outdated version of the
curl library required by the keyring Vault plugin of Percona Server. The version of the
curl library in CentOS 6, which depends on the
nss library, is known to create memory corruption issues. This
bug is registered in Red Hat Bugzilla. The current status is CLOSED WONTFIX.
If you intend to use the keyring Vault plugin of Percona Server, make sure that you use the latest version of the
curl library. We recommend
that you build it from source configuring with
ssl but without
$ ./configuration --with-ssl --without-nss --prefix=<INSTALATION DIRECTORY>
As soon as you install
curl, make sure that Percona Server will use this version.
- x86_64 (also known as
What’s in each RPM package?¶
Each of the Percona Server RPM packages have a particular purpose.
Percona-Server-server-57 package contains the server itself (the
Percona-Server-57-debuginfo package contains debug symbols for the server.
Percona-Server-client-57 package contains the command line client.
Percona-Server-devel-57 package contains the header files needed to compile software using the client library.
Percona-Server-shared-57 package includes the client shared library.
Percona-Server-shared-compat package includes shared libraries for software compiled against old versions of the client library. Following libraries are included in this package:
Percona-Server-test-57 package includes the test suite for Percona Server.
Installing Percona Server from Percona
- Install the Percona repository
A Percona Server installation or upgrade, by default, creates the mysqld.cnf file. This file is defined as the default configuration and located in the /etc/percona-server.conf.d directory. The directory is created if that directory does not exist.
You can install Percona yum repository by running the following command as a
root user or with sudo:
$ yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
Output exampleRetrieving https://repo.percona.com/yum/percona-release-latest.noarch.rpm Preparing... ########################################### [100%] 1:percona-release ########################################### [100%]
To install Percona Server with SELinux policies, you also need the Percona-Server-selinux-*.noarch.rpm package:$ yum install http://repo.percona.com/centos/7/RPMS/x86_64/Percona-Server-selinux-56-5.6.42-rel84.2.el7.noarch.rpm
Testing the repository
Make sure packages are now available from the repository, by executing the following command:
yum list | grep percona
You should see output similar to the following:
... Percona-Server-57-debuginfo.x86_64 5.7.10-3.1.el7 @percona-release-x86_64 Percona-Server-client-57.x86_64 5.7.10-3.1.el7 @percona-release-x86_64 Percona-Server-devel-57.x86_64 5.7.10-3.1.el7 @percona-release-x86_64 Percona-Server-server-57.x86_64 5.7.10-3.1.el7 @percona-release-x86_64 Percona-Server-shared-57.x86_64 5.7.10-3.1.el7 @percona-release-x86_64 Percona-Server-shared-compat-57.x86_64 5.7.10-3.1.el7 @percona-release-x86_64 Percona-Server-test-57.x86_64 5.7.10-3.1.el7 @percona-release-x86_64 Percona-Server-tokudb-57.x86_64 5.7.10-3.1.el7 @percona-release-x86_64 ... .. note:: For a RHEL 8 package installation, the mysql module must be disabled.
$ sudo dnf module disable mysql
Install the packages
You can now install Percona Server by running:
yum install Percona-Server-server-57
Percona yum Testing repository¶
Percona offers pre-release builds from our testing repository. To subscribe to the testing repository, you’ll need to enable the testing repository in
/etc/yum.repos.d/percona-release.repo. To do so, set both
enabled = 1 (Note that there are 3 sections in this file: release, testing and experimental - in this case it is the second section that requires updating). NOTE: You’ll need to install the Percona repository first (ref above) if this hasn’t been done already.
Installing Percona Server using downloaded rpm packages¶
Download the packages of the desired series for your architecture from the download page. The easiest way is to download bundle which contains all the packages. Following example will download Percona Server 5.7.10-3 release packages for CentOS 7:
$ wget https://www.percona.com/downloads/Percona-Server-5.7/Percona-Server-5.7.10-3/binary/redhat/7/x86_64/Percona-Server-5.7.10-3-r63dafaf-el7-x86_64-bundle.tar
You should then unpack the bundle to get the packages:
$ tar xvf Percona-Server-5.7.10-3-r63dafaf-el7-x86_64-bundle.tar
After you unpack the bundle you should see the following packages:
$ ls *.rpm Percona-Server-57-debuginfo-5.7.10-3.1.el7.x86_64.rpm Percona-Server-client-57-5.7.10-3.1.el7.x86_64.rpm Percona-Server-devel-57-5.7.10-3.1.el7.x86_64.rpm Percona-Server-server-57-5.7.10-3.1.el7.x86_64.rpm Percona-Server-shared-57-5.7.10-3.1.el7.x86_64.rpm Percona-Server-shared-compat-57-5.7.10-3.1.el7.x86_64.rpm Percona-Server-test-57-5.7.10-3.1.el7.x86_64.rpm Percona-Server-tokudb-57-5.7.10-3.1.el7.x86_64.rpm
Now you can install Percona Server 5.7 by running:
rpm -ivh Percona-Server-server-57-5.7.10-3.1.el7.x86_64.rpm \ Percona-Server-client-57-5.7.10-3.1.el7.x86_64.rpm \ Percona-Server-shared-57-5.7.10-3.1.el7.x86_64.rpm
This will install only packages required to run the Percona Server 5.7. Optionally you can install TokuDB storage engine by adding the
Percona-Server-tokudb-57-5.7.10-3.1.el7.x86_64.rpm to the command above. You can find more information on how to install and enable the TokuDB storage in the TokuDB Installation guide.
To install all the packages (for debugging, testing, etc.) you should run:
$ rpm -ivh *.rpm
When installing packages manually like this, you’ll need to make sure to resolve all the dependencies and install missing packages yourself.
Running Percona Server¶
Percona Server stores the data files in
/var/lib/mysql/ by default. You can find the configuration file that is used to manage Percona Server in
Starting the service
Percona Server isn’t started automatically on RHEL and CentOS after it gets installed. You should start it by running:
service mysql start
Confirming that service is running
You can check the service status by running:
service mysql status
Stopping the service
You can stop the service by running:
service mysql stop
Restarting the service
You can restart the service by running:
service mysql restart
RHEL 7 and CentOS 7 come with systemd as the default system and service manager so you can invoke all the above commands with
sytemctl instead of
service. Currently both are supported.
Uninstalling Percona Server¶
To completely uninstall Percona Server you’ll need to remove all the installed packages and data files.
Stop the Percona Server service
service mysql stop
Remove the packages
yum remove Percona-Server*
Remove the data and configuration files
rm -rf /var/lib/mysql rm -f /etc/my.cnf
This will remove all the packages and delete all the data files (databases, tables, logs, etc.), you might want to take a backup before doing this in case you need the data.
|||“Current Stable”: We support only the current stable RHEL6/CentOS6 release because there is no official (i.e., RedHat provided) method to support or download the latest OpenSSL on RHEL/CentOS versions prior to 6.5. Similarly, and also as a result thereof, there is no official Percona way to support the latest Percona Server builds on RHEL/CentOS versions prior to 6.5. Additionally, many users will need to upgrade to OpenSSL 1.0.1g or later (due to the Heartbleed vulnerability), and this OpenSSL version is not available for download from any official RHEL/CentOS repository for versions 6.4 or prior. For any officially unsupported system, src.rpm packages may be used to rebuild Percona Server for any environment. Please contact our support service if you require further information on this.|