Install with DEB packages¶
Version changes¶
Starting with Percona XtraBackup 8.0.35-31, the APT builds for the following platforms include ARM packages with the arm64.deb extension:
-
Debian 12
-
Debian 11
-
Ubuntu 24.04
-
Ubuntu 22.04
-
Ubuntu 20.04
This arm64.deb extension means Percona XtraBackup is now available for users on ARM-based systems.
We recommend downloading Percona XtraBackup for the same platform as your MySQL-compatible server. For instance, if your server runs on an ARM64 platform, you should download and use the Percona XtraBackup with the arm64.deb extension for that operating system.
This guide walks you through installing Percona XtraBackup 8.0 using DEB packages on Ubuntu-based systems.
-
Download the DEB package
On the Percona Software Downloads website, find the Percona XtraBackup 8.0 package for your system.
For example, for Ubuntu 20.04, this command downloads the appropriate package:
$ wget https://downloads.percona.com/downloads/Percona-XtraBackup-LATEST/Percona-XtraBackup-8.0.26-18/binary/debian/focal/x86_64/percona-xtrabackup-80_8.0.26-18-1.focal_amd64.deb -
Install the package
Use the dpkg command to install the downloaded package. You need root privileges for this:
$ sudo dpkg -i percona-xtrabackup-80_8.0.26-18-1.focal_amd64.deb
Common dependencies for Percona XtraBackup¶
| Library Name | Description |
|---|---|
| libmysqlclient | A client library for MySQL, providing essential functions for connecting to and communicating with MySQL databases. |
| libssl | A cryptographic library used for implementing SSL/TLS encryption, necessary for secure data transmission. |
| libcurl | A library that enables data transfer via various protocols such as HTTP, FTP, and others, commonly used for handling web requests. |
| libev | A high-performance event-loop library, often used in network applications for handling asynchronous events efficiently. |
| libgcrypt | A general-purpose cryptographic library that provides encryption, decryption, and cryptographic hashing algorithms. |
| zlib | A compression library used for data compression and decompression, supporting the popular DEFLATE compression algorithm. |
Identify and add missing dependencies¶
If there are missing dependencies, dpkg shows error messages. Install any missing packages with the following command:
$ sudo apt-get install -f
Retry the Percona XtraBackup installation.
Verify the installation¶
The following command returns the version information.
$ xtrabackup --version
Troubleshoot the installation¶
| Issue | Description |
|---|---|
| Permission denied | Ensure you’re using sudo or have root access for installation commands. |
| Repository issues | If packages are not found, check your yum repository configuration. |
| Incompatible OS version | Double-check your OS version matches the package requirements. |
| Conflicts with existing packages | Consider removing conflicting packages or use a separate environment. |
If you encounter persistent issues, consult the Percona XtraBackup documentation or reach out to their support forums for assistance.
Remember, when installing packages manually, you’re responsible for managing dependencies and potential conflicts. Always back up your data before making significant system changes.
Need help?¶
Dive into our active community forum, where you can connect with fellow database enthusiasts, share experiences, and learn from experts.
For those seeking in-depth guidance and tailored solutions, our team of Percona Database Experts is ready to assist you.