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