From b9c05974c9c364d16168a563c705f2e5245f66ef Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Fri, 7 Aug 2026 18:24:20 +0200 Subject: [PATCH 1/6] DISTMYSQL-627 [Doc] Release notes for - PDPXC 9.7.1 modified: docs/components.md modified: docs/install-pdpxc.md new file: docs/release-notes-pxc-9.7.1.md modified: docs/release-notes.md modified: docs/uninstalling.md modified: mkdocs-base.yml modified: variables.yml --- docs/components.md | 2 +- docs/install-pdpxc.md | 10 ++--- docs/release-notes-pxc-9.7.1.md | 77 +++++++++++++++++++++++++++++++++ docs/release-notes.md | 3 ++ docs/uninstalling.md | 6 +-- mkdocs-base.yml | 13 +++--- variables.yml | 8 ++-- 7 files changed, 99 insertions(+), 20 deletions(-) create mode 100644 docs/release-notes-pxc-9.7.1.md diff --git a/docs/components.md b/docs/components.md index 7accdfdb..12773ab0 100644 --- a/docs/components.md +++ b/docs/components.md @@ -4,7 +4,7 @@ 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/{{vers}}/index.html) for node provisioning. +* [Percona XtraDB Cluster :octicons-link-external-16:](https://docs.percona.com/percona-xtradb-cluster/{{vers}}/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/{{vers}}/) is an open-source hot backup utility for MySQL-based servers that doesn’t lock your database during the backup. diff --git a/docs/install-pdpxc.md b/docs/install-pdpxc.md index 2c70a2ff..caef1a10 100644 --- a/docs/install-pdpxc.md +++ b/docs/install-pdpxc.md @@ -1,6 +1,6 @@ # Install Percona XtraDB Cluster-based variant -We gather [Telemetry data on Percona XtraDB Cluster :octicons-link-external-16:](https://docs.percona.com/percona-xtradb-cluster/8.4/telemetry.html) in the Percona packages and Docker images. +We gather [Telemetry data on Percona XtraDB Cluster :octicons-link-external-16:](https://docs.percona.com/percona-xtradb-cluster/{{vers}}/telemetry.html) in the Percona packages and Docker images. ## Prerequisites @@ -32,7 +32,7 @@ To install Percona software, you need to configure the required repository. To s !!! tip - To enable either the `pdpxc-8.4.0` or `pdpxc-8.4.2` version repository, use the following command. The example enables the `{{minorpkgpxc}}` repository: + To enable either the `pdpxc-9.7.1` or `pdpxc-9.7.2` version repository, use the following command. The example enables the `{{minorpkgpxc}}` repository: ```shell sudo percona-release setup {{minorpkgpxc}} @@ -59,7 +59,7 @@ To install Percona software, you need to configure the required repository. To s Install Percona XtraBackup: ```shell - sudo apt install percona-xtrabackup-84 + sudo apt install percona-xtrabackup-97 ``` Install Percona Toolkit: @@ -84,7 +84,7 @@ To install Percona software, you need to configure the required repository. To s !!! tip - To enable either the `pdpxc-8.4.0` or `pdpxc-8.4.2` version repository, use the following command. The example enables the `{{minorpkgpxc}}` repository: + To enable either the `pdpxc-9.7.1` or `pdpxc-9.7.2` version repository, use the following command. The example enables the `{{minorpkgpxc}}` repository: ```shell sudo percona-release setup {{minorpkgpxc}} @@ -111,7 +111,7 @@ To install Percona software, you need to configure the required repository. To s Install Percona XtraBackup: ```shell - sudo yum install percona-xtrabackup-84 + sudo yum install percona-xtrabackup-97 ``` Install Percona Toolkit: diff --git a/docs/release-notes-pxc-9.7.1.md b/docs/release-notes-pxc-9.7.1.md new file mode 100644 index 00000000..9b9457fe --- /dev/null +++ b/docs/release-notes-pxc-9.7.1.md @@ -0,0 +1,77 @@ +# Percona Distribution for MySQL 9.7.1 using Percona XtraDB Cluster (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). + +!!! note "" + + Percona Distribution for MySQL 9.7.0 using Percona XtraDB Cluster 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 XtraDB Cluster 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.0 Community Edition](https://dev.mysql.com/doc/relnotes/mysql/9.7/en/news-9-7-0.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 new features and improvements: + +* Integrates the new Key Management Interoperability Protocol (KMIP) library into the key management component. + +* Adds JSONL (JSON Lines) output format for Audit Log Filter. + +* Increases the verbosity of the data dictionary upgrade process, making it easier to diagnose issues that occur during upgrade. + +* Logs SQL statements for the Audit Log Filter `table_access` class and the `read` and `insert` subclasses. + +* Flushes the audit log buffer on server shutdown when the `ASYNCHRONOUS` logging strategy is in use, preventing the loss of buffered events. + +* Reduces memory pressure in the Audit Log Filter component caused by VFS buffering. + +* Aligns the `audit_log_filter.format=NEW` output between the 8.0 plugin and the 8.4 component. + +* Optimizes performance for `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) + +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 + +* 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. + +## 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 | +| ----------------------- | --------- | -------------------------------------------| +| Percona XtraBackup | [8.4.0-6](https://docs.percona.com/percona-xtrabackup/8.4/release-notes/8.4.0-6.html)| An open-source hot backup utility for MySQL-based servers that doesn’t lock your database during the backup.| +| HAProxy | [2.8.26](https://git.haproxy.org/?p=haproxy-2.8.git;a=commit;h=682859627b241be60d2c26e0671c702a2681bcd2) | A high-availability and load-balancing solution for Percona XtraDB Cluster. This is a default proxy.| +| 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-4](https://docs.percona.com/percona-toolkit/release_notes.html#v3-7-1-4-released-2026-07-02) | The set of scripts to simplify and optimize database operation. | +| replication_manager.sh | [1.0](https://docs.percona.com/percona-distribution-for-mysql/8.4/replication-manager-for-pxc.html) | A tool to manage multi-source replication between multiple Percona XtraDB Cluster clusters. | diff --git a/docs/release-notes.md b/docs/release-notes.md index 08872eef..a65d67f7 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -4,3 +4,6 @@ * [Percona Distribution for MySQL using Percona Server for MySQL 9.7.1 (2026-08-05)](release-notes-ps-9.7.1.md) +## Percona Distribution for MySQL using Percona XtraDB Cluster + +* [Percona Distribution for MySQL 9.7.1 using Percona XtraDB Cluster (2026-08-)](release-notes-pxc-9.7.1.md) diff --git a/docs/uninstalling.md b/docs/uninstalling.md index a5e0393e..c525f58e 100644 --- a/docs/uninstalling.md +++ b/docs/uninstalling.md @@ -121,7 +121,6 @@ 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 0d1c9636..56e61be4 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -178,14 +178,15 @@ nav: - Release notes index: release-notes.md - Percona Distribution for MySQL using Percona Server for MySQL: - release-notes-ps-9.7.1.md -# - Percona Distribution for MySQL using Percona XtraDB Cluster: + - Percona Distribution for MySQL using Percona XtraDB Cluster: + - release-notes-pxc-9.7.1.md - Discover Percona Distribution for MySQL: - components.md - deployment-variants.md - Install and update: - installing.md - install-pdps.md -# - install-pdpxc.md + - install-pdpxc.md - minor-upgrade.md - downgrade.md - Solutions - high availability: @@ -193,10 +194,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 7d11037a..037d1464 100644 --- a/variables.yml +++ b/variables.yml @@ -6,7 +6,7 @@ psvers: '9.7.1-1' vers: '9.7' majorpkg: 'pdps-97-lts' minorpkg: 'pdps-9.7.1' -majorpkgpxc: 'pdpxc-84-lts' -minorpkgpxc: 'pdpxc-8.4.10' -release_date: '2026-08-05' -title_date: '2026-08-05' +majorpkgpxc: 'pdpxc-97-lts' +minorpkgpxc: 'pdpxc-9.7.1' +release_date: '2026-08-0' +title_date: '2026-08-0' From fadb94593dbfb3e6bf1bab061982b72631061a1f Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Mon, 31 Aug 2026 19:10:37 +0200 Subject: [PATCH 2/6] Update release-notes-pxc-9.7.1.md --- docs/release-notes-pxc-9.7.1.md | 18 ++++-------------- 1 file changed, 4 insertions(+), 14 deletions(-) diff --git a/docs/release-notes-pxc-9.7.1.md b/docs/release-notes-pxc-9.7.1.md index 9b9457fe..8eef6a51 100644 --- a/docs/release-notes-pxc-9.7.1.md +++ b/docs/release-notes-pxc-9.7.1.md @@ -48,21 +48,11 @@ Find the complete list of bug fixes and changes in the [MySQL 9.7.0 Release Note * 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 -* 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. +* Percona XtraDB Cluster uses Profile-Guided Optimization (PGO) builds to improve runtime performance. PGO uses profiling data from representative workloads to guide compiler optimizations, which can improve throughput and reduce latency. Percona XtraDB Cluster packages are built with PGO enabled. + + See [Profile-Guided Optimization (PGO) and non-PGO builds](https://docs.percona.com/percona-server/9.7/pgo.html) for more information about PGO benefits and considerations. ## Supplied components @@ -71,7 +61,7 @@ Review each component’s release notes for What’s new, improvements, or bug f | Component | Version | Description | | ----------------------- | --------- | -------------------------------------------| | Percona XtraBackup | [8.4.0-6](https://docs.percona.com/percona-xtrabackup/8.4/release-notes/8.4.0-6.html)| An open-source hot backup utility for MySQL-based servers that doesn’t lock your database during the backup.| -| HAProxy | [2.8.26](https://git.haproxy.org/?p=haproxy-2.8.git;a=commit;h=682859627b241be60d2c26e0671c702a2681bcd2) | A high-availability and load-balancing solution for Percona XtraDB Cluster. This is a default proxy.| +| HAProxy | [3.4.4](https://git.haproxy.org/?p=haproxy-3.4.git;a=commit;h=7f03ae65c28605152c7a1a9ba7d9d0bcfb50f8b0) | A high-availability and load-balancing solution for Percona XtraDB Cluster. This is a default proxy.| | 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-4](https://docs.percona.com/percona-toolkit/release_notes.html#v3-7-1-4-released-2026-07-02) | The set of scripts to simplify and optimize database operation. | | replication_manager.sh | [1.0](https://docs.percona.com/percona-distribution-for-mysql/8.4/replication-manager-for-pxc.html) | A tool to manage multi-source replication between multiple Percona XtraDB Cluster clusters. | From c469e9c039cc102ddea7344e24ec3428574dc8d7 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Wed, 2 Sep 2026 17:14:11 +0200 Subject: [PATCH 3/6] Update release-notes-pxc-9.7.1.md --- docs/release-notes-pxc-9.7.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes-pxc-9.7.1.md b/docs/release-notes-pxc-9.7.1.md index 8eef6a51..2c066b67 100644 --- a/docs/release-notes-pxc-9.7.1.md +++ b/docs/release-notes-pxc-9.7.1.md @@ -62,6 +62,6 @@ Review each component’s release notes for What’s new, improvements, or bug f | ----------------------- | --------- | -------------------------------------------| | Percona XtraBackup | [8.4.0-6](https://docs.percona.com/percona-xtrabackup/8.4/release-notes/8.4.0-6.html)| An open-source hot backup utility for MySQL-based servers that doesn’t lock your database during the backup.| | HAProxy | [3.4.4](https://git.haproxy.org/?p=haproxy-3.4.git;a=commit;h=7f03ae65c28605152c7a1a9ba7d9d0bcfb50f8b0) | A high-availability and load-balancing solution for Percona XtraDB Cluster. This is a default proxy.| -| ProxySQL | [2.7.3](https://docs.percona.com/proxysql/2.7.3.html)| A high performance, high-availability, protocol-aware proxy for MySQL. | +| ProxySQL | [3.0.6](https://docs.percona.com/proxysql/3.0.6.html)| A high performance, high-availability, protocol-aware proxy for MySQL. | | Percona Toolkit | [3.7.1-4](https://docs.percona.com/percona-toolkit/release_notes.html#v3-7-1-4-released-2026-07-02) | The set of scripts to simplify and optimize database operation. | | replication_manager.sh | [1.0](https://docs.percona.com/percona-distribution-for-mysql/8.4/replication-manager-for-pxc.html) | A tool to manage multi-source replication between multiple Percona XtraDB Cluster clusters. | From 5b925fbd2e6ac9ba0ddba50ac39c8c13c42dbcf4 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Wed, 2 Sep 2026 18:31:35 +0200 Subject: [PATCH 4/6] Update release-notes-pxc-9.7.1.md --- docs/release-notes-pxc-9.7.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes-pxc-9.7.1.md b/docs/release-notes-pxc-9.7.1.md index 2c066b67..c7900369 100644 --- a/docs/release-notes-pxc-9.7.1.md +++ b/docs/release-notes-pxc-9.7.1.md @@ -62,6 +62,6 @@ Review each component’s release notes for What’s new, improvements, or bug f | ----------------------- | --------- | -------------------------------------------| | Percona XtraBackup | [8.4.0-6](https://docs.percona.com/percona-xtrabackup/8.4/release-notes/8.4.0-6.html)| An open-source hot backup utility for MySQL-based servers that doesn’t lock your database during the backup.| | HAProxy | [3.4.4](https://git.haproxy.org/?p=haproxy-3.4.git;a=commit;h=7f03ae65c28605152c7a1a9ba7d9d0bcfb50f8b0) | A high-availability and load-balancing solution for Percona XtraDB Cluster. This is a default proxy.| -| ProxySQL | [3.0.6](https://docs.percona.com/proxysql/3.0.6.html)| A high performance, high-availability, protocol-aware proxy 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 Toolkit | [3.7.1-4](https://docs.percona.com/percona-toolkit/release_notes.html#v3-7-1-4-released-2026-07-02) | The set of scripts to simplify and optimize database operation. | | replication_manager.sh | [1.0](https://docs.percona.com/percona-distribution-for-mysql/8.4/replication-manager-for-pxc.html) | A tool to manage multi-source replication between multiple Percona XtraDB Cluster clusters. | From 9a139a0bcec14b040f1475db7aff5e38ea1904de Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Mon, 7 Sep 2026 19:32:42 +0200 Subject: [PATCH 5/6] Update release-notes-pxc-9.7.1.md --- docs/release-notes-pxc-9.7.1.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/docs/release-notes-pxc-9.7.1.md b/docs/release-notes-pxc-9.7.1.md index c7900369..149c49e4 100644 --- a/docs/release-notes-pxc-9.7.1.md +++ b/docs/release-notes-pxc-9.7.1.md @@ -48,6 +48,29 @@ Find the complete list of bug fixes and changes in the [MySQL 9.7.0 Release Note * 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 XtraDB Cluster 9.7, packaging was reorganized to align more closely with upstream MySQL, consistent with the equivalent change in Percona Server for MySQL 9.7. Several packages were split into separate components, which may affect upgrades and dependency resolution compared with earlier Percona XtraDB Cluster releases. + + The APT packages (Debian and Ubuntu) are: + + * percona-xtradb-cluster-client-core + * percona-xtradb-cluster-client-plugins + * percona-xtradb-cluster-client + * percona-xtradb-cluster-common + * percona-xtradb-cluster-server-core + * percona-xtradb-cluster-server + * percona-xtradb-cluster-garbd + * percona-telemetry-agent + + The YUM packages (RHEL, CentOS, Oracle Linux) are: + + * percona-xtradb-cluster-client + * percona-xtradb-cluster-client-plugins + * percona-xtradb-cluster-server + * percona-xtradb-cluster-shared + * percona-xtradb-cluster-garbd + * percona-xtradb-cluster-icu-data-files + * percona-telemetry-agent + ## Known issues * Percona XtraDB Cluster uses Profile-Guided Optimization (PGO) builds to improve runtime performance. PGO uses profiling data from representative workloads to guide compiler optimizations, which can improve throughput and reduce latency. Percona XtraDB Cluster packages are built with PGO enabled. From 46c4be8625030b35090980f4bd832160544781c7 Mon Sep 17 00:00:00 2001 From: Alina Derkach Date: Tue, 8 Sep 2026 22:12:38 +0200 Subject: [PATCH 6/6] Update the dates in the release notes --- docs/release-notes-pxc-9.7.1.md | 17 ++++++++--------- docs/release-notes.md | 2 +- docs/templates/pdf_cover_page.tpl | 2 +- variables.yml | 4 ++-- 4 files changed, 12 insertions(+), 13 deletions(-) diff --git a/docs/release-notes-pxc-9.7.1.md b/docs/release-notes-pxc-9.7.1.md index 149c49e4..6ccb0635 100644 --- a/docs/release-notes-pxc-9.7.1.md +++ b/docs/release-notes-pxc-9.7.1.md @@ -1,4 +1,4 @@ -# Percona Distribution for MySQL 9.7.1 using Percona XtraDB Cluster (2026-08-05) +# Percona Distribution for MySQL 9.7.1 using Percona XtraDB Cluster (2026-09-10) 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). @@ -44,9 +44,9 @@ Find the complete list of bug fixes and changes in the [MySQL 9.7.0 Release Note ## 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. +* Percona XtraDB Cluster uses Profile-Guided Optimization (PGO) builds to improve runtime performance. PGO uses profiling data from representative workloads to guide compiler optimizations, which can improve throughput and reduce latency. Percona XtraDB Cluster packages are built with PGO enabled. -* 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. + See [Profile-Guided Optimization (PGO) and non-PGO builds](https://docs.percona.com/percona-server/9.7/pgo.html) for more information about PGO benefits and considerations. * In Percona XtraDB Cluster 9.7, packaging was reorganized to align more closely with upstream MySQL, consistent with the equivalent change in Percona Server for MySQL 9.7. Several packages were split into separate components, which may affect upgrades and dependency resolution compared with earlier Percona XtraDB Cluster releases. @@ -73,9 +73,9 @@ Find the complete list of bug fixes and changes in the [MySQL 9.7.0 Release Note ## Known issues -* Percona XtraDB Cluster uses Profile-Guided Optimization (PGO) builds to improve runtime performance. PGO uses profiling data from representative workloads to guide compiler optimizations, which can improve throughput and reduce latency. Percona XtraDB Cluster packages are built with PGO enabled. - - See [Profile-Guided Optimization (PGO) and non-PGO builds](https://docs.percona.com/percona-server/9.7/pgo.html) for more information about PGO benefits and considerations. +* 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. ## Supplied components @@ -83,8 +83,7 @@ Review each component’s release notes for What’s new, improvements, or bug f | Component | Version | Description | | ----------------------- | --------- | -------------------------------------------| -| Percona XtraBackup | [8.4.0-6](https://docs.percona.com/percona-xtrabackup/8.4/release-notes/8.4.0-6.html)| An open-source hot backup utility for MySQL-based servers that doesn’t lock your database during the backup.| +| 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 that doesn’t lock your database during the backup.| | HAProxy | [3.4.4](https://git.haproxy.org/?p=haproxy-3.4.git;a=commit;h=7f03ae65c28605152c7a1a9ba7d9d0bcfb50f8b0) | A high-availability and load-balancing solution for Percona XtraDB Cluster. This is a default proxy.| | ProxySQL | [3.0.9](https://docs.percona.com/proxysql/3.0.9.html)| A high performance, high-availability, protocol-aware proxy for MySQL. | -| Percona Toolkit | [3.7.1-4](https://docs.percona.com/percona-toolkit/release_notes.html#v3-7-1-4-released-2026-07-02) | The set of scripts to simplify and optimize database operation. | -| replication_manager.sh | [1.0](https://docs.percona.com/percona-distribution-for-mysql/8.4/replication-manager-for-pxc.html) | A tool to manage multi-source replication between multiple Percona XtraDB Cluster clusters. | +| replication_manager.sh | [1.0](https://docs.percona.com/percona-distribution-for-mysql/9.7/replication-manager-for-pxc.html) | A tool to manage multi-source replication between multiple Percona XtraDB Cluster clusters. | diff --git a/docs/release-notes.md b/docs/release-notes.md index a65d67f7..9eae81ed 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -6,4 +6,4 @@ ## Percona Distribution for MySQL using Percona XtraDB Cluster -* [Percona Distribution for MySQL 9.7.1 using Percona XtraDB Cluster (2026-08-)](release-notes-pxc-9.7.1.md) +* [Percona Distribution for MySQL 9.7.1 using Percona XtraDB Cluster (2026-09-10)](release-notes-pxc-9.7.1.md) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index ff9d8516..8b6cbcc8 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 (August 05, 2026)

+

9.7.1 (September 10, 2026)

diff --git a/variables.yml b/variables.yml index 037d1464..a93e0b8a 100644 --- a/variables.yml +++ b/variables.yml @@ -8,5 +8,5 @@ majorpkg: 'pdps-97-lts' minorpkg: 'pdps-9.7.1' majorpkgpxc: 'pdpxc-97-lts' minorpkgpxc: 'pdpxc-9.7.1' -release_date: '2026-08-0' -title_date: '2026-08-0' +release_date: '2026-09-10' +title_date: '2026-09-10'