diff --git a/docs/pxc-pro.md b/docs/pxc-pro.md index 88e0a37a..d75c0935 100644 --- a/docs/pxc-pro.md +++ b/docs/pxc-pro.md @@ -4,10 +4,10 @@ ## Capabilities -The following capabilities were introduced in the listed version of Percona XtraDB Cluster Pro and have been tested with the latest release to ensure reliability and performance: +The following capabilities have been tested for {{release}} and are available in Percona XtraDB Cluster Pro: | Name | Available since | Description | -| ----------------------------------- | ------------- | -------------| +| ----------------------------------- | ------------- | ---------------| | Available on [Amazon Linux 2023](install-pro.md) | 8.0.41-32 | Amazon Linux 2023 is a purpose-built Linux distribution optimized for AWS. It’s designed for performance, security, and seamless integration with the broader AWS ecosystem. We support both AMD64 and ARM64 versions of Amazon Linux 2023. | | [FIPS compliance](fips.md)| 8.0.40-31 | FIPS compliance allows commercial cloud service providers to expand their presence with US government entities. | diff --git a/docs/release-notes/8.0.42-33.md b/docs/release-notes/8.0.42-33.md new file mode 100644 index 00000000..5f4e4af7 --- /dev/null +++ b/docs/release-notes/8.0.42-33.md @@ -0,0 +1,119 @@ +# Percona XtraDB Cluster 8.0.42-33 (2025-06-16) + +[Get started with Quickstart Guide for Percona XtraDB Cluster.](../quickstart-overview.md) + +Percona XtraDB Cluster 8.0.42-33 includes all the features and bug fixes available in Percona Server for MySQL 8.0.42-33. + +## Release highlights + +Percona XtraDB Cluster is based on Percona Server for MySQL. Find a complete list of improvements and bug fixes in the [Percona Server for MySQL 8.0.42-33 (2025-05-19) release notes](https://docs.percona.com/percona-server/8.0/release-notes/8.0.42-33.html). + +### Percona XtraDB Cluster 8.0.42-33 + +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.0.42-33 + +* Improves the `audit_log_filter_set_user()` UDF to accept account names with wildcard characters (`'%'` and `'_'`) in the host part. For example, you can use `‘usr1@%'`, `‘usr2%192.168.0.%’`, or `'usr3@%.mycorp.com'`. + +* 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.0/variables.html). + +**Adds new MyRocks variables** + +* [`--rocksdb_bulk_load_compression_parallel_threads`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_bulk_load_compression_parallel_threads) +* [`--rocksdb_bulk_load_enable_unique_key_check`](https://docs.percona.com/percona-server/8.0/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.0/variables.html#rocksdb_debug_skip_bloom_filter_check_on_iterator_bounds) +* [`--rocksdb_enable_udt_in_mem`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_enable_udt_in_mem) +* [`--rocksdb_invalid_create_option_action`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_invalid_create_option_action) +* [`--rocksdb_io_error_action`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_io_error_action) +* [`--rocksdb_table_stats_skip_system_cf`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_table_stats_skip_system_cf) +* [`--rocksdb_use_io_uring`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_use_io_uring) +* [`--rocksdb_enable_instant_ddl`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_enable_instant_ddl) +* [`--rocksdb_enable_instant_ddl_for_append_column`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_enable_instant_ddl_for_append_column) +* [`--rocksdb_enable_instant_ddl_for_column_default_changes`](https://docs.percona.com/percona-server/8.0/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.0/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.0/variables.html#rocksdb_enable_instant_ddl_for_table_comment_changes) +* [`--rocksdb-bulk-load-compression-parallel-threads`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_bulk_load_compression_parallel_threads) +* [`--rocksdb-bulk-load-enable-unique-key-check`](https://docs.percona.com/percona-server/8.0/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.0/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.0/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.0/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.0/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.0/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.0/variables.html#rocksdb_access_hint_on_compaction_start) +* [`--rocksdb_large_prefix`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_large_prefix) +* [`--rocksdb_strict_collation_check`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_strict_collation_check) +* [`--rocksdb_strict_collation_exceptions`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_strict_collation_exceptions) + +### MySQL 8.0.42 + +Improvements and bug fixes provided by Oracle for MySQL 8.0.42 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.0.42 Release Notes](https://dev.mysql.com/doc/relnotes/mysql/8.0/en/news-8-0-42.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-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. + +## Additional resources + +Download product binaries, packages, and tarballs at [Percona Product Downloads](https://www.percona.com/downloads) + +[Install Percona XtraDB Cluster](../install-index.md) + +The [Percona XtraDB Cluster GitHub repository](https://github.com/percona/percona-xtradb-cluster) + +[Contribute to the documentation](https://github.com/percona/pxc-docs/blob/8.0/contributing.md) + +For [training](https://www.percona.com/training), contact [Percona Training - Start learning now](https://learn.percona.com/contact-me). diff --git a/docs/release-notes/release-notes_index.md b/docs/release-notes/release-notes_index.md index da3f572b..eea1fc9b 100644 --- a/docs/release-notes/release-notes_index.md +++ b/docs/release-notes/release-notes_index.md @@ -1,5 +1,7 @@ # Percona XtraDB Cluster 8.0 release notes index +* [Percona XtraDB Cluster 8.0.42-33 (2025-06-16)](8.0.42-33.md) + * [Percona XtraDB Cluster 8.0.41-32 (2025-03-13)](8.0.41-32.md) * [Percona XtraDB Cluster 8.0.40-31 (2025-01-23)](8.0.40-31.md) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index 6b73556c..e6dc41be 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.0 (March 13, 2025)

+

8.0.42-33 (June 16, 2025)

diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 07050ee1..4eb14c0e 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -168,6 +168,7 @@ nav: - get-help.md - Release notes: - Release notes index: release-notes/release-notes_index.md + - release-notes/8.0.42-33.md - release-notes/8.0.41-32.md - release-notes/8.0.40-31.md - release-notes/8.0.39-30.md diff --git a/variables.yml b/variables.yml index 99a0c1dd..7898a95a 100644 --- a/variables.yml +++ b/variables.yml @@ -1,6 +1,6 @@ # variables for HTML output -release: '8.0.41-32' +release: '8.0.42-33' version: '8.0' -release_date: '2025-03-' -title_date: '2025-03-' +release_date: '2025-06-16' +title_date: '2025-06-16'