Use an APT repo to install Percona XtraBackup

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.

To check what data each DEB package contains, see What’s in the packages.

Important

To prevent intermittent backup failures, update the curl utility in Debian 10.

Install Percona XtraBackup through percona-release

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

1. Download a DEB package for percona-release the repository packages from Percona web:

   $ wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb
   

2. Install the downloaded package with dpkg. To do that, run the following commands as root or with sudo: dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb

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

3. Enable the repository: percona-release enable-only tools release

   If Percona XtraBackup is intended to be used in combination with the upstream MySQL Server, you only need to enable the tools repository: percona-release enable-only tools.

4. Remember to update the local cache: apt update

5. After that you can install the percona-xtrabackup-80 package:

   $ sudo apt install percona-xtrabackup-80
   

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

   Install the lz4 packageInstall the zstd package

   $ sudo apt install lz4
   

   $ sudo apt install zstd
   

Note

For AppArmor profile information, see Working with AppArmor.

Apt-pin the packages

In some cases you might need to “pin” the selected packages to avoid the upgrades from the distribution repositories. Make a new file /etc/apt/preferences.d/00percona.pref and add the following lines in it:

Package: *
Pin: release o=Percona Development Team
Pin-Priority: 1001

For more information about the pinning, check the official debian wiki.

See also

To install Percona XtraBackup using downloaded deb packages, see Install with package manager.

To uninstall Percona XtraBackup, see Uninstall Percona XtraBackup

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-01-25