From 8a4f58fd897078feb12f0db21d0e3de34a77737d Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Fri, 30 Oct 2026 19:19:42 +0100 Subject: [PATCH 1/7] PXB-3875 [Doc] Release notes for - PXB 9.7.2-2 new file: docs/release-notes/9.7.2-2.md modified: docs/release-notes/release-notes.md modified: docs/templates/pdf_cover_page.tpl modified: mkdocs-base.yml modified: variables.yml --- docs/release-notes/9.7.2-2.md | 78 +++++++++++++++++++++++++++++ docs/release-notes/release-notes.md | 2 + docs/templates/pdf_cover_page.tpl | 2 +- mkdocs-base.yml | 1 + variables.yml | 10 ++-- 5 files changed, 87 insertions(+), 6 deletions(-) create mode 100644 docs/release-notes/9.7.2-2.md diff --git a/docs/release-notes/9.7.2-2.md b/docs/release-notes/9.7.2-2.md new file mode 100644 index 000000000..5f1302c61 --- /dev/null +++ b/docs/release-notes/9.7.2-2.md @@ -0,0 +1,78 @@ +# Percona XtraBackup 9.7.2-2 (2026-11-) + +Get started with [Quickstart Guide for Percona XtraBackup]. + +## Release Highlights + +Percona XtraBackup 9.7.2-2 supports backing up Percona Server for MySQL 9.7.x and MySQL 9.7.x. + +Use the Percona XtraBackup 8.4 series to take backups of Percona Server for MySQL 8.4.x and MySQL 8.4.x series. + +We recommend that you download the Percona XtraBackup for the same platform as the MySQL-compatible server. For example, if your server is on an ARM64 platform, you should download and use the Percona XtraBackup for ARM64 for that operating system. + +Percona XtraBackup 9.7.2-2 release includes new features, improvements, deprecations, and bug fixes. + +### Renamed options + +Percona XtraBackup 9.7.2-2 renames the following options. The new names describe the phase or the action of each option more clearly. + +| Deprecated name | New name | Used with | +| --------------- | -------- | --------- | +| `--apply-log-only` | [`--apply-redo-only`](../xtrabackup-option-reference.md#apply-redo-only) | `--prepare` | +| `--incremental-basedir` | [`--backup-incremental-base`](../xtrabackup-option-reference.md#backup-incremental-base) | `--backup` | +| `--incremental-dir` | [`--prepare-incremental-from-dir`](../xtrabackup-option-reference.md#prepare-incremental-from-dir) | `--prepare` | + +Percona XtraBackup still accepts the old names but prints a deprecation warning at startup. If you pass an old name and its new name in the same command, Percona XtraBackup reports an error and does not start. A future Long-Term Support (LTS) release will remove `--apply-log-only`. A future release will remove `--incremental-basedir` and `--incremental-dir`. Update your scripts to use the new names. + +### Deprecated options + +Percona XtraBackup 9.7.2-2 deprecates the following options. + +| Option | Use instead | +| ------ | ----------- | +| `--create-ib-logfile` | No replacement. The option has no effect. | +| [`--innodb`](../xtrabackup-option-reference.md#innodb) | No replacement. The option has no effect. | +| [`--log`](../xtrabackup-option-reference.md#log) | No replacement. The option has no effect. | +| [`--no-version-check`](../xtrabackup-option-reference.md#no-version-check) | No replacement. The option has no effect. | +| `--rebuild-threads` | No replacement. The option has no effect. | +| [`--rsync`](../xtrabackup-option-reference.md#rsync) | [`--lock-ddl=REDUCED`](../xtrabackup-option-reference.md#lock-ddl) | + +Percona XtraBackup still accepts the options but prints a deprecation warning at startup. A future release will remove the options. + +## New features + +* [PXB-2559](https://perconadev.atlassian.net/browse/PXB-2559): Adds the `--history-host`, `--history-port`, `--history-socket`, `--history-user`, `--history-password`, and `--history-ssl-*` options to [store the backup history on a different server](../store-backup-history.md#store-backup-history-on-a-different-server). Before, Percona XtraBackup always wrote the history record to the server you back up. The write failed when that server ran with `super_read_only` enabled, for example, a replica or a secondary member of a single-primary Group Replication cluster. The `--incremental-history-name` and `--incremental-history-uuid` options also read the base LSN from the history server. + +## Improvements + +* [PXB-3502](https://perconadev.atlassian.net/browse/PXB-3502): Improves parallel processing performance. With `--parallel`, Percona XtraBackup now processes files in largest-first order instead of discovery order. Large tables and partitions start processing earlier, so you spend less time waiting for large files after other parallel tasks complete. The improvement applies to `--backup`, `--prepare --prepare-incremental-from-dir`, `--copy-back`, `--move-back`, and `--decompress`. + +* [PXB-3758](https://perconadev.atlassian.net/browse/PXB-3758): Adds the [`--apply-redo-only`](../xtrabackup-option-reference.md#apply-redo-only) option as the new name for `--apply-log-only`. Both names work the same way. If you pass both options in the same command, Percona XtraBackup reports an error and does not start. For details, see [Prepare an incremental backup](../prepare-incremental-backup.md). + +* [PXB-3840](https://perconadev.atlassian.net/browse/PXB-3840): Adds phase-specific names for the incremental backup options. Use [`--backup-incremental-base`](../xtrabackup-option-reference.md#backup-incremental-base) instead of `--incremental-basedir` with `--backup`. Use [`--prepare-incremental-from-dir`](../xtrabackup-option-reference.md#prepare-incremental-from-dir) instead of `--incremental-dir` with `--prepare`. The old and new names work the same way. If you pass an old name and its new name in the same command, Percona XtraBackup reports an error and does not start. + +## Bug fixes + +* [PXB-3609](https://perconadev.atlassian.net/browse/PXB-3609): Fixed an issue where `xbcloud delete` did not remove the `.md5` checksum files for backups uploaded with `xbcloud put --md5`. + +* [PXB-3800](https://perconadev.atlassian.net/browse/PXB-3800): Fixed an issue where `xtrabackup` terminated unexpectedly with an assertion failure in `fil_tablespace_redo_extend()` when the redo log contained an `MLOG_FILE_EXTEND` record for the system tablespace. + +* [PXB-3853](https://perconadev.atlassian.net/browse/PXB-3853): Fixed an issue where incremental backups with page tracking read the unchanged pages between blocks of changed pages. On large tablespaces, the incremental backup could read nearly the whole file. Percona XtraBackup now skips the unchanged page ranges between blocks of changed pages. (Thank you to Reto Giezendanner for your contribution) + +* [PXB-3862](https://perconadev.atlassian.net/browse/PXB-3862): Fixed an issue where incremental backups with page tracking were slow when a tablespace had scattered changed pages. Percona XtraBackup read each scattered changed page on its own, and thousands of small reads take much longer than a few large reads. Percona XtraBackup now reads nearby changed pages together when reading the unchanged pages between them costs less than another read. Percona XtraBackup measures your storage at the start of the backup, so you do not need to change the configuration. The backup contents and size stay the same. Use the new [`--page-tracking-merge-gap`](../xtrabackup-option-reference.md#page-tracking-merge-gap) option to set a fixed gap, or set the option to `0` to turn off the behavior. For details, see [Read scattered changed pages](../page-tracking.md#read-scattered-changed-pages). + +* [PXB-3863](https://perconadev.atlassian.net/browse/PXB-3863): Fixed an issue where `xbcloud put`, `xbcloud get`, and `xbcloud delete` could fail on Azure Blob Storage containers with hierarchical namespace enabled when the backup name began with a slash, for example, `xbcloud put /db/hns`. Percona XtraBackup now handles leading slashes correctly. + +* [PXB-3885](https://perconadev.atlassian.net/browse/PXB-3885): Fixed an issue where `xbcloud` ran the retry waits of parallel requests one after another when the network was slow or unavailable. As a result, several failed requests took the sum of their backoff delays instead of the longest delay. The waits now run at the same time. + +* [PXB-3882](https://perconadev.atlassian.net/browse/PXB-3882): Fixed an issue where the debug build did not compile with gcc 15.2. + +## Additional resources + +Install [Percona XtraBackup 9.7.2-2](../installation.md) + +The [Percona XtraBackup GitHub repository](https://github.com/percona/percona-xtrabackup) + +Download product binaries, packages, and tarballs at [Percona Product Downloads](https://www.percona.com/downloads/) + +[Quickstart Guide for Percona XtraBackup]: ../quickstart-overview.md diff --git a/docs/release-notes/release-notes.md b/docs/release-notes/release-notes.md index b4896df63..070161627 100644 --- a/docs/release-notes/release-notes.md +++ b/docs/release-notes/release-notes.md @@ -1,3 +1,5 @@ # Percona XtraBackup {{vers}} release notes index +* [Percona XtraBackup 9.7.2-2 (2026-11-](9.7.2-2.md) + * [Percona XtraBackup 9.7.1-rc1 (2026-07-15)](9.7.1-rc1.md) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index 73bc59f19..84c7150ea 100644 --- a/docs/templates/pdf_cover_page.tpl +++ b/docs/templates/pdf_cover_page.tpl @@ -7,5 +7,5 @@ {% if config.site_description %}

{{ config.site_description }}

{% endif %} -

9.7.1-rc1 (July 15, 2026)

+

9.7.2-2 (November , 2026)

diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 3cdd3781d..0ea9d424c 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -171,6 +171,7 @@ nav: - get-help.md - Release notes: - Release notes index: release-notes/release-notes.md + - release-notes/9.7.2-2.md - release-notes/9.7.1-rc1.md - Quickstart Guide: - quickstart-overview.md diff --git a/variables.yml b/variables.yml index d29a6e12f..434521c4e 100644 --- a/variables.yml +++ b/variables.yml @@ -1,11 +1,11 @@ # variables for HTML output -release: '9.7.1-rc1' +release: '9.7.2-2' version: '9.7' vers: '9.7' # is used in links and to specify a product version pkg: 'pxb-97-lts' -deb: '9.7.1~rc1' # is used in package download links DEB -rpm: '9.7.1-1.rc' # is used in package download links RPM +deb: '9.7.2~2' # is used in package download links DEB +rpm: '9.7.2-2' # is used in package download links RPM ps: '8.4' # ps version -release-date: '2025-07-15' -title_date: '2025-07-15' +release-date: '2026-11-' +title_date: '2026-11-' From 81a3853ef8d4f83b4385636f5d0e6d626748bce1 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Tue, 3 Nov 2026 13:31:02 +0100 Subject: [PATCH 2/7] Update 9.7.2-2.md --- docs/release-notes/9.7.2-2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes/9.7.2-2.md b/docs/release-notes/9.7.2-2.md index 5f1302c61..2af93f42c 100644 --- a/docs/release-notes/9.7.2-2.md +++ b/docs/release-notes/9.7.2-2.md @@ -1,4 +1,4 @@ -# Percona XtraBackup 9.7.2-2 (2026-11-) +# Percona XtraBackup 9.7.2-2 (2026-11-04) Get started with [Quickstart Guide for Percona XtraBackup]. From d0b0f0a3df67c3aa2c47db40fbb2dc0393208635 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Tue, 3 Nov 2026 13:31:28 +0100 Subject: [PATCH 3/7] Update release-notes.md --- docs/release-notes/release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes/release-notes.md b/docs/release-notes/release-notes.md index 070161627..77e616cdd 100644 --- a/docs/release-notes/release-notes.md +++ b/docs/release-notes/release-notes.md @@ -1,5 +1,5 @@ # Percona XtraBackup {{vers}} release notes index -* [Percona XtraBackup 9.7.2-2 (2026-11-](9.7.2-2.md) +* [Percona XtraBackup 9.7.2-2 (2026-11-04](9.7.2-2.md) * [Percona XtraBackup 9.7.1-rc1 (2026-07-15)](9.7.1-rc1.md) From 24e08fa99eda9bad743ffa71a494842f570d54d2 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Tue, 3 Nov 2026 13:31:51 +0100 Subject: [PATCH 4/7] Update variables.yml --- variables.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/variables.yml b/variables.yml index 434521c4e..ccbc733ac 100644 --- a/variables.yml +++ b/variables.yml @@ -7,5 +7,5 @@ pkg: 'pxb-97-lts' deb: '9.7.2~2' # is used in package download links DEB rpm: '9.7.2-2' # is used in package download links RPM ps: '8.4' # ps version -release-date: '2026-11-' -title_date: '2026-11-' +release-date: '2026-11-04' +title_date: '2026-11-04' From c08b4014b6835c7a1227d067e78fb6c9dce56529 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Tue, 3 Nov 2026 13:32:13 +0100 Subject: [PATCH 5/7] Update pdf_cover_page.tpl --- docs/templates/pdf_cover_page.tpl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index 84c7150ea..69dac95fb 100644 --- a/docs/templates/pdf_cover_page.tpl +++ b/docs/templates/pdf_cover_page.tpl @@ -7,5 +7,5 @@ {% if config.site_description %}

{{ config.site_description }}

{% endif %} -

9.7.2-2 (November , 2026)

+

9.7.2-2 (November 04, 2026)

From b883b43f28075b817ead724f8b1044bbeab8eb67 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Tue, 3 Nov 2026 18:34:04 +0100 Subject: [PATCH 6/7] Fixes after the review --- docs/release-notes/9.7.2-2.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/release-notes/9.7.2-2.md b/docs/release-notes/9.7.2-2.md index 2af93f42c..7641532a9 100644 --- a/docs/release-notes/9.7.2-2.md +++ b/docs/release-notes/9.7.2-2.md @@ -1,4 +1,4 @@ -# Percona XtraBackup 9.7.2-2 (2026-11-04) +# Percona XtraBackup 9.7.2-2 (2026-11-) Get started with [Quickstart Guide for Percona XtraBackup]. @@ -22,7 +22,7 @@ Percona XtraBackup 9.7.2-2 renames the following options. The new names describe | `--incremental-basedir` | [`--backup-incremental-base`](../xtrabackup-option-reference.md#backup-incremental-base) | `--backup` | | `--incremental-dir` | [`--prepare-incremental-from-dir`](../xtrabackup-option-reference.md#prepare-incremental-from-dir) | `--prepare` | -Percona XtraBackup still accepts the old names but prints a deprecation warning at startup. If you pass an old name and its new name in the same command, Percona XtraBackup reports an error and does not start. A future Long-Term Support (LTS) release will remove `--apply-log-only`. A future release will remove `--incremental-basedir` and `--incremental-dir`. Update your scripts to use the new names. +Percona XtraBackup still accepts the old names but prints a deprecation warning at startup. If you pass an old name and its new name in the same command, Percona XtraBackup reports an error and does not start. A future Long-Term Support (LTS) release will remove `--apply-log-only`, `--incremental-basedir` and `--incremental-dir`. ### Deprecated options @@ -51,16 +51,16 @@ Percona XtraBackup still accepts the options but prints a deprecation warning at * [PXB-3840](https://perconadev.atlassian.net/browse/PXB-3840): Adds phase-specific names for the incremental backup options. Use [`--backup-incremental-base`](../xtrabackup-option-reference.md#backup-incremental-base) instead of `--incremental-basedir` with `--backup`. Use [`--prepare-incremental-from-dir`](../xtrabackup-option-reference.md#prepare-incremental-from-dir) instead of `--incremental-dir` with `--prepare`. The old and new names work the same way. If you pass an old name and its new name in the same command, Percona XtraBackup reports an error and does not start. +* [PXB-3853](https://perconadev.atlassian.net/browse/PXB-3853): Fixed an issue where incremental backups with page tracking read the unchanged pages between blocks of changed pages. On large tablespaces, the incremental backup could read nearly the whole file. Percona XtraBackup now skips the unchanged page ranges between blocks of changed pages. (Thank you to Reto Giezendanner for your contribution) + +* [PXB-3862](https://perconadev.atlassian.net/browse/PXB-3862): Fixed an issue where incremental backups with page tracking were slow when a tablespace had scattered changed pages. Percona XtraBackup read each scattered changed page on its own, and thousands of small reads take much longer than a few large reads. Percona XtraBackup now reads nearby changed pages together when reading the unchanged pages between them costs less than another read. Percona XtraBackup measures your storage at the start of the backup, so you do not need to change the configuration. The backup contents and size stay the same. Use the new [`--page-tracking-merge-gap`](../xtrabackup-option-reference.md#page-tracking-merge-gap) option to set a fixed gap, or set the option to `0` to turn off the behavior. For details, see [Read scattered changed pages](../page-tracking.md#read-scattered-changed-pages). + ## Bug fixes * [PXB-3609](https://perconadev.atlassian.net/browse/PXB-3609): Fixed an issue where `xbcloud delete` did not remove the `.md5` checksum files for backups uploaded with `xbcloud put --md5`. * [PXB-3800](https://perconadev.atlassian.net/browse/PXB-3800): Fixed an issue where `xtrabackup` terminated unexpectedly with an assertion failure in `fil_tablespace_redo_extend()` when the redo log contained an `MLOG_FILE_EXTEND` record for the system tablespace. -* [PXB-3853](https://perconadev.atlassian.net/browse/PXB-3853): Fixed an issue where incremental backups with page tracking read the unchanged pages between blocks of changed pages. On large tablespaces, the incremental backup could read nearly the whole file. Percona XtraBackup now skips the unchanged page ranges between blocks of changed pages. (Thank you to Reto Giezendanner for your contribution) - -* [PXB-3862](https://perconadev.atlassian.net/browse/PXB-3862): Fixed an issue where incremental backups with page tracking were slow when a tablespace had scattered changed pages. Percona XtraBackup read each scattered changed page on its own, and thousands of small reads take much longer than a few large reads. Percona XtraBackup now reads nearby changed pages together when reading the unchanged pages between them costs less than another read. Percona XtraBackup measures your storage at the start of the backup, so you do not need to change the configuration. The backup contents and size stay the same. Use the new [`--page-tracking-merge-gap`](../xtrabackup-option-reference.md#page-tracking-merge-gap) option to set a fixed gap, or set the option to `0` to turn off the behavior. For details, see [Read scattered changed pages](../page-tracking.md#read-scattered-changed-pages). - * [PXB-3863](https://perconadev.atlassian.net/browse/PXB-3863): Fixed an issue where `xbcloud put`, `xbcloud get`, and `xbcloud delete` could fail on Azure Blob Storage containers with hierarchical namespace enabled when the backup name began with a slash, for example, `xbcloud put /db/hns`. Percona XtraBackup now handles leading slashes correctly. * [PXB-3885](https://perconadev.atlassian.net/browse/PXB-3885): Fixed an issue where `xbcloud` ran the retry waits of parallel requests one after another when the network was slow or unavailable. As a result, several failed requests took the sum of their backoff delays instead of the longest delay. The waits now run at the same time. From 747f17a94ec96a785fdc7198e77666290266fae9 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Wed, 4 Nov 2026 14:45:40 +0100 Subject: [PATCH 7/7] Update 9.7.2-2.md --- docs/release-notes/9.7.2-2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes/9.7.2-2.md b/docs/release-notes/9.7.2-2.md index 7641532a9..3d103fce8 100644 --- a/docs/release-notes/9.7.2-2.md +++ b/docs/release-notes/9.7.2-2.md @@ -1,4 +1,4 @@ -# Percona XtraBackup 9.7.2-2 (2026-11-) +# Percona XtraBackup 9.7.2-2 (2026-11-04) Get started with [Quickstart Guide for Percona XtraBackup].