diff --git a/docs/release-notes/8.4.4-5.md b/docs/release-notes/8.4.4-5.md new file mode 100644 index 00000000..b2213837 --- /dev/null +++ b/docs/release-notes/8.4.4-5.md @@ -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) + diff --git a/docs/release-notes/release-notes_index.md b/docs/release-notes/release-notes_index.md index 615979a3..0f86e9e4 100644 --- a/docs/release-notes/release-notes_index.md +++ b/docs/release-notes/release-notes_index.md @@ -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) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index 1bfbdd50..eb6a89d0 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.4-4 (April 16, 2025)

+

8.4.5-5 (June , 2025)

diff --git a/mkdocs-base.yml b/mkdocs-base.yml index bcdf1877..79d85e11 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_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 diff --git a/variables.yml b/variables.yml index a60889b8..a95925a7 100644 --- a/variables.yml +++ b/variables.yml @@ -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-'