From 387b42dc97a328bba8dec0d5e608bd5ef153d41b Mon Sep 17 00:00:00 2001
From: Patrick Birch <48594400+patrickbirch@users.noreply.github.com>
Date: Wed, 2 Sep 2026 06:23:22 -0500
Subject: [PATCH] PS-11354 [Docs] Release notes for PS 9.7.2-2
modified: mkdocs-base.yml
modified: docs/release-notes/release-notes-index.md
docs/release-notes/9.7.2-2.md
---
docs/release-notes/9.7.2-2.md | 91 +++++++++++++++++++++++
docs/release-notes/release-notes-index.md | 2 +
docs/templates/pdf_cover_page.tpl | 4 +-
mkdocs-base.yml | 1 +
variables.yml | 10 +--
5 files changed, 101 insertions(+), 7 deletions(-)
create mode 100644 docs/release-notes/9.7.2-2.md
diff --git a/docs/release-notes/9.7.2-2.md b/docs/release-notes/9.7.2-2.md
new file mode 100644
index 00000000000..ea34db753f3
--- /dev/null
+++ b/docs/release-notes/9.7.2-2.md
@@ -0,0 +1,91 @@
+# Percona Server for MySQL 9.7.2-2 (2026-09-28)
+
+Get started with [Quickstart Guide for Percona Server for MySQL](../quickstart-overview.md).
+
+[Percona Server for MySQL 9.7.2-2](https://www.percona.com/mysql/software) includes all the features and bug fixes available in the [MySQL 9.7.2 Community Edition](https://dev.mysql.com/doc/relnotes/mysql/9.7/en/news-9-7-2.html) and enterprise-grade features developed by Percona.
+
+!!! note "A note on MySQL 9.7.3"
+
+ After a thorough review of the updates included in MySQL 9.7.3, Percona has decided not to release a corresponding Percona Server for MySQL 9.7.3. MySQL 9.7.3 is a Critical Security Patch Update (CSPU) — a targeted security release that Oracle can issue between quarterly Critical Patch Updates (CPUs) when needed. The fixes included in this CSPU do not affect Percona Server for MySQL.
+
+## Release highlights
+
+### MySQL 9.7.2
+
+Improvements and bug fixes provided by Oracle for MySQL 9.7.2 and included in Percona Server for MySQL are the following:
+
+* Under certain circumstances, when adding an AUTO_INCREMENT column to an existing table, some records in that table could be skipped, resulting in inaccurate values in the AUTO_INCREMENT column. (Bug #115136, Bug #37105825)
+
+* During a buffer-pool resize, Adaptive Hash Index could be disabled in mysqld-auto.cnf even though innodb_adaptive_hash_index=ON. (Bug #39157211)
+
+* Fixed a debug assertion in row_upd_rec_in_place() for non-versioned ROW_FORMAT=REDUNDANT rows. (Bug #39165747)
+
+* Fixed an issue relating to table maintenance and clean-up. (Bug #39091376)
+
+* Fixed an issue relating to unique indexes. (Bug #38501299)
+
+Find the complete list of bug fixes and changes in the [MySQL 9.7.2 release notes](https://dev.mysql.com/doc/relnotes/mysql/9.7/en/news-9-7-2.html)
+
+
+## New features
+
+* [PS-10849](https://perconadev.atlassian.net/browse/PS-10849), [PS-10999](https://perconadev.atlassian.net/browse/PS-10999), [PS-11065](https://perconadev.atlassian.net/browse/PS-11065), [PS-11220](https://perconadev.atlassian.net/browse/PS-11120), and [PS-11316](https://perconadev.atlassian.net/browse/PS-11316): Percona Server for MySQL 9.7 now supports OpenID Connect (OIDC), allowing users to authenticate through compatible external identity providers. The server validates JWTs and audience claims, maps identity-provider groups to MySQL roles, and supports proxy users. The OIDC plugin also includes telemetry and memory instrumentation to improve monitoring and operational visibility. See [Connect OIDC](openid-connect-authentication.md).
+
+* [PS-11167](https://perconadev.atlassian.net/browse/PS-11167): Added SQL functions for calculating the distance between vector values. Applications can use these functions to measure vector similarity and support search, recommendation, and other vector-based workloads. See [`DISTANCE()`](distance-function.md)
+
+## Improvements
+
+* [PS-11120](https://perconadev.atlassian.net/browse/PS-11120): Reduced page-level mutex contention when many concurrent sessions perform range-select queries against the same InnoDB pages. This change improves throughput and reduces waits for workloads that repeatedly access hot data.
+
+* [PS-11216](https://perconadev.atlassian.net/browse/PS-11216): Group Replication communication debug traces now include timestamps. Administrators can more easily identify, sequence, and correlate events when troubleshooting large `GCS_DEBUG_TRACE` files.
+
+* [PS-11413](https://perconadev.atlassian.net/browse/PS-11413): Improved validation and logging for errors in JSON-based OIDC configuration files. Invalid configuration sections are no longer silently ignored, and the server log provides clearer information to help diagnose configuration problems.
+
+* [PS-11444](https://perconadev.atlassian.net/browse/PS-11444): Reduced the time that InnoDB holds the buffer pool LRU list mutex during physical page reads. This change decreases serialization and improves scalability for I/O-intensive workloads.
+
+* [PS-11445](https://perconadev.atlassian.net/browse/PS-11445): Restored a dedicated LRU manager thread for each buffer pool instance. Moving LRU flushing work away from page-cleaner threads improves buffer pool maintenance under heavy workloads.
+
+* [PS-11446](https://perconadev.atlassian.net/browse/PS-11446): Corrected an LRU boundary check that caused scans to restart unnecessarily. LRU scans now continue through eligible pages as intended, reducing repeated work and improving flushing efficiency.
+
+* [PS-11447](https://perconadev.atlassian.net/browse/PS-11447): Improved how InnoDB obtains free pages while an LRU batch flush is running. User threads can perform a controlled single-page flush when necessary and avoid repeated waits, improving responsiveness when the buffer pool is under pressure. New monitoring counters provide visibility into single-page flushes and LRU flush waits.
+
+## Bug Fixes
+
+* [PS-8822](https://perconadev.atlassian.net/browse/PS-8822): Fixed a performance regression affecting queries that use JOIN operations. The associated InnoDB optimizations reduce unnecessary processing and improve query performance.
+
+* [PS-11135](https://perconadev.atlassian.net/browse/PS-11135): Corrected a misleading error reported for invalid audit log filter definitions. The server now provides a more accurate message describing the configuration problem instead of incorrectly recommending a different event mode.
+
+* [PS-11143](https://perconadev.atlassian.net/browse/PS-11143): Fixed a server crash that could occur under connection-heavy workloads when the thread pool and certain Performance Schema instruments were enabled.
+
+* [PS-11182](https://perconadev.atlassian.net/browse/PS-11182): Starting a new `audit_log_read()` sequence now implicitly closes the previous sequence. Users no longer need to close each sequence manually before reading from another position.
+
+* [PS-11186](https://perconadev.atlassian.net/browse/PS-11186): The `audit_log_read()` function now honors the `max_array_length` setting when audit events use the JSON FULL or REDUCED format, ensuring that the returned result contains no more than the requested number of events.
+
+* [PS-11202](https://perconadev.atlassian.net/browse/PS-11202): The server now handles corrupted page-tracking files gracefully. It reports a warning and continues without the unavailable tracking information instead of exiting.
+
+* [PS-11209](https://perconadev.atlassian.net/browse/PS-11209): Fixed failures in concurrent Common Table Expression (CTE) queries that could incorrectly report error 1146 for missing internal temporary tables.
+
+* [PS-11217](https://perconadev.atlassian.net/browse/PS-11217): The Group Replication `GCS_DEBUG_TRACE` file can now be rotated and recreated without restarting Group Replication, simplifying extended debugging sessions.
+
+* [PS-11248](https://perconadev.atlassian.net/browse/PS-11248): Updated the documentation to clarify how externally assigned LDAP and OIDC roles are handled when group membership changes or authentication does not complete successfully.
+
+* [PS-11253](https://perconadev.atlassian.net/browse/PS-11253): Fixed a memory-safety issue in the external role-grant mechanism used by authentication plugins such as LDAP and OIDC. The server no longer accesses released memory while adding these roles to the privilege cache.
+
+* [PS-11273](https://perconadev.atlassian.net/browse/PS-11273): Fixed a secondary server crash that could occur while startup was being stopped because of an invalid authentication configuration. The server now reports the configuration error and exits cleanly.
+
+* [PS-11297](https://perconadev.atlassian.net/browse/PS-11297): Removed unnecessary record-offset validation from production builds, reducing InnoDB processing overhead and improving performance by up to 4.6% in tested Percona Server for MySQL 9.7 workloads.
+
+
+## Useful links
+
+Install [Percona Server for MySQL 9.7](https://docs.percona.com/percona-server/9.7/installation.html)
+
+Upgrade [Percona Server for MySQL](../upgrade.md)
+
+The [Percona Server for MySQL GitHub repository](https://github.com/percona/percona-server)
+
+Download product binaries, packages, and tarballs at [Percona Software Downloads](https://www.percona.com/downloads)
+
+[Contribute to the documentation](https://github.com/percona/psmysql-docs/blob/9.7/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 2843d55d00d..244b8cc6b5f 100644
--- a/docs/release-notes/release-notes-index.md
+++ b/docs/release-notes/release-notes-index.md
@@ -12,4 +12,6 @@ For help with using Percona Server for MySQL, visit the [Percona Community Forum
## Releases
+* [Percona Server for MySQL 9.7.2-2 (2026-09-28)](9.7.2-2.md)
+
* [Percona Server for MySQL 9.7.1-1 (2026-08-05)](9.7.1-1.md)
diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl
index 56f58cbf535..338e7c3740b 100644
--- a/docs/templates/pdf_cover_page.tpl
+++ b/docs/templates/pdf_cover_page.tpl
@@ -6,6 +6,6 @@
Percona Server for MySQL
{% if config.site_description %}
{{ config.site_description }}
-{% endif %}
-9.7.1-1 (August 5, 2026)
+{% endif %}
+9.7.2-2 (September 28, 2026)
diff --git a/mkdocs-base.yml b/mkdocs-base.yml
index d40456c20b4..41d4e648b5b 100644
--- a/mkdocs-base.yml
+++ b/mkdocs-base.yml
@@ -177,6 +177,7 @@ nav:
- ps-or-pdps.md
- Release notes:
- Release notes index: release-notes/release-notes-index.md
+ - release-notes/9.7.2-2.md
- release-notes/9.7.1-1.md
- Features:
- adaptive-network-buffers.md
diff --git a/variables.yml b/variables.yml
index 2cb56c2c197..383ba5274ee 100644
--- a/variables.yml
+++ b/variables.yml
@@ -1,11 +1,11 @@
# variables for HTML output
-release: '9.7.1-1'
+release: '9.7.2-2'
version: '9.7'
vers: '9.7' # we are going to use it instead of version
pkg: 'ps-97-lts'
-tag: '9.7.1' # used in quickstart documents
-arm_tag: '9.7.1-aarch64' # used in quickstart documents
+tag: '9.7.2' # used in quickstart documents
+arm_tag: '9.7.2-aarch64' # used in quickstart documents
year_tag: '2026' # used in quickstart documents
-release_date: '2026-08-05'
-title_date: '2026-08-05'
+release_date: '2026-09-28'
+title_date: '2026-09-28'