Skip to content

Commit

Permalink
Merge pull request #271 from percona/patrickbirch-patch-1
Browse files Browse the repository at this point in the history
Update server-backup-version-comparison.md
  • Loading branch information
patrickbirch authored Apr 23, 2024
2 parents 1a22a5a + d03dceb commit 8fff690
Showing 1 changed file with 12 additions and 7 deletions.
19 changes: 12 additions & 7 deletions docs/server-backup-version-comparison.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,29 +14,34 @@ XtraBackup version that is equal to or above your source server version.
With the release of Percona XtraBackup 8.0.34-29, Percona XtraBackup allows backups on version 8.0.35 and higher.

Percona XtraBackup 8.0.21 adds the `--no-server-version-check` option.

## Version check

Before the backup starts, XtraBackup compares the source system version to
the Percona XtraBackup version. If the source system version is greater than the XtraBackup version, XtraBackup stops the backup and returns an
error message. This comparison prevents a failed or corrupted
backup due to source system changes.

The parameter checks for the following scenarios:

* The source system and the PXB version are the same; the backup proceeds
* The source system and the Percona XtraBackup version are the same; the backup proceeds

* The source system is less than the Percona XtraBackup version, the backup proceeds

* The source system is greater than the Percona XtraBackup version, and the parameter is not overridden; the backup is stopped and returns an error message

* The source system is less than the PXB version, the backup proceeds
* The source system is greater than the Percona XtraBackup version, and the parameter is overridden; the backup proceeds

* The source system is greater than the PXB version, and the parameter is not overridden; the backup is stopped and returns an error message

* The source system is greater than the PXB version, and the parameter is overridden; the backup proceeds
### Override check

Explicitly adding the `--no-server-version-check` parameter, like the
example overrides the parameter, and the backup proceeds.
Explicitly adding the `--no-server-version-check` option overrides the parameter, and the backup proceeds.

```{.bash data-prompt="$"}
$ xtrabackup --backup --no-server-version-check --target-dir=$mysql/backup1
```

When you override the parameter, the following events can happen:
Using this option may cause the following events:

* Backup fails

Expand Down

0 comments on commit 8fff690

Please sign in to comment.