Buy Percona ServicesBuy Now!

Compressed Backup

Percona XtraBackup has implemented support for compressed backups. It can be used to compress/decompress local or streaming backup with xbstream.

Creating Compressed Backups

In order to make a compressed backup you’ll need to use xtrabackup --compress option:

$ xtrabackup --backup --compress --target-dir=/data/compressed/

If you want to speed up the compression you can use the parallel compression, which can be enabled with xtrabackup --compress-threads option. Following example will use four threads for compression:

$ xtrabackup --backup --compress --compress-threads=4 \
--target-dir=/data/compressed/

Output should look like this

...
170223 13:00:38 [01] Compressing ./test/sbtest1.frm to /tmp/compressed/test/sbtest1.frm.qp
170223 13:00:38 [01]        ...done
170223 13:00:38 [01] Compressing ./test/sbtest2.frm to /tmp/compressed/test/sbtest2.frm.qp
170223 13:00:38 [01]        ...done
...
170223 13:00:39 [00] Compressing xtrabackup_info
170223 13:00:39 [00]        ...done
xtrabackup: Transaction log of lsn (9291934) to (9291934) was copied.
170223 13:00:39 completed OK!

Preparing the backup

Before you can prepare the backup you’ll need to uncompress all the files. Percona XtraBackup has implemented xtrabackup --decompress option that can be used to decompress the backup.

Note

Before proceeding you’ll need to make sure that qpress has been installed. It’s availabe from Percona Software repositories

$ xtrabackup --decompress --target-dir=/data/compressed/

Note

xtrabackup --parallel can be used with xtrabackup --decompress option to decompress multiple files simultaneously.

Percona XtraBackup doesn’t automatically remove the encrypted files. In order to clean up the backup directory you should use xtrabackup --remove-original option. Even if they’re not removed these files will not be copied/moved over to the datadir if xtrabackup --copy-back or xtrabackup --move-back are used.

When the files are uncompressed you can prepare the backup with the xtrabackup --prepare option:

$ xtrabackup --prepare --target-dir=/data/compressed/

You should check for a confirmation message:

InnoDB: Starting shutdown...
InnoDB: Shutdown completed; log sequence number 9293846
170223 13:39:31 completed OK!

Now the files in /data/compressed/ are ready to be used by the server.

Restoring the backup

xtrabackup has a xtrabackup --copy-back option, which performs the restoration of a backup to the server’s datadir:

$ xtrabackup --copy-back --target-dir=/data/backups/

It will copy all the data-related files back to the server’s datadir, determined by the server’s my.cnf configuration file. You should check the last line of the output for a success message:

170223 13:49:13 completed OK!

You should check the file permissions after copying the data back. You may need to adjust them with something like:

$ chown -R mysql:mysql /var/lib/mysql

Now that the datadir contains the restored data. You are ready to start the server.

This documentation is developed in Launchpad as part of the Percona XtraBackup 2.4.
If you spotted inaccuracies, errors, don't understood it or you think something is missing or should be improved, please file a bug.
Visit Percona Store


General Inquiries

For general inquiries, please send us your question and someone will contact you.