Skip to content

PXC-4677 [Doc] Release notes for - PXC 8.4.5-5 #236

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: 8.4
Choose a base branch
from
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
116 changes: 116 additions & 0 deletions docs/release-notes/8.4.4-5.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
# Percona XtraDB Cluster 8.4.5-5 (2025-06-)

Percona XtraDB Cluster (PXC) supports critical business applications in both cloud and on-premises environments, including public, private, and hybrid setups. Our free, open source, enterprise-grade solution includes the high availability and security features your business requires to meet your customer expectations and business goals.

## Release highlights

Percona XtraDB Cluster 8.4.5-5 is based on Percona Server for MySQL and includes all improvements and bug fixes available in the [Percona Server for MySQL 8.4.5-5 (2025-05-29) release notes](https://docs.percona.com/percona-server/8.4/release-notes/8.4.5-5.html).

### Percona XtraDB Cluster 8.4.5-5

Improves State Snapshot Transfer (SST) failure diagnostics. `garbd` now uses distinct exit codes to differentiate between donor exit, SST script failure, and garbd-initiated termination, making SST issues easier to identify and debug.

### Percona Server for MySQL 8.4.5-5

* Updates the C++ level of the KMPI library to enhance error handling capabilities.

* Improves optimizer behavior by restoring correct handling of const tables in `test_quick_select()`. A MySQL Upstream refactor (commit [9a13c1c](https://github.com/percona/percona-server/commit/9a13c1c6971f4bd56d143179ecfb34cca8ecc018)) removed the `QEP_TAB` dependency, causing `get_quick_record_count()` to no longer pass const table information. This could lead to suboptimal range scan boundaries. The applied patch resolves the issue by explicitly passing `const_tables` to `test_quick_select()`, ensuring consistent behavior with the pre-refactor logic.

The latest MyRocks storage engine incorporates code based on RocksDB version 9.3.1. Percona has applied minor modifications to the original RocksDB codebase. Check the list of modifications at [https://github.com/percona/rocksdb/](https://github.com/percona/rocksdb/commit/2864cd95ca72bc4a2e93fe461dbd980f8e2357be).

This release adds the following changes to the list of [MyRocks variables](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html).

**Adds new MyRocks variables**

* [`--rocksdb_bulk_load_compression_parallel_threads`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_bulk_load_compression_parallel_threads)
* [`--rocksdb_bulk_load_enable_unique_key_check`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_bulk_load_enable_unique_key_check)
* [`--rocksdb_debug_skip_bloom_filter_check_on_iterator_bounds`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_debug_skip_bloom_filter_check_on_iterator_bounds)
* [`--rocksdb_enable_udt_in_mem`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_enable_udt_in_mem)
* [`--rocksdb_invalid_create_option_action`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_invalid_create_option_action)
* [`--rocksdb_io_error_action`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_io_error_action)
* [`--rocksdb_table_stats_skip_system_cf`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_table_stats_skip_system_cf)
* [`--rocksdb_use_io_uring`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_use_io_uring)
* [`--rocksdb_enable_instant_ddl`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_enable_instant_ddl)
* [`--rocksdb_enable_instant_ddl_for_append_column`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_enable_instant_ddl_for_append_column)
* [`--rocksdb_enable_instant_ddl_for_column_default_changes`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_enable_instant_ddl_for_column_default_changes)
* [`--rocksdb_enable_instant_ddl_for_drop_index_changes`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_enable_instant_ddl_for_drop_index_changes)
* [`--rocksdb_enable_instant_ddl_for_table_comment_changes`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_enable_instant_ddl_for_table_comment_changes)
* [`--rocksdb-bulk-load-compression-parallel-threads`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_bulk_load_compression_parallel_threads)
* [`--rocksdb-bulk-load-enable-unique-key-check`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_bulk_load_enable_unique_key_check)
* [`--rocksdb-debug-skip-bloom-filter-check-on-iterator-bounds`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_debug_skip_bloom_filter_check_on_iterator_bounds)

**Changes default values of MyRocks variables**

* [`--rocksdb_disable_instant_ddl`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_disable_instant_ddl) - the default value is changed from `ON` to `OFF`.

* [`--rocksdb_file_checksums`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_file_checksums) - the data type is changed from `Boolean` to `ENUM`. Also, the default value is changed from `OFF` to `CHECKSUMS_OFF`.

* [`--rocksdb_compaction_readahead_size`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_compaction_readahead_size) - the default value is changed from `0` (zero) to `2097152`.

**Deprecates MyRocks variable**

* [`--rocksdb_disable_instant_ddl`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_disable_instant_ddl) - this variable is being deprecated and is expected to be removed in a future release.

**Removes MyRocks variables**

* [`--rocksdb-access-hint-on-compaction-start`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_access_hint_on_compaction_start)
* [`--rocksdb_large_prefix`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_large_prefix)
* [`--rocksdb_strict_collation_check`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_strict_collation_check)
* [`--rocksdb_strict_collation_exceptions`](https://docs.percona.com/percona-server/8.4/myrocks-server-variables.html#rocksdb_strict_collation_exceptions)

### MySQL 8.4.5

Improvements and bug fixes introduced by Oracle for MySQL 8.4.5 and included in Percona Server for MySQL are the following:

* Fixed an issue where `CHECK TABLE` sometimes incorrectly reported that spatial indexes were corrupted. (Bug #37286473)

* Fixed an issue in InnoDB redo log recovery to improve data safety after a crash. (Bug #37061960)

* Fixed an issue where reading `index_id` values could lead to incorrect behavior with indexes. (Bug #36993445, Bug #37709706)

* Fixed a bug related to the `lower_case_table_names` setting that caused inconsistent behavior with table names on different systems. (Bug #32288105)

* Fixed a bug where `mysqldump` did not properly escape certain special characters in its output. (Bug #37540722, Bug #37709163)

* The `fprintf_string()` function in `mysqldump` did not use the correct quote character for escaping strings. (Bug #37607195)

Find the complete list of bug fixes and changes in the [MySQL 8.4.5 release notes](https://dev.mysql.com/doc/relnotes/mysql/8.4/en/news-8-4-5.html).

## Improvements

[PXC-4645](https://perconadev.atlassian.net/browse/PXC-4645): Improves State Snapshot Transfer (SST) failure diagnostics. `garbd` now uses distinct exit codes to differentiate between donor exit, SST script failure, and garbd-initiated termination, making SST issues easier to identify and debug.

## Bug fixes

* [PXC-3576](https://perconadev.atlassian.net/browse/PXC-3576): Percona XtraDB Cluster created role mappings using an upper-case database name when `lower_case_table_names=1` was set.

* [PXC-4394](https://perconadev.atlassian.net/browse/PXC-4394): Improved error reporting for scenarios where Percona Xtrabackup, used during State Snapshot Transfer (SST), failed to report its version. These failures may be caused by missing libraries or a broken installation.

* [PXC-4399](https://perconadev.atlassian.net/browse/PXC-4399): Executing `FLUSH TABLES` on a table while writes were in progress caused the cluster node to stall.

* [PXC-4512](https://perconadev.atlassian.net/browse/PXC-4512): When `RENAME TABLE` was executed on a child table concurrently with `INSERT`/`UPDATE` on a parent table, a Metadata Lock (MDL) BF-BF conflict occured on the replica, causing two cluster nodes to enter NON-PRIMARY state.

* [PXC-4629](https://perconadev.atlassian.net/browse/PXC-4629): Creating a temporary table with `CREATE TEMPORARY TABLE ... AS SELECT` put the entire session into Transaction Ordered Index (TOI ) / Next Binary Operation (NBO) lock state, preventing any queries from being killed within that session.

* [PXC-4638](https://perconadev.atlassian.net/browse/PXC-4638): After performing State Snapshot Transfer (SST), the `binlog.index` file contents became inconsistent, causing the `binlog_utils_udf` plugin to fail when accessing the binlog file. Was fixed within [PS-9777](https://perconadev.atlassian.net/browse/PS-9777).

* [PXC-4652](https://perconadev.atlassian.net/browse/PXC-4652): Fixed a segmentation fault (SIGSEGV) on nodes with `wsrep_applier_threads > 1` under high write activity.

* [PXC-4657](https://perconadev.atlassian.net/browse/PXC-4657): There was Metadata Lock (MDL) BF-BF conflict between two applier threads.

* [PXC-4684](https://perconadev.atlassian.net/browse/PXC-4684): An `UPDATE` query that referenced two tables but only modified one could cause an Metadata Lock (MDL) BF-BF conflict on other cluster nodes.

* [PXC-4664](https://perconadev.atlassian.net/browse/PXC-4664): Executing transactions with the same Global Transaction Identifier (GTID) on different nodes caused a node to exit.

* [PXC-4688](https://perconadev.atlassian.net/browse/PXC-4688): A regression in asynchronous replication caused the replica thread to stall when processing empty transactions.

## Useful links

* The [Percona XtraDB Cluster installation instructions](https://www.percona.com/doc/percona-xtradb-cluster/8.4/install/index.html)

* The [Percona XtraDB Cluster downloads](https://www.percona.com/downloads/Percona-XtraDB-Cluster-LATEST/#)

* The [Percona XtraDB Cluster GitHub location](https://github.com/percona/percona-xtradb-cluster)

* To contribute to the documentation, review the [Documentation Contribution Guide](https://github.com/percona/pxc-docs/blob/8.0/contributing.md)

2 changes: 2 additions & 0 deletions docs/release-notes/release-notes_index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Percona XtraDB Cluster {{vers}} release notes index

* [Percona XtraDB Cluster 8.4.5-5 (2025-06-)](8.4.5-5.md)

* [Percona XtraDB Cluster 8.4.4-4 (2025-04-16)](8.4.4-4.md)

* [Percona XtraDB Cluster 8.4.3-3 (2025-01-21)](8.4.3-3.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.4-4 (April 16, 2025)</h2>
<h2>8.4.5-5 (June , 2025)</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_index.md
- release-notes/8.4.5-5.md
- release-notes/8.4.4-4.md
- release-notes/8.4.3-3.md
- release-notes/8.4.2-2.md
Expand Down
6 changes: 3 additions & 3 deletions variables.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# variables for HTML output

release: '8.4.4-4'
release: '8.4.5-5'
version: '8.4'
vers: '8.4' # we are going to use it instead of version
pkg: 'pxc-84-lts'
release_date: '2025-04-16'
title_date: '2025-04-16'
release_date: '2025-06-'
title_date: '2025-06-'