Skip to content
logo
Percona Distribution for MySQL
Install Percona Distribution for MySQL
Initializing search
    /percona/pdmysql-docs
    /percona/pdmysql-docs
    • Home
      • Components
      • Deployment variants
      • Install Percona Distribution for MySQL
        • Prerequisites
        • Procedure
          • Enable Percona repository
          • Install Percona Distribution for MySQL packages
          • Enable Percona repository
          • Install Percona Distribution for MySQL packages
          • Enable Percona repository
          • Install Percona Distribution for MySQL packages
          • Enable Percona repository
          • Install Percona Distribution for MySQL packages
          • Run Percona Distribution for MySQL
      • Upgrade Percona Distribution for MySQL
      • Downgrade Percona Distribution for MySQL
      • Technical overview
      • Architecture and components
      • Measurement and monitoring
      • Deployment
      • Replication manager for Percona XtraDB Cluster
      • Replication manager troubleshooting
      • Single replica manager for Percona XtraDB Cluster
      • Uninstalling Percona Distribution for MySQL
      • Release notes index
      • Percona Distribution for MySQL 8.0.32 using Percona Server for MySQL (2023-03-20)
      • Percona Distribution for MySQL 8.0.31 using Percona XtraDB Cluster (2023-03-15)
      • Percona Distribution for MySQL 8.0.31 using Percona Server for MySQL Update (2023-02-15)
      • Percona Distribution for MySQL 8.0.31 using Percona Server for MySQL (2023-02-09)
      • Percona Distribution for MySQL 8.0.30 using Percona XtraDB Cluster Update (2023-01-23)
      • Percona Distribution for MySQL 8.0.30 using Percona Server for MySQL Second Update (2023-01-23)
      • Percona Distribution for MySQL 8.0.30 using Percona Server for MySQL Update (2023-01-06)
      • Percona Distribution for MySQL 8.0.30 using Percona XtraDB Cluster (2022-12-28)
      • Percona Distribution for MySQL 8.0.29 using Percona XtraDB Cluster Update (2022-12-01)
      • Percona Distribution for MySQL 8.0.30 using Percona Server for MySQL (2022-11-29)
      • Percona Distribution for MySQL 8.0.29 using Percona XtraDB Cluster (2022-09-12)
      • Percona Distribution for MySQL 8.0.29 using Percona Server for MySQL (2022-08-09)
      • Percona Distribution for MySQL 8.0.28 using Percona XtraDB Cluster (2022-07-19)
      • Percona Distribution for MySQL 8.0.28 using Percona Server for MySQL Update (2022-06-20)
      • Percona Distribution for MySQL 8.0.28 using Percona Server for MySQL (2022-05-12)
      • Percona Distribution for MySQL 8.0.27 using Percona XtraDB Cluster (2022-04-11)
      • Percona Distribution for MySQL 8.0.27 using Percona Server for MySQL (2022-03-03)
      • Percona Distribution for MySQL 8.0.26 using Percona XtraDB Cluster (2022-01-17)
      • Percona Distribution for MySQL 8.0.26 using Percona Server for MySQL (2021-10-20)
      • Percona Distribution for MySQL 8.0.25 using Percona XtraDB Cluster (2021-11-22)
      • Percona Distribution for MySQL 8.0.25 using Percona Server for MySQL (2021-07-13)
      • Percona Distribution for MySQL 8.0.23 using *Percona XtraDB Cluster* Update (2021-09-15)
      • Percona Distribution for MySQL 8.0.23 using Percona XtraDB Cluster (2021-06-09)
      • Percona Distribution for MySQL 8.0.23 using Percona Server for MySQL (2021-05-12)
      • Percona Distribution for MySQL 8.0.22 using Percona XtraDB Cluster (2021-03-22)
      • Percona Distribution for MySQL 8.0.22 using Percona Server for MySQL (2020-12-14)
      • Percona Distribution for MySQL 8.0.21 using Percona XtraDB Cluster (2020-12-28)
      • Percona Distribution for MySQL 8.0.21 using Percona Server for MySQL (2020-10-13)
      • Percona Distribution for MySQL 8.0.20 using Percona XtraDB Cluster Second Update (2020-10-22)
      • Percona Distribution for MySQL 8.0.20 using Percona XtraDB Cluster Update (2020-10-09)
      • Percona Distribution for MySQL 8.0.20 using Percona XtraDB Cluster (2020-10-01)
      • Percona Distribution for MySQL 8.0.20 using Percona Server for MySQL (2020-07-21)
      • Percona Distribution for MySQL 8.0.19 (2020-06-22)
      • Copyright and Licensing Information
      • Trademark Policy
      • Glossary

    • Prerequisites
    • Procedure
      • Enable Percona repository
      • Install Percona Distribution for MySQL packages
      • Enable Percona repository
      • Install Percona Distribution for MySQL packages
      • Enable Percona repository
      • Install Percona Distribution for MySQL packages
      • Enable Percona repository
      • Install Percona Distribution for MySQL packages
      • Run Percona Distribution for MySQL

    Install Percona Distribution for MySQL¶

    We recommend to install Percona Distribution for MySQL from Percona repositories using the package manager of your operating system:

    • apt - for Debian and Ubuntu Linux
    • yum - for Red Hat Enterprise Linux and compatible Linux derivatives

    Find the full list of supported platforms on the Percona Software and Platform Lifecycle page.

    Repository overview: Major and Minor repositories

    Percona provides two repositories for every deployment variant of Percona Distribution for MySQL.

    The Major Release repository includes the latest version packages (e.g. pdps-8.0 and pdpxc-8.0). Whenever a package is updated, the package manager of your operating system detects that and prompts you to update. As long as you update all Distribution packages at the same time, you can ensure that the packages you’re using have been tested and verified by Percona. Installing Percona Distribution for MySQL from the Major Release Repository is the recommended method.

    The Minor Release repository includes a particular minor release of the database and all of the packages that were tested and verified to work with that minor release (e.g. pdps-8.0.19 and pdpxc-8.0.19). You may choose to install Percona Distribution for MySQL from the Minor Release repository if you have decided to standardize on a particular release which has passed rigorous testing procedures and which has been verified to work with your applications. This allows you to deploy to a new host and ensure that you’ll be using the same version of all the Distribution packages, even if newer releases exist in other repositories.

    The disadvantage of using a Minor Release repository is that you are locked in this particular release. When potentially critical fixes are released in a later minor version of the database, you will not be prompted for an upgrade by the package manager of your operating system. You would need to change the configured repository in order to install the upgrade.

    Prerequisites¶

    To install Percona software, you need to configure the required repository. To simplify this process, use the percona-release repository management tool.

    1. Install GnuPG and curl

      $ sudo apt install gnupg2 curl
      
    2. Install percona-release. If you have it installed, update percona-release to the latest version.

    Procedure¶

    Important

    Run the following commands as the root user or via sudo.

    Enable Percona repository¶

    To enable the desired repository, we recommend to use the setup subcommand of percona-release.

    $ sudo percona-release setup pdps-8.0
    

    Tip

    To enable the minor version repository, use the following command:

    $ sudo percona-release setup pdps-8.0.20
    

    Install Percona Distribution for MySQL packages¶

    1. Install Percona Server for MySQL:

      $ sudo apt install percona-server-server
      
    2. Install the components. Use the commands below to install the required components:

      Install Percona XtraBackup:

      $ sudo apt install percona-xtrabackup-80
      

      Install Percona Toolkit:

      $ sudo apt install percona-toolkit
      

      Install Orchestrator:

      $ sudo apt install percona-orchestrator percona-orchestrator-cli percona-orchestrator-client
      

      Install MySQL Shell:

      $ sudo apt install percona-mysql-shell
      

      Install ProxySQL:

      $ sudo apt install proxysql2
      

      Install MySQL Router:

      $ sudo apt install percona-mysql-router
      

    Platform specific notes

    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
    

    Run the following commands as the root user or via sudo.

    Enable Percona repository¶

    To enable the desired repository, we recommend to use the setup subcommand of percona-release.

    $ sudo percona-release setup pdps-8.0
    

    Tip

    To enable the minor version repository, use the following command:

    $ sudo percona-release setup pdps-8.0.20
    

    Install Percona Distribution for MySQL packages¶

    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 Percona XtraBackup

      $ sudo yum install percona-xtrabackup-80
      

      Install Orchestrator

      $ sudo yum install percona-orchestrator percona-orchestrator-cli percona-orchestrator-client
      

      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
      

    Important

    Run the following commands as the root user or via sudo.

    Enable Percona repository¶

    To enable the desired repository, we recommend to use the setup subcommand of percona-release.

    $ sudo percona-release setup pdps-8.0
    

    Tip

    To enable the minor version repository, use the following command:

    $ sudo percona-release setup pdpxc-8.0.20
    

    Install Percona Distribution for MySQL packages¶

    1. Install Percona XtraDB Cluster:

      $ sudo apt install percona-xtradb-cluster
      
    2. Install HAProxy:

      $ sudo apt install percona-haproxy
      
    3. Install the components. Use the commands below to install the required components:

      Install Percona XtraBackup:

      $ sudo apt install percona-xtrabackup-80
      

      Install Percona Toolkit:

      $ sudo apt install percona-toolkit
      

    Important

    Run the following commands as the root user or via sudo.

    Enable Percona repository¶

    To enable the desired repository, we recommend to use the setup subcommand of percona-release.

    $ sudo percona-release setup pdps-8.0
    

    Tip

    To enable the minor version repository, use the following command:

    $ sudo percona-release setup pdpxc-8.0.20
    

    Install Percona Distribution for MySQL packages¶

    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
      

    Run 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
    

    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 consulting services , contact Percona Sales.


    Last update: 2023-03-20
    Percona LLC and/or its affiliates, © 2023
    Made with Material for MkDocs

    Cookie consent

    We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.