Skip to content
5 changes: 4 additions & 1 deletion docs/.linkspector.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,7 @@ ignorePatterns:
- pattern: "#mysql_alerts$"
- pattern: "#postgresql_alerts$"
- pattern: "#proxysql_alerts$"


replacementPatterns:
- pattern: "\\{\\{vers\\}\\}"
replacement: "9.7"
6 changes: 2 additions & 4 deletions docs/components.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Comment thread
alina-derkach-oaza marked this conversation as resolved.

* [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.
Comment thread
alina-derkach-oaza marked this conversation as resolved.

* [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.

Expand All @@ -21,8 +21,6 @@ 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.

<!-- Clarify whether the following note is valid for 9.7-->

!!! 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.
Expand Down
2 changes: 1 addition & 1 deletion docs/downgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
29 changes: 19 additions & 10 deletions docs/download-instructions.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,24 @@
# Percona Software Download Instructions
# Percona Software Download instructions

Do the following steps to select the software, the software version, and download the packages:
## Select the software

1. Go to [Percona Software Downloads :octicons-link-external-16:](https://www.percona.com/downloads).
2. Locate Percona Distribution for MySQL.
3. Select the required product in `Select Product`, for example, Percona Server for MySQL.
4. Select your distribution version in the `Select Product Version` dropdown, for example, `percona-distribution-mysql-ps-9.7.1`.
5. Select your platform in the `Select Platform` dropdown, for example, `Ubuntu 24.04 (Noble Numbat)`.
Do the following steps to select the software:

The `Package Download Options` may include both `AMD64` and `ARM64` packages. Select the correct CPU architecture for your system.
1. Open [Percona Software Downloads :octicons-link-external-16:](https://www.percona.com/downloads).
2. Select a product, for example, Percona Distribution for MySQL.
3. In `Product Group`, select which product, for example, Percona Server for MySQL.
4. In `Version`, select your distribution version, for example, `percona-distribution-mysql-ps-{{vers}}`.
5. In `Platform`, select the operating system, for example, `Ubuntu 24.04 (Noble Numbat)`.

You can download specific packages one by one or download all packages using the `DOWNLOAD ALL PACKAGES` button. The easiest method is to download all packages.
The `Package Download Options` may mix `amd64` and `arm64` packages. Select the correct CPU architecture for your system.

## Download to a local computer

In `Package Download Options`, select a specific package and click `Download`. This action downloads the selected packages to the local computer.

## Download to another computer

In `Package Download Options`, select a specific package and right-click on the `DOWNLOAD`, and in the drop-down menu, choose `Copy Link Address`

Paste the link in your terminal to download the selected package.

The packages are downloaded to the local computer.
2 changes: 2 additions & 0 deletions docs/installing.md
Original file line number Diff line number Diff line change
@@ -1,6 +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.

Expand Down
85 changes: 85 additions & 0 deletions docs/release-notes-ps-9.7.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
# 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).

!!! 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.
Comment thread
alina-derkach-oaza marked this conversation as resolved.

## 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.
Comment thread
alina-derkach-oaza marked this conversation as resolved.

### 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.
Comment thread
alina-derkach-oaza marked this conversation as resolved.

* 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 |
| ------------------- | --------- | -------------------------------------------|
| 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|
5 changes: 1 addition & 4 deletions docs/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -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-08-05)](release-notes-ps-9.7.1.md)

## Percona Distribution for MySQL using Percona XtraDB Cluster

*
2 changes: 1 addition & 1 deletion docs/templates/pdf_cover_page.tpl
Original file line number Diff line number Diff line change
Expand Up @@ -7,5 +7,5 @@
{% if config.site_description %}
<h1>{{ config.site_description }}</h1>
{% endif %}
<h2>9.7 (April, 2026)</h2>
<h2>9.7.1 (August 05, 2026)</h2>
<!--<h3>Percona Technical Documentation Team</h3>-->
2 changes: 2 additions & 0 deletions docs/uninstalling.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,6 +121,7 @@ To uninstall Percona Distribution for MySQL, stop the `mysql` service and remove
sudo yum remove percona-mysql-router
```

<!--
=== "Uninstall Percona XtraDB Cluster-based variant"

!!! important
Expand Down Expand Up @@ -188,3 +189,4 @@ To uninstall Percona Distribution for MySQL, stop the `mysql` service and remove
```shell
sudo yum remove percona-toolkit
```
-->
13 changes: 7 additions & 6 deletions mkdocs-base.yml
Original file line number Diff line number Diff line change
Expand Up @@ -176,26 +176,27 @@ 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
- 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:
- Technical overview: pdps-group-replication.md
- 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
Expand Down
6 changes: 3 additions & 3 deletions variables.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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'
Loading