Installing Percona XtraBackup on Debian and Ubuntu

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 Software and Platform Lifecycle.

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 via percona-release

Percona XtraBackup, like many other Percona products, is installed via 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 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 percona-xtrabackup-80 package:

    $ sudo apt-get install percona-xtrabackup-80
    
  6. In order to make compressed backups, install the qpress package:

    $ sudo apt-get 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 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
    

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 professional services, contact Percona Sales.