Skip to content
Percona Software for MySQL Documentation

Install with the Percona-release Tool on Debian-based Systems

Percona XtraBackup Pro includes the capabilities that are typically requested by large enterprises. Percona XtraBackup Pro contains packages created and tested by Percona. These packages are supported only for Percona Customers with a subscription.

Become a Percona Customer

Ready-to-use packages are available from the Percona XtraBackup software repositories and the download page.

Specific information on the supported platforms, products, and versions is described in Percona Release Lifecycle Overview.

Install Percona XtraBackup through percona-release

Install Percona XtraBackup, like many other Percona products, with the percona-release package configuration tool.

  1. Use the apt package manager to dowload percona-release:

    $ sudo apt update
    Expected output 
    Get:1 http://security.ubuntu.com/ubuntu jammy-security InRelease [129 kB]
Get:2 http://archive.ubuntu.com/ubuntu jammy InRelease [270 kB]
Get:3 http://archive.ubuntu.com/ubuntu jammy-updates InRelease [128 kB]
Get:4 http://security.ubuntu.com/ubuntu jammy-security/main amd64 Packages [2458 kB]
...
Building dependency tree... Done
Reading state information... Done
All packages are up to date.

  2. Install the curl download utility if it’s not installed:

    $ sudo apt install curl
    Expected output 
    Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following additional packages will be installed:
...
Updating certificates in /etc/ssl/certs...
0 added, 0 removed; done.########################################################...] 
Running hooks in /etc/ca-certificates/update.d...
done.

  3. Download the percona-release the repository package:

    $ curl -O https://repo.percona.com/apt/percona-release_latest.generic_all.deb
    Expected output 
    % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                Dload  Upload   Total   Spent    Left  Speed
100 16510  100 16510    0     0  29915      0 --:--:-- --:--:-- --:--:-- 30127

  4. Install the downloaded package and its dependencies using apt:

    sudo apt install gnupg2 lsb-release ./percona-release_latest.generic_all.deb
    Expected output 
    Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
...
For example, to enable the Percona Distribution for MySQL 8.0 repository use:

  percona-release setup pdps8.0

Note: To avoid conflicts with older product versions, the percona-release setup command may disable our original repository for some products.

For more information, please visit:
https://docs.percona.com/percona-software-repositories/percona-release.html

Processing triggers for libc-bin (2.35-0ubuntu3.8) ...

  5. Refresh the local cache to update the package information:

    $ sudo apt update
    Expected output 
    Get:1 http://security.ubuntu.com/ubuntu jammy-security InRelease [129 kB]
Get:2 http://archive.ubuntu.com/ubuntu jammy InRelease [270 kB]
Get:3 http://archive.ubuntu.com/ubuntu jammy-updates InRelease [128 kB]
Get:4 http://security.ubuntu.com/ubuntu jammy-security/main amd64 Packages [2458 kB]
...
Building dependency tree... Done
Reading state information... Done
All packages are up to date.

  6. Enable the specific percona-release product.

    $ sudo percona-release enable pxb-84-lts
    Expected output 
    * Enabling the Percona Packaging Repository repository
Hit:1 http://repo.percona.com/pmm2-client/apt jammy InRelease
Hit:2 http://archive.ubuntu.com/ubuntu jammy InRelease                     
Hit:3 http://repo.percona.com/prel/apt jammy InRelease                     
Hit:4 http://security.ubuntu.com/ubuntu jammy-security InRelease
Hit:5 http://archive.ubuntu.com/ubuntu jammy-updates InRelease
Get:6 http://repo.percona.com/pxb-84-lts/apt jammy InRelease [12.8 kB]
Hit:7 http://archive.ubuntu.com/ubuntu jammy-backports InRelease
Hit:8 http://repo.percona.com/telemetry/apt jammy InRelease
Get:9 http://repo.percona.com/pxb-84-lts/apt jammy/main Sources [855 B]
Get:10 http://repo.percona.com/pxb-84-lts/apt jammy/main amd64 Packages [3547 B]
Fetched 17.2 kB in 4s (3958 B/s)   
Reading package lists... Done

  7. Install Percona XtraBackup.

    $ sudo apt install percona-xtrabackup-84
    Expected output 
    Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following additional packages will be installed:
libaio1 libcurl4-openssl-dev libdbd-mysql-perl libdbi-perl libev4 libgdbm-compat4
libgdbm6 libmysqlclient21 libperl5.34 libpopt0 mysql-common netbase perl
perl-modules-5.34 rsync zstd
...
Setting up libdbd-mysql-perl:amd64 (4.050-5ubuntu0.22.04.1) ...##############.......] 
Setting up percona-xtrabackup-84 (8.4.0-1-1.jammy) ...#########################.....] 
Processing triggers for libc-bin (2.35-0ubuntu3.8) ...###########################...]

  8. Verify the installation.

    $ xtrabackup --version
    Expected output 
    xtrabackup version 8.4.0-1 based on MySQL server 8.4.0 Linux (x86_64) (revision id: da6e1abd)

  9. To decompress backups made using LZ4 or ZSTD compression algorithm, install the corresponding package:

    $ sudo apt install lz4

    $ sudo apt install zstd

Note

For AppArmor profile information, see Working with AppArmor.

See also

To install Percona XtraBackup using downloaded deb packages, see Install Percona XtraBackup 8.4.

To uninstall Percona XtraBackup, see Uninstall Percona XtraBackup 8.4

Get expert help

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Community Forum Get a Percona Expert

Last update: 2024-12-18