Installing Percona XtraBackup on Debian and Ubuntu¶

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

Supported Releases:

Debian:

7.0 (wheezy)

8.0 (jessie)

9.0 (stretch)

Ubuntu:

14.04LTS (trusty)

16.04LTS (xenial)

17.04 (zesty)

17.10 (artful)

Supported Platforms:

x86
x86_64 (also known as amd64)

What’s in each DEB package?¶

The percona-xtrabackup package contains the latest Percona XtraBackup GA binaries and associated files.

The percona-xtrabackup-dbg package contains the debug symbols for binaries in percona-xtrabackup.

The percona-xtrabackup-test package contains the test suite for Percona XtraBackup.

The percona-xtrabackup-2x package contains the older version of the Percona XtraBackup.

Installing Percona XtraBackup from Percona `apt` repository¶

Fetch the repository packages from Percona web:

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

Install the downloaded package with dpkg. To do that, run the following commands as root or with sudo:
```
$ sudo dpkg -i percona-release_0.1-4.$(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.
Remember to update the local cache:
```
$ sudo apt-get update
```

After that you can install the package:

$ sudo apt-get install percona-xtrabackup

Percona `apt` Testing repository¶

Percona offers pre-release builds from the testing repository. To enable it add the just add the testing word at the end of the Percona repository definition in your repository file (default /etc/apt/sources.list.d/percona-release.list). It should looks like this (in this example VERSION is the name of your distribution):

deb http://repo.percona.com/apt VERSION main testing
deb-src http://repo.percona.com/apt VERSION main testing

For example, if you are running Debian 8 (jessie) and want to install the latest testing builds, the definitions should look like this:

deb http://repo.percona.com/apt jessie main testing
deb-src http://repo.percona.com/apt jessie main testing

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 it:

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 will download Percona XtraBackup 2.3.5 release package for Debian 8.0:

$ wget https://www.percona.com/downloads/XtraBackup/Percona-XtraBackup-2.3.5/\
binary/debian/jessie/x86_64/percona-xtrabackup_2.3.5-1.jessie_amd64.deb

Now you can install Percona XtraBackup by running:

$ sudo dpkg -i percona-xtrabackup_2.3.5-1.jessie_amd64.deb

Note

When installing packages manually like this, you’ll need to make sure to resolve all the dependencies and install missing packages yourself.

Uninstalling Percona XtraBackup¶

To uninstall Percona XtraBackup you’ll need to remove all the installed packages.

Remove the packages

$ sudo apt-get remove percona-xtrabackup

Download PDF Manual