[MDEV-25686] mariabackup documentation : need more compatibility information Created: 2021-05-16  Updated: 2023-12-15

Status: Open
Project: MariaDB Server
Component/s: Documentation, mariabackup
Fix Version/s: None

Type: Task Priority: Minor
Reporter: Simon Lipp Assignee: Joe Cotellese
Resolution: Unresolved Votes: 0
Labels: None

Issue Links:
PartOf

 Description   

mariabackup documentation states :

A MariaDB Server version can often be backed up with most other Mariabackup releases in the same release series. For example, MariaDB 10.2.21 and MariaDB 10.2.22 are both in the MariaDB 10.2 release series, so MariaDB Server from MariaDB 10.2.21 could be backed up by Mariabackup from MariaDB 10.2.22, or vice versa.

However, occasionally, a MariaDB Server or Mariabackup release will include bug fixes that will break compatibility with previous releases. For example, the fix for MDEV-13564 changed the InnoDB redo log format in MariaDB 10.2.19 which broke compatibility with previous releases. To be safest, a MariaDB Server release should generally be backed up with the Mariabackup release that has the same version number.

That’s a good start, but does not answer all questions a user can ask about compatibility issues/non-issues when using mariabackup, and I can’t find any other place where this is discussed.

IMO, the documentation should answer those questions :

  • If I create a backup (mariabackup --backup) with mariabackup 10.x.y, what versions of mariabackup are capable of restoring it (mariabackup --prepare) ? Any more recent mariabackup version will do ? Or does the serie ( x ) has to match ? Does the minor version ( y ) has to match ?
  • I create a full backup with mariabackup 10.x.y. What are the constraints on the version of mariabackup if I want to create an incremental backup from it ? Any more recent version will do ? Or does the serie has to match ? Or does the minor version has to match ?
  • I have a full backup made on 10.x.y, and an incremental backup made on 10.a.b based on it. Do I have to perform any special step to restore the incremental part, such as running mariadb 10.a.b first on the full backup to upgrade the data ?


 Comments   
Comment by Stephan Vos [ 2021-06-29 ]

I agree. This is very important information when upgrading between major releases and minor releases that could break the ability to restore backups made with older versions.

Comment by Stephan Vos [ 2021-10-25 ]

Has there been any progress on documenting the requested?
We upgraded from 10.4.13 to 10.5.6 and I have no idea if my previous backups are compatible with 10.5.6 in case we need to be able to recover from a backup made with 10.4.14.

Generated at Thu Feb 08 09:39:34 UTC 2024 using Jira 8.20.16#820016-sha1:9d11dbea5f4be3d4cc21f03a88dd11d8c8687422.