DEB-Based GNU/Linux Distributions¶

If you are running a DEB-based distribution, such as Debian or Ubuntu, use the apt package manager to install the percona-release official package:

dpkg: error processing package percona-release (--install):
installed percona-release package post-installation script subprocess returned error exit status 255

$ sudo apt-get update
$ sudo apt-get install -y wget gnupg2 lsb-release curl

1. Fetch the repository package:

   $ wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
   

2. Install the downloaded repository package with dpkg:

   $ sudo dpkg -i percona-release_latest.generic_all.deb
   

   Note

   If dpkg fails at this step due to missing dependencies, run apt as follows:

   $ sudo apt-get install --fix-broken
   

3. Once you install this package the Percona repositories should be available. You can check the repository setup in the /etc/apt/sources.list.d/percona-release.list file.

With percona-release package installed, run the percona-release command to set up the repository that contains the Percona product that you intend to install.

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:

$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm

With percona-release package installed, run the percona-release command to set up the repository that contains the Percona product that you intend to install.

Commands¶

Available commands are enable, enable-only, disable, setup and show:

• show command shows the enabled repositories in your system:

  $ sudo percona-release show
  

  Sample output

  The following repos are enabled on your system:
  http://repo.percona.com/percona/apt
  http://repo.percona.com/prel/apt
  

• enable command turns on an additional Percona repository location. For example, the following command enables the ps-80 release repository location:

  $ sudo percona-release enable ps-80 release
  

• enable-only command 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 psmdb-40 experimental:

  $ sudo percona-release enable-only psmdb-40 experimental
  

• disable disables the specified repositories (or just all of them). For example, following command will disable all repository locations:

  $ sudo percona-release disable all
  

  Note

  The prel repository remains enabled. This repository stores the percona-release packages and is always enabled for percona-release to operate.

• setup <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 (the names of products are self-explanatory):

  ps56 ps57 ps80 psmdb34 psmdb36 psmdb40 psmdb42 psmdb44 pxb24 pxb80 pxc56 pxc57 pxc80 ppg11 ppg11.5 ppg11.6 ppg11.7 ppg11.8 ppg11.9 ppg11.10 ppg12 ppg12.2 ppg12.3 ppg12.4 ppg12.5 ppg13 ppg13.0 ppg13.1

  pdmdb4.2 pdmdb4.2.6 pdmdb4.2.7 pdmdb4.2.8 pdmdb4.2.9 pdmdb4.2.10 pdmdb4.2.11 pdmdb4.4 pdmdb4.4.0 pdmdb4.4.1 pdmdb4.4.2 pdps8.0 pdps8.0.19 pdps8.0.20 pdps8.0.21 pdps8.0.22 pdpxc8.0 pdpxc8.0.19 pdpxc8.0.20 pdpxc8.0.21 prel proxysql sysbench pt pmm-client pmm2-client mysql-shell pbm

  The following example disables all Percona repository locations and then enables the release repository for Percona Server for MySQL 8.0. This command runs in the interactive mode and may request extra input from you, depending on your platform.

  $ percona-release setup ps80
  

  In non-interactive contexts, such as in scripts, requests for extra input may halt the program. Run the setup command with the -y option to provide the affirmative answer where input from the user would be requested in the interactive mode.

  $ percona-release setup -y ps80
  

Repository locations¶

Repository location may contain two parts: a repository and a component. Available repositories are:

Components¶

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 default), testing, and experimental components.

For example, to prepare your system for installation of Percona Server for MySQL 8.0, run percona-release as follows:

$ sudo percona-release enable-only ps-80 release

To enable pre-release builds from the testing repository, run percona-release with the testing component.

$ sudo percona-release enable ps80 testing

This example enables installing a pre-release version of Percona Server for MySQL 8.0.