From 68dfa85f777a74e9eee49a3ae8634d00497e02d9 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Fri, 22 May 2026 16:23:41 +0200 Subject: [PATCH] PXB-3735 [Doc] Release notes for - PXB 8.4.0-6 new file: docs/release-notes/8.4.0-6.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/8.4.0-6.md | 59 +++++++++++++++++++++++++++++ docs/release-notes/release-notes.md | 2 + docs/templates/pdf_cover_page.tpl | 2 +- mkdocs-base.yml | 1 + variables.yml | 8 ++-- 5 files changed, 67 insertions(+), 5 deletions(-) create mode 100644 docs/release-notes/8.4.0-6.md diff --git a/docs/release-notes/8.4.0-6.md b/docs/release-notes/8.4.0-6.md new file mode 100644 index 000000000..6fbe626d3 --- /dev/null +++ b/docs/release-notes/8.4.0-6.md @@ -0,0 +1,59 @@ +# Percona XtraBackup 8.4.0-6 (2026-05-) + +Get started with [Quickstart Guide for Percona XtraBackup]. + +## Release highlights + +Percona XtraBackup 8.4.0-6 release includes new features, improvements and bug fixes. + +* Percona XtraBackup introduces the [`--check-tables`](../innodb-btree-check.md) option to validate the structural integrity of InnoDB B-tree indexes during the [`--prepare`](xtrabackup-option-reference.md#prepare) phase. Validation during `--prepare` helps detect corrupted indexes before restore or production deployment. + +* Percona XtraBackup introduces [backup size reporting](../backup-size-reporting.md) for successful backups. Percona XtraBackup now records backup size in `xtrabackup_info` and reports the same information in the XtraBackup error log. Backup size reporting helps estimate storage requirements, check that backups work correctly, and plan restores for compressed and streamed backups. + +* Percona XtraBackup adds support for Azure Storage accounts with [Hierarchical Namespace (HNS)](https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-namespace) enabled in `xbcloud delete`. Percona XtraBackup now correctly removes backups from Azure Data Lake Storage Gen2 environments where deletion previously failed due to unsupported HNS behavior. + +* Percona XtraBackup improves `--copy-back` and `--move-back` handling for backups created from servers with non-default InnoDB configuration paths. Percona XtraBackup now automatically processes configuration values stored in `backup-my.cnf`, avoiding restore failures caused by custom `innodb_data_file_path` and related settings. + +* Percona XtraBackup improves sparse file handling efficiency by removing redundant `fallocate(PUNCH_HOLE)` calls from `local_write_sparse`. + +* Percona XtraBackup improves incremental backup speed for instances containing around one million tables, reducing the time required for incremental backups to complete. + +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. + +## New features + +[PXB-3328](https://perconadev.atlassian.net/browse/PXB-3328): Adds the `--check-tables` option to validate InnoDB B-tree index integrity during the `--prepare` phase. The option detects structural corruption in backup files before restore or deployment. + +[PXB-3747](https://perconadev.atlassian.net/browse/PXB-3747): Adds backup size reporting for successful backups. Percona XtraBackup now records backup size in `xtrabackup_info` and reports the same information in the XtraBackup error log. + +## Improvements + +[PXB-3643](https://perconadev.atlassian.net/browse/PXB-3643): Adds support for Azure Storage accounts with [Hierarchical Namespace (HNS)](https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-namespace) enabled in `xbcloud delete`. Percona XtraBackup now correctly removes backups from Azure Data Lake Storage Gen2 environments where deletion previously failed due to unsupported HNS behavior. + +[PXB-3458](https://perconadev.atlassian.net/browse/PXB-3458): Improves `--copy-back` and `--move-back` handling for backups created from servers with non-default InnoDB configuration paths. Percona XtraBackup now automatically processes configuration values stored in `backup-my.cnf`, avoiding restore failures caused by custom `innodb_data_file_path` and related settings. + +[PXB-3658](https://perconadev.atlassian.net/browse/PXB-3658): Improves sparse file handling efficiency by removing redundant `fallocate(PUNCH_HOLE)` calls from `local_write_sparse`. + +## Bug fixes + +[PXB-3568](https://perconadev.atlassian.net/browse/PXB-3568): Fixed an issue where `xtrabackup` terminated unexpectedly on RHEL 9 when using `--compress=lz4`. + +[PXB-3759](https://perconadev.atlassian.net/browse/PXB-3759): Fixed an issue where `xtrabackup` terminated unexpectedly when redo log encryption was enabled and `innodb_log_buffer_size` exceeded 16 MB. + +[PXB-3762](https://perconadev.atlassian.net/browse/PXB-3762): Fixed an issue where `xtrabackup --backup --transition-key` terminated unexpectedly on servers where undo tablespace encryption keys existed only in redo logs. + +[PXB-3543](https://perconadev.atlassian.net/browse/PXB-3543): Fixed an issue where incremental backups on instances containing around one million tables completed significantly slower than expected. + +## Packaging notes + +* Percona XtraBackup 8.4 adds support for Ubuntu 26.04. + +## Additional resources + +Install [Percona XtraBackup 8.4.0-6](..//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 b048d59be..de6aaceea 100644 --- a/docs/release-notes/release-notes.md +++ b/docs/release-notes/release-notes.md @@ -1,5 +1,7 @@ # Percona XtraBackup {{vers}} release notes index +* [Percona XtraBackup 8.4.0-6 (2026-05-)](8.4.0-6.md) + * [Percona XtraBackup 8.4.0-5 (2025-12-17)](8.4.0-5.md) * [Percona XtraBackup 8.4.0-4 (2025-08-21)](8.4.0-4.md) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index 03cbbea65..13f9328a3 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 %} -

8.4.0-5 (December 17, 2025)

+

8.4.0-6 (May , 2026)

\ No newline at end of file diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 22338f531..7cc05bbff 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -170,6 +170,7 @@ nav: - get-help.md - Release notes: - Release notes index: release-notes/release-notes.md + - release-notes/8.4.0-6.md - release-notes/8.4.0-5.md - release-notes/8.4.0-4.md - release-notes/8.4.0-3.md diff --git a/variables.yml b/variables.yml index 02ddf9152..557dc53b8 100644 --- a/variables.yml +++ b/variables.yml @@ -1,9 +1,9 @@ # variables for HTML output -release: '8.4.0-5' +release: '8.4.0-6' version: '8.4' vers: '8.4' # is used in links and to specify a product version pkg: 'pxb-84-lts' -release-date: '2025-12-17' -title_date: '2025-12-17' -amzn: '8.4.0-5.1.amzn2023' +release-date: '2026-05-' +title_date: '2026-05-' +amzn: '8.4.0-6.1.amzn2023'