Limitations
To backup multiple MySQL instances with the
binary
method and the xtrabackup tool, you must define multiple FileSet and multiple Job resources.The xtrabackup tool doesn’t know how to read
.my.cnf
file to get user and password information. Thus you must specify the password in the plugin command line or to use theextra_file
option in addition to themycnf_dir
parameter.The Percona
prepare
option may only be used with Full backups. If you attempt to use theprepare
option with an Incremental or Differental Percona backup, the backup will continue without theprepare
option.The Percona
prepare
option is incompatible with Bacula Encryption, Compression, and ACL options. If you use any of those options with theprepare
option, the resulting backup will probably be unrestorable.The Percona
prepare
option only works with backups of a single MySQL instance. There may be multiple databases within that instance that are backed up.With Percona
prepare=fd
the sized of the all-databases.xbstream as shown in the Bacula Catalog will alwas be reported as -1. This is because the stream is created on the fly with no intermediary file.Most of the MD5 signatures for a Percona
prepare
will not be valid either because the file never existed on disk, or because the file was modified without recomputing the requested checksum.In the current Percona
prepare=sd
implementation the Storage daemon’sWorking Directory
is used for placement of the temporary files. Consequently, it should be on a very fast device (RAID or SSD) and must be sufficiently large to handle the maximum database size for as many clients that can run simultaneously.The backup of the Percona
prepare=fd
may include a few left over files of the Prepare process that are not really needed for a proper backup.The Percona tools are tailor made for each operating system and for each version of MySQL. Therefore you must be very careful about upgrading either MySQL and/or the Percona tools. Please test carefully before trying to put them into production. Apparently with Ubuntu 16.04 the Percona tools that are part of their distribution were not upgraded when they added a newer version of MySQL. Consequently just doing an upgrade of that system can lead to Backup failures. In general, the Percona site has the most current versions you need for each MySQL version and also has a matrix of which versions work together.
The testing of the Percona
prepare
features was done withmysql Ver 14.14 Distrib 5.7.22
andPercona version 2.4.11
.As noted above doing a restore of a MySQL database on a system that uses AppArmor (Debian based, e.g. Debian, Ubuntu, …) can run into AppArmor permissions problems. Thus we strongly recommend that you try doing a Full restore of your MySQL installation in a test environment prior to putting it into production.
If you have MySQL binary mode backups and you plan to upgrade your MySQL server operating system, please confirm that Percona xtrabackup tools are available for the platform you plan to upgrade the system. MySQL binary mode backups use the Percona xtrabackup tools and they must be available for the new operating system version/platform of your MySQL server.
The
restart
command has limitations with plugins, as it initiates the Job from scratch rather than continuing it. Bacula determines whether a Job is restarted or continued, but using therestart
command will result in a new Job.
Go back to the main MySQL Plugin page.
Go back to the Dedicated Backup Solutions page.