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 8.0 (jessie)
  • Debian 9.0 (stretch)
  • Ubuntu 16.04 (xenial)
  • Ubuntu 18.04 LTS (bionic)

Supported architectures:

  • x86_64 (also known as amd64)

What’s in each DEB package?

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

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

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

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

Installing Percona XtraBackup from Percona apt repository

  1. Fetch 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 intented 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-get update

  5. After that you can install the package:

    $ apt-get install percona-xtrabackup-80
    

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. The following example will download Percona XtraBackup 8.0.4-1 release package for Debian 8.0:

$ wget https://www.percona.com/downloads/XtraBackup/Percona-XtraBackup-8.0.4/binary/debian/stretch/x86_64/percona-xtrabackup-80_8.0.4-1.stretch_amd64.deb

Now you can install Percona XtraBackup by running:

$ sudo dpkg -i percona-xtrabackup-80_0.4-1.stretch_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.

  1. Remove the packages

    $ sudo apt-get remove percona-xtrabackup-80