Percona Distribution for MySQL

Enable Repository

We recommend to use the setup subcommand of percona-release to enable the desired repository.

For Percona Server for MySQL-based deployment, use the following command:

$ sudo percona-release setup pdps-8.0

For Percona XtraDB Cluster-based deployment, use the following command:

$ sudo percona-release setup pdpxc-8.0

Install Percona Server for MySQL-based deployment on Debian / Ubuntu

Install the selected deployment of Percona Distribution for MySQL using the commands of the package manager of your operating system.

1. Install Percona Server for MySQL:

    

   $ sudo apt-get install percona-server-server

2. Install the components. Use the commands below to install the required components:

    

   $ #Install Percona XtraBackup 
   $ sudo apt-get install percona-xtrabackup-80 
   $ #Install Percona Toolkit 
   $ sudo apt-get install percona-toolkit 
   $ #Install Orchestrator 
   $ sudo apt-get install percona-orchestrator percona-orchestrator-cli percona-orchestrator-client 
   $ #Install MySQL Shell 
   $ sudo apt-get install percona-mysql-shell 
   $ #Install ProxySQL 
   $ sudo apt-get install proxysql2 
   $ #Install MySQL Router 
   $ sudo apt-get install percona-mysql-router

Install Percona Server for MySQL-based deployment on Red Hat Enterprise Linux / CentOS

On CentOS 7, install the epel-release package. It includes the dependencies required to install Orchestrator. Use the following command:

$ sudo yum -y install epel-release

1. Install Percona Server for MySQL:

   $ sudo yum install percona-server-server

2. Install the components. Use the commands below to install the required components:

   $ #Install Orchestrator
   $ sudo yum install percona-orchestrator percona-orchestrator-cli percona-orchestrator-client
   $ #Install Percona XtraBackup
   $ sudo yum install percona-xtrabackup-80
   $ #Install Percona Toolkit
   $ sudo yum install percona-toolkit
   $ #Install MySQL Shell
   $ sudo yum install percona-mysql-shell
   $ #Install ProxySQL
   $ sudo yum install proxysql2
   $ #Install MySQL Router
   $ sudo yum install percona-mysql-router

3. Running Percona Distribution for MySQL

   Percona Distribution for MySQL is not started automatically on Red Hat Enterprise Linux and CentOS after the installation is complete. Start it manually using the following command:

   $ sudo systemctl start mysql

   Confirm that the service is running:

   $ sudo systemctl status mysql

   Stop the service:

   $ sudo systemctl stop mysql

Install Percona XtraDB Cluster-based deployment on Debian / Ubuntu

1. Install Percona XtraDB Cluster:

    

   $ sudo apt-get install percona-xtradb-cluster

2. Install HAProxy:

    

   $ sudo apt-get install percona-haproxy

3. Install the components. Use the commands below to install the required components:

    

   $ #Install Percona XtraBackup
   $ sudo apt-get install percona-xtrabackup-80
   $ #Install Percona Toolkit
   $ sudo apt-get install percona-toolkit

Install Percona XtraDB Cluster-based deployment on Red Hat Enterprise Linux / CentOS

1. Install Percona XtraDB Cluster:

    

   $ sudo yum install percona-xtradb-cluster

2. Install HAProxy:

    

   $ sudo yum install percona-haproxy

3. Install the components. Use the commands below to install the required components:

    

   $ #Install Percona XtraBackup
   $ sudo yum install percona-xtrabackup-80
   $ #Install Percona Toolkit
   $ sudo yum install percona-toolkit

4. Running Percona Distribution for MySQL

    

   Percona Distribution for MySQL is not started automatically on Red Hat Enterprise Linux and CentOS after the installation is complete. Start it manually using the following command:

   $ sudo systemctl start mysql

   Confirm that the service is running:

   $ sudo systemctl status mysql

   Stop the service:

   $ sudo systemctl stop mysql