Skip to content

Commit cb1a0e8

Browse files
alina-derkach-oazaalina-derkach-oaza
committed
PXC-4672 [Doc] Release notes for - PXC 8.0.42
 new file: docs/release-notes/8.0.42-33.md modified: docs/release-notes/release-notes_index.md modified: docs/templates/pdf_cover_page.tpl modified: mkdocs-base.yml modified: variables.yml
1 parent 5f57301 commit cb1a0e8

File tree

6 files changed

+128
-6
lines changed

6 files changed

+128
-6
lines changed

‎docs/pxc-pro.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@
44

55
## Capabilities
66

7-
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:
7+
The following capabilities have been tested for {{release}} and are available in Percona XtraDB Cluster Pro:
88

99
| Name | Available since | Description |
10-
| ----------------------------------- | ------------- | -------------|
10+
| ----------------------------------- | ------------- | ---------------|
1111
| 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. |
1212
| [FIPS compliance](fips.md)| 8.0.40-31 | FIPS compliance allows commercial cloud service providers to expand their presence with US government entities. |
1313

‎docs/release-notes/8.0.42-33.md

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
# Percona XtraDB Cluster 8.0.42-33 (2025-06-16)
2+
3+
[Get started with Quickstart Guide for Percona XtraDB Cluster.](../quickstart-overview.md)
4+
5+
Percona XtraDB Cluster 8.0.42-33 includes all the features and bug fixes available in Percona Server for MySQL 8.0.42-33.
6+
7+
## Release highlights
8+
9+
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).
10+
11+
### Percona XtraDB Cluster 8.0.42-33
12+
13+
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.
14+
15+
### Percona Server for MySQL 8.0.42-33
16+
17+
* 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'`.
18+
19+
* Updates the C++ level of the KMPI library to enhance error handling capabilities.
20+
21+
* 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.
22+
23+
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).
24+
25+
This release adds the following changes to the list of [MyRocks variables](https://docs.percona.com/percona-server/8.0/variables.html).
26+
27+
**Adds new MyRocks variables**
28+
29+
* [`--rocksdb_bulk_load_compression_parallel_threads`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_bulk_load_compression_parallel_threads)
30+
* [`--rocksdb_bulk_load_enable_unique_key_check`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_bulk_load_enable_unique_key_check)
31+
* [`--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)
32+
* [`--rocksdb_enable_udt_in_mem`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_enable_udt_in_mem)
33+
* [`--rocksdb_invalid_create_option_action`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_invalid_create_option_action)
34+
* [`--rocksdb_io_error_action`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_io_error_action)
35+
* [`--rocksdb_table_stats_skip_system_cf`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_table_stats_skip_system_cf)
36+
* [`--rocksdb_use_io_uring`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_use_io_uring)
37+
* [`--rocksdb_enable_instant_ddl`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_enable_instant_ddl)
38+
* [`--rocksdb_enable_instant_ddl_for_append_column`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_enable_instant_ddl_for_append_column)
39+
* [`--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)
40+
* [`--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)
41+
* [`--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)
42+
* [`--rocksdb-bulk-load-compression-parallel-threads`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_bulk_load_compression_parallel_threads)
43+
* [`--rocksdb-bulk-load-enable-unique-key-check`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_bulk_load_enable_unique_key_check)
44+
* [`--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)
45+
46+
**Changes default values of MyRocks variables**
47+
48+
* [`--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`.
49+
50+
* [`--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`.
51+
52+
* [`--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`.
53+
54+
**Deprecates MyRocks variable**
55+
56+
* [`--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.
57+
58+
**Removes MyRocks variables**
59+
60+
* [`--rocksdb-access-hint-on-compaction-start`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_access_hint_on_compaction_start)
61+
* [`--rocksdb_large_prefix`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_large_prefix)
62+
* [`--rocksdb_strict_collation_check`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_strict_collation_check)
63+
* [`--rocksdb_strict_collation_exceptions`](https://docs.percona.com/percona-server/8.0/variables.html#rocksdb_strict_collation_exceptions)
64+
65+
### MySQL 8.0.42
66+
67+
Improvements and bug fixes provided by Oracle for MySQL 8.0.42 and included in Percona Server for MySQL are the following:
68+
69+
* Fixed an issue where `CHECK TABLE` sometimes incorrectly reported that spatial indexes were corrupted. (Bug #37286473)
70+
71+
* Fixed an issue in InnoDB redo log recovery to improve data safety after a crash. (Bug #37061960)
72+
73+
* Fixed an issue where reading `index_id` values could lead to incorrect behavior with indexes. (Bug #36993445, Bug #37709706)
74+
75+
* Fixed a bug related to the `lower_case_table_names` setting that caused inconsistent behavior with table names on different systems. (Bug #32288105)
76+
77+
* Fixed a bug where `mysqldump` did not properly escape certain special characters in its output. (Bug #37540722, Bug #37709163)
78+
79+
* The `fprintf_string()` function in `mysqldump` did not use the correct quote character for escaping strings. (Bug #37607195)
80+
81+
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).
82+
83+
## Improvements
84+
85+
[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.
86+
87+
## Bug fixes
88+
89+
* [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.
90+
91+
* [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.
92+
93+
* [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.
94+
95+
* [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.
96+
97+
* [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.
98+
99+
* [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).
100+
101+
* [PXC-4657](https://perconadev.atlassian.net/browse/PXC-4657): There was Metadata Lock (MDL) BF-BF conflict between two applier threads.
102+
103+
* [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.
104+
105+
* [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.
106+
107+
* [PXC-4688](https://perconadev.atlassian.net/browse/PXC-4688): A regression in asynchronous replication caused the replica thread to stall when processing empty transactions.
108+
109+
## Additional resources
110+
111+
Download product binaries, packages, and tarballs at [Percona Product Downloads](https://www.percona.com/downloads)
112+
113+
[Install Percona XtraDB Cluster](../install-index.md)
114+
115+
The [Percona XtraDB Cluster GitHub repository](https://github.com/percona/percona-xtradb-cluster)
116+
117+
[Contribute to the documentation](https://github.com/percona/pxc-docs/blob/8.0/contributing.md)
118+
119+
For [training](https://www.percona.com/training), contact [Percona Training - Start learning now](https://learn.percona.com/contact-me).

‎docs/release-notes/release-notes_index.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Percona XtraDB Cluster 8.0 release notes index
22

3+
* [Percona XtraDB Cluster 8.0.42-33 (2025-06-16)](8.0.42-33.md)
4+
35
* [Percona XtraDB Cluster 8.0.41-32 (2025-03-13)](8.0.41-32.md)
46

57
* [Percona XtraDB Cluster 8.0.40-31 (2025-01-23)](8.0.40-31.md)

‎docs/templates/pdf_cover_page.tpl

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,5 +7,5 @@
77
{% if config.site_description %}
88
<h1>{{ config.site_description }}</h1>
99
{% endif %}
10-
<h2>8.0 (March 13, 2025)</h2>
10+
<h2>8.0.42-33 (June 16, 2025)</h2>
1111
<!--<h3>Percona Technical Documentation Team</h3>-->

‎mkdocs-base.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -168,6 +168,7 @@ nav:
168168
- get-help.md
169169
- Release notes:
170170
- Release notes index: release-notes/release-notes_index.md
171+
- release-notes/8.0.42-33.md
171172
- release-notes/8.0.41-32.md
172173
- release-notes/8.0.40-31.md
173174
- release-notes/8.0.39-30.md

‎variables.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# variables for HTML output
22

3-
release: '8.0.41-32'
3+
release: '8.0.42-33'
44
version: '8.0'
5-
release_date: '2025-03-'
6-
title_date: '2025-03-'
5+
release_date: '2025-06-16'
6+
title_date: '2025-06-16'

0 commit comments

Comments
 (0)