Configuring Percona Repositories with percona-release¶
percona-release configuration tool allows users to automatically
configure which Percona repositories are enabled and disabled.
percona-release can be installed with
apt (for Debian and Ubuntu) or
yum (for Red Hat Enterprise Linux and derivatives) package managers.
DEB-Based GNU/Linux Distributions¶
If you are running a DEB-based distribution, such as Debian or Ubuntu,
apt package manager to install the
Fetch the repository package:
$ wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
Install the downloaded repository package with
$ sudo dpkg -i percona-release_latest.generic_all.deb
Once you install this package the Percona repositories should be added. You can check the repository setup in the
percona-release package installed, run the percona-release command to
set up the repository that contains the Percona product that you intend to
RPM-Based GNU/Linux Distributions¶
If you are running a RPM-based distribution, such as Red Hat Enterprise
Linux or CentOS, use the
yum package manager, by running the following
command as the
root user or with
$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
percona-release package installed, run the percona-release command to set up the repository that contains the
Percona product that you intend to install.
percona-release has the following syntax:
$ sudo percona-release <COMMAND> (<REPOSITORY> | all) [<COMPONENT> | all]
Available commands are
enablecommand turns on an additional Percona repository location. For example, the following command enables the
ps-80 releaserepository location:
$ sudo percona-release enable ps-80 release
enable-onlycommand turns off all Percona repository locations, and enables the listed repository location after that. The following example first disables all Percona repository locations and then enables
$ sudo percona-release enable-only psmdb-40 experimental
disabledisables the specified repositories (or just
allof them). For example, following command will disable all repository locations:
$ sudo percona-release disable all
<PRODUCT>command disables all current Percona repository locations, then enables the correct release repositories given a product use, and updates the platform’s package manager database.
<PRODUCT>is the only parameter of this command, and it can be chosen from the following list:
pxc80(the names are self explanatory). Following example will disable all Percona repository locations and then enable the
releaserepository for Percona Server for MySQL 8.0:
$ percona-release setup ps80
Repository location may contain two parts: a repository and a component.
Available repositories are
originalrepository is the place to get Percona’s products of the previous versions which haven’t yet reach their end of life and are still supported, such as Percona Server for MySQL 5.6 and 5.7, Percona XtraDB Cluster 5.6 and 5.7, Percona Server for MongoDB 3.4 and 3.6, etc.
ps-80repository hosts packages for Percona Server for MySQL 8.0.
pxc-80repository is for Percona XtraDB Cluster 8.0 packages.
psmdb-40repository is hosting Percona Server for MongoDB 4.0 packages.
toolsrepository hosts all other products and tools: Percona XtraBackup 8.0, Percona Toolkit, PMM Client, ProxySQL, etc.
By using a component you may choose to use either the GA version of the selected
product or its beta version. percona-release recognizes
release (used by
|release||Stores released GA packages of products.|
|testing||Is used for final QA and package testing for GA candidate packages of products.|
|experimental||Hosts alpha and beta releases of products|
For example, to prepare your system for installation of Percona Server for MySQL
percona-release as follows:
$ sudo percona-release enable-only ps-80 release
To enable pre-release builds from the testing repository, run percona-release
$ sudo percona-release enable ps80 testing
This example enables installing a pre-release version of Percona Server for MySQL 8.0.
More examples: All steps for installing a specific Percona product¶
Percona XtraDB Cluster 8.0 on CentOS 7:
$ 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
Percona Server for MySQL 8.0, Percona Toolkit, Percona XtraBackup and Sysbench on Ubuntu 18.04:
$ wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb $ sudo dpkg -i percona-release_latest.generic_all.deb $ sudo percona-release enable-only ps-80 release $ sudo percona-release enable tools release $ sudo apt-get update $ sudo apt-get install percona-server-server percona-server-client percona-toolkit percona-xtrabackup-80 sysbench
Percona Server for MySQL 8.0 release package on CentOS or other RPM-based systems:
$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm $ sudo percona-release setup ps80 $ sudo yum install percona-server-server
Percona Server for MongoDB 3.6 release package on Ubuntu or another DEB-based GNU/Linux distribution:
$ wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb $ sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb $ sudo percona-release setup psmdb36 $ sudo apt-get install percona-server-mongodb-36