Installing Percona XtraBackup on Debian and Ubuntu¶
The following instructions install Percona XtraBackup 2.4 using the APT package manager. The instructions to install Percona XtraBackup 8.0 using the APT package manager are available in the Percona XtraBackup 8.0 installation documentation.
Ready-to-use packages are available from the Percona XtraBackup software repositories and the Percona download page.
Specific information on the supported platforms, products, and versions is described in Percona Software and Platform Lifecycle.
What’s in each DEB package?¶
percona-xtrabackup-24 package contains the latest Percona XtraBackup
GA binaries and associated files.
percona-xtrabackup-dbg-24 package contains the debug symbols for
percona-xtrabackup-test-24 package contains the test suite for
percona-xtrabackup package contains the older version of the
Installing Percona XtraBackup via percona-release¶
Percona XtraBackup, like many other Percona products, is installed with the percona-release package configuration tool.
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
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.
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 enable only the
percona-release enable-only tools.
After that you can install the
$ sudo apt install percona-xtrabackup-24
In order to make compressed backups, install the
$ sudo apt install qpress
Apt-Pinning the packages¶
In some cases you might need to “pin” the selected packages to avoid the
upgrades from the distribution repositories. You’ll need to make a new file
/etc/apt/preferences.d/00percona.pref and add the following lines in
Package: * Pin: release o=Percona Development Team Pin-Priority: 1001
For more information about the pinning you can check the official debian wiki.
Installing Percona XtraBackup using downloaded deb packages¶
Download the packages of the desired series for your architecture from the download page. Following example downloads the Percona XtraBackup 2.4.28 release package for Debian 10.0:
$ wget https://downloads.percona.com/downloads/Percona-XtraBackup-2.4/Percona-XtraBackup-2.4.28/ \binary/debian/buster/x86_64/percona-xtrabackup-dbg-24_2.4.28-1.buster_amd64.deb
Now you can install Percona XtraBackup by running:
$ sudo dpkg -i percona-xtrabackup-24_2.4.28-1.buster_amd64.deb
Installing the packages manually like this, you must resolve all dependencies and install the missing packages yourself.
Update the Curl utility in Debian 10¶
The default curl version, 7.64.0, in Debian 10 has known issues when attempting to reuse an already closed connection. This issue directly affects
xbcloud and users may see intermittent backup failures.
Follow these steps to upgrade curl to version 7.74.0:
/etc/apt/sources.listto add the following:
deb http://ftp.de.debian.org/debian buster-backports main
sudo apt update
Install the version from
$ sudo apt install curl/buster-backports
Verify the version number:The result is similar to the following;
$ curl --version
curl 7.74.0 (x86_64-pc-linux-gnu) libcurl/7.74.0
Uninstalling Percona XtraBackup¶
To uninstall Percona XtraBackup you’ll need to remove all the installed packages.
Remove the packages
$ sudo apt remove percona-xtrabackup-24