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 00000000..6fbe626d --- /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 b048d59b..de6aacee 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 03cbbea6..13f9328a 100644 --- a/docs/templates/pdf_cover_page.tpl +++ b/docs/templates/pdf_cover_page.tpl @@ -7,5 +7,5 @@ {% if config.site_description %}