From 0f1d5d3172be28a457206de3c23e1887e6bda049 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Thu, 25 Jun 2026 17:29:58 +0200 Subject: [PATCH 1/9] DISTMYSQL-606 [Docs] Release notes for - PS 9.7.1-1 new file: docs/release-notes-ps-9.7.1.md modified: docs/release-notes.md modified: docs/templates/pdf_cover_page.tpl modified: mkdocs-base.yml --- docs/release-notes-ps-9.7.1.md | 84 +++++++++++++++++++++++++++++++ docs/release-notes.md | 5 +- docs/templates/pdf_cover_page.tpl | 2 +- mkdocs-base.yml | 3 +- 4 files changed, 88 insertions(+), 6 deletions(-) create mode 100644 docs/release-notes-ps-9.7.1.md diff --git a/docs/release-notes-ps-9.7.1.md b/docs/release-notes-ps-9.7.1.md new file mode 100644 index 00000000..17213204 --- /dev/null +++ b/docs/release-notes-ps-9.7.1.md @@ -0,0 +1,84 @@ +# Percona Distribution for MySQL 9.7.1 using Percona Server for MySQL (2025-0-) + +Percona Distribution for MySQL is more than just a version of MySQL; it is a comprehensive solution that combines Percona Server for MySQL with additional tools to create a cohesive environment. This distribution is reliable, scalable, and secure, ensuring that all components have been tested to work seamlessly together. You can choose from two download options: one that uses Percona Server for MySQL and another that utilizes Percona XtraDB Cluster. Refer to [Install Percona Distribution for MySQL](installing.md). + +!!! note "" + + Percona Distribution for MySQL 9.7.0 using Percona Server for MySQL was not released; 9.7.1 is the next build in this series. This release includes enhancements and bug fixes from MySQL 9.7.0 and MySQL 9.7.1. + +This release is based on [Percona Server for MySQL 9.7.1-1](https://docs.percona.com/percona-server/9.7/release-notes/9.7.1-1.html) that includes all the features and bug fixes available in the [MySQL 9.7.1 Community Edition](https://dev.mysql.com/doc/relnotes/mysql/9.7/en/news-9-7-1.html) and enterprise-grade features developed by Percona. + +## Release highlights + +### Percona Server for MySQL 9.7.1-1 + +Percona Server for MySQL 9.7.1-1 introduces the following features: + +* Integrates the new Key Management Interoperability Protocol (KMIP) library into the key management component. + +* Expands Thread Pool statistics with status variables for queue monitoring and wait time analysis. + +* Introduces JSONL (JSON Lines) output format for Audit Log Filter. + +* Increases data dictionary upgrade logging verbosity to aid diagnosis of upgrade failures. + +* Extends Audit Log Filter logging so the `table_access` class records `read` and `insert` statements. + +* Changes audit log shutdown behavior to flush the buffer when the `ASYNCHRONOUS` logging strategy is in use. + +* Reduces memory pressure in the Audit Log Filter component caused by virtual file system (VFS) buffering. + +* Aligns `audit_log_filter.format=NEW` behavior between the 8.0 plugin and the 8.4 component. + +* Suppresses nested general/status records in Audit Log Filter output when `audit_log_filter.event_mode=REDUCED` was enabled. + +* Removes `format=OLD` and set JSONL as the default Audit Log Filter output format. + +* Optimizes performance of `mem_root_deque`. + +This release addresses the list of Common Vulnerabilities and Exposures (CVE). Find the list of CVEs in [Percona Server for MySQL 9.7.1-1](https://docs.percona.com/percona-server/9.7/release-notes/9.7.1-1.html) release notes. + +### MySQL 9.7.1 + +Improvements and bug fixes provided by Oracle for MySQL 9.7.0 and included in Percona Server for MySQL are the following: + +* Connection attribute parsing could read a length-encoded size field before verifying that the complete field was present in the packet, leading to an out-of-bounds read. A size check is now performed before reading the field. (Bug #39116965) + +* A regression in row size estimation for `ROW_FORMAT=COMPRESSED` tables could cause `CREATE TABLE` to fail with `Row size too large` for tables that were accepted in earlier releases. (Bug #39129182, Bug #120323) + +* Under certain circumstances, when calculating the maximum possible index record size, an assertion failure could occur. (Bug #85060, Bug #25579578) + +Find the complete list of bug fixes and changes in the [MySQL 9.7.0 Release Notes](https://dev.mysql.com/doc/relnotes/mysql/9.7/en/news-9-7-0.html). + +## Builds and packaging + +* Percona Server for MySQL releases include a mixture of Profile-Guided Optimization (PGO) and non-PGO builds. Where PGO is enabled, the compiler uses runtime profiling data from representative workloads to guide optimization, which can improve throughput and reduce latency compared with non-PGO builds. + +* See [Profile-Guided Optimization (PGO) and non-PGO builds](https://docs.percona.com/percona-server/9.7/pgo.md) for benefits, considerations, and which build is published for each platform. + +* In Percona Server for MySQL 9.7.1-1 only, Debian and Ubuntu (APT) packaging was reorganized to align more closely with upstream MySQL. Several packages were split into separate components, which may affect upgrades and dependency resolution compared with earlier Percona Server releases. The APT packages are: + + * percona-server-client-core + * percona-server-client-plugins + * percona-server-client + * percona-server-common + * percona-server-server-core + * percona-server-server + * percona-telemetry-agent + +## Known issues + +* In 9.7.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/9.7/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. + +## Supplied components + +Review each component’s release notes for What’s new, improvements, or bug fixes. The following is a list of the components supplied with the Percona Server for MySQL-based variation of the Percona Distribution for MySQL. + +| Component | Version | Description | +| ------------------- | --------- | -------------------------------------------| +| Orchestrator | [3.2.6-20](https://github.com/percona/orchestrator/releases/tag/v3.2.6-20) | The replication topology manager for Percona Server for MySQL| +| ProxySQL | [2.7.3](https://docs.percona.com/proxysql/2.7.3.html) | A high performance, high-availability, protocol-aware proxy for MySQL| +| Percona Toolkit | [3.7.1-3](https://docs.percona.com/percona-toolkit/release_notes.html#v3-7-1-3-released-2026-04-17) | The set of scripts to simplify and optimize database operation. | +| Percona XtraBackup | [9.7.1-1](https://docs.percona.com/percona-xtrabackup/9.7/release-notes/9.7.1-1.html)| An open-source hot backup utility for MySQL-based servers| +| MySQL Shell | [9.7.1](https://dev.mysql.com/doc/relnotes/mysql-shell/9.7/en/news-9-7-1.html) | An advanced client and code editor for MySQL Server| +| MySQL Router | [9.7.1](https://dev.mysql.com/doc/relnotes/mysql-router/9.7/en/news-9-7-1.html) | Lightweight middleware that provides transparent routing between your application and back-end MySQL servers| diff --git a/docs/release-notes.md b/docs/release-notes.md index 4b0c8654..2919e6a0 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -2,8 +2,5 @@ ## Percona Distribution for MySQL using Percona Server for MySQL -* +* [Percona Distribution for MySQL using Percona Server for MySQL 9.7.1 (2026-0-)](release-notes-ps-9.7.1.md) -## Percona Distribution for MySQL using Percona XtraDB Cluster - -* diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index dad08a3c..576bed8e 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 %} -

9.7 (April, 2026)

+

9.7.1 (, 2026)

diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 0f39e2f0..6d5e98eb 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -176,7 +176,8 @@ nav: - ps-or-pdps.md - Release notes: - Release notes index: release-notes.md -# - Percona Distribution for MySQL using Percona Server for MySQL: + - Percona Distribution for MySQL using Percona Server for MySQL: + - release-notes-ps-9.7.1.md # - Percona Distribution for MySQL using Percona XtraDB Cluster: - Discover Percona Distribution for MySQL: - components.md From 8bda5206d12fcb8e6c26f5057e078c738fe17509 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Thu, 25 Jun 2026 17:29:58 +0200 Subject: [PATCH 2/9] DISTMYSQL-606 [Docs] Release notes for - PS 9.7.1-1 new file: docs/release-notes-ps-9.7.1.md modified: docs/release-notes.md modified: docs/templates/pdf_cover_page.tpl modified: mkdocs-base.yml --- docs/release-notes-ps-9.7.1.md | 84 +++++++++++++++++++++++++++++++ docs/release-notes.md | 5 +- docs/templates/pdf_cover_page.tpl | 2 +- mkdocs-base.yml | 3 +- 4 files changed, 88 insertions(+), 6 deletions(-) create mode 100644 docs/release-notes-ps-9.7.1.md diff --git a/docs/release-notes-ps-9.7.1.md b/docs/release-notes-ps-9.7.1.md new file mode 100644 index 00000000..90af04df --- /dev/null +++ b/docs/release-notes-ps-9.7.1.md @@ -0,0 +1,84 @@ +# Percona Distribution for MySQL 9.7.1 using Percona Server for MySQL (2025-0-) + +Percona Distribution for MySQL is more than just a version of MySQL; it is a comprehensive solution that combines Percona Server for MySQL with additional tools to create a cohesive environment. This distribution is reliable, scalable, and secure, ensuring that all components have been tested to work seamlessly together. You can choose from two download options: one that uses Percona Server for MySQL and another that utilizes Percona XtraDB Cluster. Refer to [Install Percona Distribution for MySQL](installing.md). + +!!! note "" + + Percona Distribution for MySQL 9.7.0 using Percona Server for MySQL was not released; 9.7.1 is the next build in this series. This release includes enhancements and bug fixes from MySQL 9.7.0 and MySQL 9.7.1. + +This release is based on [Percona Server for MySQL 9.7.1-1](https://docs.percona.com/percona-server/9.7/release-notes/9.7.1-1.html) that includes all the features and bug fixes available in the [MySQL 9.7.1 Community Edition](https://dev.mysql.com/doc/relnotes/mysql/9.7/en/news-9-7-1.html) and enterprise-grade features developed by Percona. + +## Release highlights + +### Percona Server for MySQL 9.7.1-1 + +Percona Server for MySQL 9.7.1-1 introduces the following features and improvements: + +* Integrates the new Key Management Interoperability Protocol (KMIP) library into the key management component. + +* Expands Thread Pool statistics with status variables for queue monitoring and wait time analysis. + +* Introduces JSONL (JSON Lines) output format for Audit Log Filter. + +* Increases data dictionary upgrade logging verbosity to aid diagnosis of upgrade failures. + +* Extends Audit Log Filter logging so the `table_access` class records `read` and `insert` statements. + +* Changes audit log shutdown behavior to flush the buffer when the `ASYNCHRONOUS` logging strategy is in use. + +* Reduces memory pressure in the Audit Log Filter component caused by virtual file system (VFS) buffering. + +* Aligns `audit_log_filter.format=NEW` behavior between the 8.0 plugin and the 8.4 component. + +* Suppresses nested general/status records in Audit Log Filter output when `audit_log_filter.event_mode=REDUCED` was enabled. + +* Removes `format=OLD` and set JSONL as the default Audit Log Filter output format. + +* Optimizes performance of `mem_root_deque`. + +This release addresses the list of Common Vulnerabilities and Exposures (CVE). Find the list of CVEs in [Percona Server for MySQL 9.7.1-1](https://docs.percona.com/percona-server/9.7/release-notes/9.7.1-1.html) release notes. + +### MySQL 9.7.0 + +Improvements and bug fixes provided by Oracle for MySQL 9.7.0 and included in Percona Server for MySQL are the following: + +* Connection attribute parsing could read a length-encoded size field before verifying that the complete field was present in the packet, leading to an out-of-bounds read. A size check is now performed before reading the field. (Bug #39116965) + +* A regression in row size estimation for `ROW_FORMAT=COMPRESSED` tables could cause `CREATE TABLE` to fail with `Row size too large` for tables that were accepted in earlier releases. (Bug #39129182, Bug #120323) + +* Under certain circumstances, when calculating the maximum possible index record size, an assertion failure could occur. (Bug #85060, Bug #25579578) + +Find the complete list of bug fixes and changes in the [MySQL 9.7.0 Release Notes](https://dev.mysql.com/doc/relnotes/mysql/9.7/en/news-9-7-0.html). + +## Builds and packaging + +* Percona Server for MySQL releases include a mixture of Profile-Guided Optimization (PGO) and non-PGO builds. Where PGO is enabled, the compiler uses runtime profiling data from representative workloads to guide optimization, which can improve throughput and reduce latency compared with non-PGO builds. + +* See [Profile-Guided Optimization (PGO) and non-PGO builds](https://docs.percona.com/percona-server/9.7/pgo.md) for benefits, considerations, and which build is published for each platform. + +* In Percona Server for MySQL 9.7.1-1 only, Debian and Ubuntu (APT) packaging was reorganized to align more closely with upstream MySQL. Several packages were split into separate components, which may affect upgrades and dependency resolution compared with earlier Percona Server releases. The APT packages are: + + * percona-server-client-core + * percona-server-client-plugins + * percona-server-client + * percona-server-common + * percona-server-server-core + * percona-server-server + * percona-telemetry-agent + +## Known issues + +* In 9.7.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/9.7/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. + +## Supplied components + +Review each component’s release notes for What’s new, improvements, or bug fixes. The following is a list of the components supplied with the Percona Server for MySQL-based variation of the Percona Distribution for MySQL. + +| Component | Version | Description | +| ------------------- | --------- | -------------------------------------------| +| Orchestrator | [3.2.6-20](https://github.com/percona/orchestrator/releases/tag/v3.2.6-20) | The replication topology manager for Percona Server for MySQL| +| ProxySQL | [2.7.3](https://docs.percona.com/proxysql/2.7.3.html) | A high performance, high-availability, protocol-aware proxy for MySQL| +| Percona Toolkit | [3.7.1-3](https://docs.percona.com/percona-toolkit/release_notes.html#v3-7-1-3-released-2026-04-17) | The set of scripts to simplify and optimize database operation. | +| Percona XtraBackup | [9.7.1-1](https://docs.percona.com/percona-xtrabackup/9.7/release-notes/9.7.1-1.html)| An open-source hot backup utility for MySQL-based servers| +| MySQL Shell | [9.7.1](https://dev.mysql.com/doc/relnotes/mysql-shell/9.7/en/news-9-7-1.html) | An advanced client and code editor for MySQL Server| +| MySQL Router | [9.7.1](https://dev.mysql.com/doc/relnotes/mysql-router/9.7/en/news-9-7-1.html) | Lightweight middleware that provides transparent routing between your application and back-end MySQL servers| diff --git a/docs/release-notes.md b/docs/release-notes.md index 4b0c8654..2919e6a0 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -2,8 +2,5 @@ ## Percona Distribution for MySQL using Percona Server for MySQL -* +* [Percona Distribution for MySQL using Percona Server for MySQL 9.7.1 (2026-0-)](release-notes-ps-9.7.1.md) -## Percona Distribution for MySQL using Percona XtraDB Cluster - -* diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index dad08a3c..576bed8e 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 %} -

9.7 (April, 2026)

+

9.7.1 (, 2026)

diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 0f39e2f0..6d5e98eb 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -176,7 +176,8 @@ nav: - ps-or-pdps.md - Release notes: - Release notes index: release-notes.md -# - Percona Distribution for MySQL using Percona Server for MySQL: + - Percona Distribution for MySQL using Percona Server for MySQL: + - release-notes-ps-9.7.1.md # - Percona Distribution for MySQL using Percona XtraDB Cluster: - Discover Percona Distribution for MySQL: - components.md From badd98985c515dfb94c2e26e214fd726f0dfac5b Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Thu, 25 Jun 2026 18:03:32 +0200 Subject: [PATCH 3/9] Update release-notes-ps-9.7.1.md --- docs/release-notes-ps-9.7.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes-ps-9.7.1.md b/docs/release-notes-ps-9.7.1.md index 17213204..df03f8ee 100644 --- a/docs/release-notes-ps-9.7.1.md +++ b/docs/release-notes-ps-9.7.1.md @@ -12,7 +12,7 @@ This release is based on [Percona Server for MySQL 9.7.1-1](https://docs.percona ### Percona Server for MySQL 9.7.1-1 -Percona Server for MySQL 9.7.1-1 introduces the following features: +Percona Server for MySQL 9.7.1-1 introduces the following features and improvements: * Integrates the new Key Management Interoperability Protocol (KMIP) library into the key management component. From 8197117f915f345fe9154e93b5dd2cbb3e87320e Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Thu, 25 Jun 2026 18:04:08 +0200 Subject: [PATCH 4/9] Update release-notes-ps-9.7.1.md --- docs/release-notes-ps-9.7.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes-ps-9.7.1.md b/docs/release-notes-ps-9.7.1.md index df03f8ee..90af04df 100644 --- a/docs/release-notes-ps-9.7.1.md +++ b/docs/release-notes-ps-9.7.1.md @@ -38,7 +38,7 @@ Percona Server for MySQL 9.7.1-1 introduces the following features and improveme This release addresses the list of Common Vulnerabilities and Exposures (CVE). Find the list of CVEs in [Percona Server for MySQL 9.7.1-1](https://docs.percona.com/percona-server/9.7/release-notes/9.7.1-1.html) release notes. -### MySQL 9.7.1 +### MySQL 9.7.0 Improvements and bug fixes provided by Oracle for MySQL 9.7.0 and included in Percona Server for MySQL are the following: From 4657bf2568992f8458c69d5416abe59e967fff81 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Wed, 22 Jul 2026 18:14:06 +0200 Subject: [PATCH 5/9] Update release-notes-ps-9.7.1.md --- docs/release-notes-ps-9.7.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes-ps-9.7.1.md b/docs/release-notes-ps-9.7.1.md index 90af04df..49f511d1 100644 --- a/docs/release-notes-ps-9.7.1.md +++ b/docs/release-notes-ps-9.7.1.md @@ -79,6 +79,6 @@ Review each component’s release notes for What’s new, improvements, or bug f | Orchestrator | [3.2.6-20](https://github.com/percona/orchestrator/releases/tag/v3.2.6-20) | The replication topology manager for Percona Server for MySQL| | ProxySQL | [2.7.3](https://docs.percona.com/proxysql/2.7.3.html) | A high performance, high-availability, protocol-aware proxy for MySQL| | Percona Toolkit | [3.7.1-3](https://docs.percona.com/percona-toolkit/release_notes.html#v3-7-1-3-released-2026-04-17) | The set of scripts to simplify and optimize database operation. | -| Percona XtraBackup | [9.7.1-1](https://docs.percona.com/percona-xtrabackup/9.7/release-notes/9.7.1-1.html)| An open-source hot backup utility for MySQL-based servers| +| Percona XtraBackup | [9.7.1-rc1](https://docs.percona.com/percona-xtrabackup/9.7/release-notes/9.7.1-rc1.html)| An open-source hot backup utility for MySQL-based servers| | MySQL Shell | [9.7.1](https://dev.mysql.com/doc/relnotes/mysql-shell/9.7/en/news-9-7-1.html) | An advanced client and code editor for MySQL Server| | MySQL Router | [9.7.1](https://dev.mysql.com/doc/relnotes/mysql-router/9.7/en/news-9-7-1.html) | Lightweight middleware that provides transparent routing between your application and back-end MySQL servers| From feae4ea2094443e9c5f5f711074a64c9102e6451 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Mon, 27 Jul 2026 16:02:01 +0200 Subject: [PATCH 6/9] Update pdf_cover_page.tpl --- docs/templates/pdf_cover_page.tpl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index 576bed8e..d832d282 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 %} -

9.7.1 (, 2026)

+

9.7.1 (July 30, 2026)

From a3fcc34d0edd03bee0a9065fb03a05815b8544ae Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Mon, 27 Jul 2026 16:02:22 +0200 Subject: [PATCH 7/9] Update release-notes-ps-9.7.1.md --- docs/release-notes-ps-9.7.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes-ps-9.7.1.md b/docs/release-notes-ps-9.7.1.md index 49f511d1..aa095501 100644 --- a/docs/release-notes-ps-9.7.1.md +++ b/docs/release-notes-ps-9.7.1.md @@ -1,4 +1,4 @@ -# Percona Distribution for MySQL 9.7.1 using Percona Server for MySQL (2025-0-) +# Percona Distribution for MySQL 9.7.1 using Percona Server for MySQL (2025-07-30) Percona Distribution for MySQL is more than just a version of MySQL; it is a comprehensive solution that combines Percona Server for MySQL with additional tools to create a cohesive environment. This distribution is reliable, scalable, and secure, ensuring that all components have been tested to work seamlessly together. You can choose from two download options: one that uses Percona Server for MySQL and another that utilizes Percona XtraDB Cluster. Refer to [Install Percona Distribution for MySQL](installing.md). From 19a1cba8a12e016533f5aad6b79a96cc686dd067 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Mon, 27 Jul 2026 16:02:39 +0200 Subject: [PATCH 8/9] Update release-notes.md --- docs/components.md | 2 -- docs/deployment-variants.md | 4 ++-- docs/downgrade.md | 4 ++-- docs/installing.md | 2 ++ docs/minor-upgrade.md | 4 ++-- docs/release-notes.md | 2 +- 6 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/components.md b/docs/components.md index ee5bd5c8..b3965f16 100644 --- a/docs/components.md +++ b/docs/components.md @@ -24,7 +24,5 @@ Percona Distribution for MySQL consists of the following **components**: !!! important - - This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available. In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. diff --git a/docs/deployment-variants.md b/docs/deployment-variants.md index e5afe082..720ab787 100644 --- a/docs/deployment-variants.md +++ b/docs/deployment-variants.md @@ -12,9 +12,9 @@ Percona Distribution for MySQL provides two deployment variants: one is Percona | MySQL Shell | YES | | MySQL Router | YES | -!!! important + - This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available. +!!! important In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. diff --git a/docs/downgrade.md b/docs/downgrade.md index f44585b3..bfb5b7e3 100644 --- a/docs/downgrade.md +++ b/docs/downgrade.md @@ -1,8 +1,8 @@ # Downgrade Percona Distribution for MySQL -!!! important + - This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available. +!!! important In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. diff --git a/docs/installing.md b/docs/installing.md index 6b468841..78faecfb 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -1,5 +1,7 @@ # Install Percona Distribution for MySQL + + !!! important In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. diff --git a/docs/minor-upgrade.md b/docs/minor-upgrade.md index 3027e502..d6b72364 100644 --- a/docs/minor-upgrade.md +++ b/docs/minor-upgrade.md @@ -1,8 +1,8 @@ # Upgrade Percona Distribution for MySQL -!!! important + - This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available. +!!! important In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. diff --git a/docs/release-notes.md b/docs/release-notes.md index 2919e6a0..cfeb5b41 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -2,5 +2,5 @@ ## Percona Distribution for MySQL using Percona Server for MySQL -* [Percona Distribution for MySQL using Percona Server for MySQL 9.7.1 (2026-0-)](release-notes-ps-9.7.1.md) +* [Percona Distribution for MySQL using Percona Server for MySQL 9.7.1 (2026-07-30)](release-notes-ps-9.7.1.md) From b2fe5113dbee54dce9ce93441676ba0902549b10 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Wed, 29 Jul 2026 17:00:48 +0200 Subject: [PATCH 9/9] ennd --- docs/components.md | 8 ++++---- docs/deployment-variants.md | 4 ++-- docs/downgrade.md | 6 +++--- docs/installing.md | 4 ++-- docs/minor-upgrade.md | 4 ++-- docs/release-notes-ps-9.7.1.md | 9 +++++---- docs/release-notes.md | 2 +- docs/templates/pdf_cover_page.tpl | 2 +- docs/uninstalling.md | 2 ++ mkdocs-base.yml | 10 +++++----- variables.yml | 6 +++--- 11 files changed, 30 insertions(+), 27 deletions(-) diff --git a/docs/components.md b/docs/components.md index b3965f16..7accdfdb 100644 --- a/docs/components.md +++ b/docs/components.md @@ -4,9 +4,9 @@ Percona Distribution for MySQL consists of the following **components**: * [Percona Server for MySQL :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/) is a drop-in replacement for MySQL Community Edition with the enterprise-grade features embedded by Percona. -* [Percona XtraDB Cluster :octicons-link-external-16:](https://docs.percona.com/percona-xtradb-cluster/8.4/index.html) is the high-available clustering solution for MySQL. It is based on [Percona Server for MySQL :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/index.html) and uses [Percona XtraBackup :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/8.4/index.html) for node provisioning. +* [Percona XtraDB Cluster :octicons-link-external-16:](https://docs.percona.com/percona-xtradb-cluster/8.4/index.html) is the high-available clustering solution for MySQL. It is based on [Percona Server for MySQL :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/index.html) and uses [Percona XtraBackup :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/{{vers}}/index.html) for node provisioning. -* [Percona XtraBackup :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/8.4/) is an open-source hot backup utility for MySQL-based servers that doesn’t lock your database during the backup. +* [Percona XtraBackup :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/{{vers}}/) is an open-source hot backup utility for MySQL-based servers that doesn’t lock your database during the backup. * [Orchestrator :octicons-link-external-16:(https://github.com/openark/orchestrator) is the replication topology manager for Percona Server for MySQL. @@ -21,8 +21,8 @@ Percona Distribution for MySQL consists of the following **components**: * [MySQL Router :octicons-link-external-16:](https://dev.mysql.com/doc/mysql-router/{{vers}}/en/) is lightweight middleware that provides transparent routing between your application and back-end MySQL servers. - - !!! important + + This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available. In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. diff --git a/docs/deployment-variants.md b/docs/deployment-variants.md index 720ab787..e5afe082 100644 --- a/docs/deployment-variants.md +++ b/docs/deployment-variants.md @@ -12,9 +12,9 @@ Percona Distribution for MySQL provides two deployment variants: one is Percona | MySQL Shell | YES | | MySQL Router | YES | - - !!! important + + This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available. In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. diff --git a/docs/downgrade.md b/docs/downgrade.md index bfb5b7e3..06b18ce4 100644 --- a/docs/downgrade.md +++ b/docs/downgrade.md @@ -1,8 +1,8 @@ # Downgrade Percona Distribution for MySQL - - !!! important + + This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available. In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. @@ -32,7 +32,7 @@ You have the following downgrade options: Key Points: -* You cannot downgrade to version 5.7 or earlier +* You cannot downgrade to version 8.0 or earlier * You cannot downgrade if you've used new version features diff --git a/docs/installing.md b/docs/installing.md index 78faecfb..cc735f1a 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -1,8 +1,8 @@ # Install Percona Distribution for MySQL - - !!! important + + This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available. In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. diff --git a/docs/minor-upgrade.md b/docs/minor-upgrade.md index d6b72364..3027e502 100644 --- a/docs/minor-upgrade.md +++ b/docs/minor-upgrade.md @@ -1,8 +1,8 @@ # Upgrade Percona Distribution for MySQL - - !!! important + + This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available. In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. diff --git a/docs/release-notes-ps-9.7.1.md b/docs/release-notes-ps-9.7.1.md index aa095501..ba422f55 100644 --- a/docs/release-notes-ps-9.7.1.md +++ b/docs/release-notes-ps-9.7.1.md @@ -1,4 +1,4 @@ -# Percona Distribution for MySQL 9.7.1 using Percona Server for MySQL (2025-07-30) +# Percona Distribution for MySQL 9.7.1 using Percona Server for MySQL (2026-08-05) Percona Distribution for MySQL is more than just a version of MySQL; it is a comprehensive solution that combines Percona Server for MySQL with additional tools to create a cohesive environment. This distribution is reliable, scalable, and secure, ensuring that all components have been tested to work seamlessly together. You can choose from two download options: one that uses Percona Server for MySQL and another that utilizes Percona XtraDB Cluster. Refer to [Install Percona Distribution for MySQL](installing.md). @@ -67,6 +67,8 @@ Find the complete list of bug fixes and changes in the [MySQL 9.7.0 Release Note * percona-telemetry-agent ## Known issues + +* This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available. * In 9.7.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/9.7/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures. @@ -76,9 +78,8 @@ Review each component’s release notes for What’s new, improvements, or bug f | Component | Version | Description | | ------------------- | --------- | -------------------------------------------| -| Orchestrator | [3.2.6-20](https://github.com/percona/orchestrator/releases/tag/v3.2.6-20) | The replication topology manager for Percona Server for MySQL| -| ProxySQL | [2.7.3](https://docs.percona.com/proxysql/2.7.3.html) | A high performance, high-availability, protocol-aware proxy for MySQL| -| Percona Toolkit | [3.7.1-3](https://docs.percona.com/percona-toolkit/release_notes.html#v3-7-1-3-released-2026-04-17) | The set of scripts to simplify and optimize database operation. | +| Orchestrator | [3.2.6-22](https://github.com/percona/orchestrator/releases/tag/v3.2.6-22) | The replication topology manager for Percona Server for MySQL| +| ProxySQL | [3.0.9](https://docs.percona.com/proxysql/3.0.9.html) | A high performance, high-availability, protocol-aware proxy for MySQL| | Percona XtraBackup | [9.7.1-rc1](https://docs.percona.com/percona-xtrabackup/9.7/release-notes/9.7.1-rc1.html)| An open-source hot backup utility for MySQL-based servers| | MySQL Shell | [9.7.1](https://dev.mysql.com/doc/relnotes/mysql-shell/9.7/en/news-9-7-1.html) | An advanced client and code editor for MySQL Server| | MySQL Router | [9.7.1](https://dev.mysql.com/doc/relnotes/mysql-router/9.7/en/news-9-7-1.html) | Lightweight middleware that provides transparent routing between your application and back-end MySQL servers| diff --git a/docs/release-notes.md b/docs/release-notes.md index cfeb5b41..08872eef 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -2,5 +2,5 @@ ## Percona Distribution for MySQL using Percona Server for MySQL -* [Percona Distribution for MySQL using Percona Server for MySQL 9.7.1 (2026-07-30)](release-notes-ps-9.7.1.md) +* [Percona Distribution for MySQL using Percona Server for MySQL 9.7.1 (2026-08-05)](release-notes-ps-9.7.1.md) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index d832d282..ff9d8516 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 %} -

9.7.1 (July 30, 2026)

+

9.7.1 (August 05, 2026)

diff --git a/docs/uninstalling.md b/docs/uninstalling.md index ef2b94d8..a5e0393e 100644 --- a/docs/uninstalling.md +++ b/docs/uninstalling.md @@ -121,6 +121,7 @@ To uninstall Percona Distribution for MySQL, stop the `mysql` service and remove sudo yum remove percona-mysql-router ``` + \ No newline at end of file diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 6d5e98eb..0d1c9636 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -185,7 +185,7 @@ nav: - Install and update: - installing.md - install-pdps.md - - install-pdpxc.md +# - install-pdpxc.md - minor-upgrade.md - downgrade.md - Solutions - high availability: @@ -193,10 +193,10 @@ nav: - architecture-components.md - monitoring.md - Deployment: deploy-pdps-group-replication.md - - Replication manager for Percona XtraDB Cluster: - - replication-manager-for-pxc.md - - replication-manager-troubleshooting.md - - single-replica-manager.md +# - Replication manager for Percona XtraDB Cluster: +# - replication-manager-for-pxc.md +# - replication-manager-troubleshooting.md +# - single-replica-manager.md - Uninstall: - uninstalling.md - download-instructions.md diff --git a/variables.yml b/variables.yml index edce6e4a..7d11037a 100644 --- a/variables.yml +++ b/variables.yml @@ -7,6 +7,6 @@ vers: '9.7' majorpkg: 'pdps-97-lts' minorpkg: 'pdps-9.7.1' majorpkgpxc: 'pdpxc-84-lts' -minorpkgpxc: 'pdpxc-8.4.8' -release_date: '2026-0-' -title_date: '2026-0-' +minorpkgpxc: 'pdpxc-8.4.10' +release_date: '2026-08-05' +title_date: '2026-08-05'