Installing Percona XtraBackup on Debian and Ubuntu

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)
  • 18.04 (bionic)

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

  1. Fetch the repository packages from Percona web:

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

  2. 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-6.$(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. Remember to update the local cache:

    $ sudo apt-get update

  4. 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.

  1. Remove the packages

    $ sudo apt-get remove percona-xtrabackup
Download PDF Manual

Table Of Contents

This Page

Percona XtraBackup Series

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.