Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 59 additions & 0 deletions docs/release-notes/8.4.0-6.md
Original file line number Diff line number Diff line change
@@ -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
2 changes: 2 additions & 0 deletions docs/release-notes/release-notes.md
Original file line number Diff line number Diff line change
@@ -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)
Expand Down
2 changes: 1 addition & 1 deletion docs/templates/pdf_cover_page.tpl
Original file line number Diff line number Diff line change
Expand Up @@ -7,5 +7,5 @@
{% if config.site_description %}
<h1>{{ config.site_description }}</h1>
{% endif %}
<h2>8.4.0-5 (December 17, 2025)</h2>
<h2>8.4.0-6 (May , 2026)</h2>
<!--<h3>Percona Technical Documentation Team</h3>-->
1 change: 1 addition & 0 deletions mkdocs-base.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 4 additions & 4 deletions variables.yml
Original file line number Diff line number Diff line change
@@ -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'
Loading