Skip to content

DISTMYSQL-575 [DOCS] Create new 9.7 branch based on 8.4 and update the docs (9.7) #258

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
alina-derkach-oaza merged 4 commits into from
Mar 11, 2026
Merged

DISTMYSQL-575 [DOCS] Create new 9.7 branch based on 8.4 and update the docs (9.7) #258

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
deabcf3
DISTMYSQL-575 [DOCS] Create new 9.7 branch based on 8.4 and update th…
alina-derkach-oaza Feb 16, 2026
ca4de93
Update pdf_cover_page.tpl
alina-derkach-oaza Mar 11, 2026
0c37a21
Update mkdocs-base.yml
alina-derkach-oaza Mar 11, 2026
025ce4b
Update mkdocs-base.yml
alina-derkach-oaza Mar 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 0 additions & 62 deletions .github/workflows/main.yml
View file
Open in desktop

This file was deleted.

2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Percona Distribution for MySQL provides two deployment variants: one is Percona
|MySQL Router |YES |NO |


This repository contains the source files for [Percona Distribution for MySQL documentation](https://www.percona.com/doc/percona-distribution-mysql/8.0/index.html). The documentation is written in [reStructured text markup language](https://docutils.sourceforge.io/rst.html) and is created using [Sphinx Python Documentation Generator](https://www.sphinx-doc.org/en/master/).
This repository contains the source files for [Percona Distribution for MySQL documentation](https://docs.percona.com/percona-distribution-for-mysql/8.0/). The documentation is written in [reStructured text markup language](https://docutils.sourceforge.io/rst.html) and is created using [Sphinx Python Documentation Generator](https://www.sphinx-doc.org/en/master/).

## Contributing

Expand Down
6 changes: 3 additions & 3 deletions _resource/overrides/main.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@
{% endif %}
<meta property="og:type" content="website" />
<meta property="og:title" content="{{ title }}" />
<meta property="og:url" content="https://docs.percona.com/percona-distribution-for-mysql/innovation-release/" />
<meta property="og:image" content="https://docs.percona.com/percona-distribution-for-mysql/innovation-release/_images/percona-mysql-logo.png" />
<meta property="og:url" content="https://docs.percona.com/percona-distribution-for-mysql/9.7/" />
<meta property="og:image" content="https://docs.percona.com/percona-distribution-for-mysql/9.7/_images/percona-mysql-logo.png" />
{% endblock %}

{% block site_nav %}
Expand All @@ -32,7 +32,7 @@
{% include "partials/nav.html" %}
<br>
<label class="md-nav__title" for="__drawer">
<a href="https://learn.percona.com/download-manual-percona-distribution-for-mysql-innovation-releases" onclick="_gaq.push(['b._trackEvent', 'Percona Distribution for MySQL', 'Download', 'Download Manual Distribution for MySQL']);" class="md-nav__link md-nav__link--active" style="font-size: .7rem;">
<a href="https://learn.percona.com/download-manual-percona-distribution-for-mysql-9.7" onclick="_gaq.push(['b._trackEvent', 'Percona Distribution for MySQL', 'Download', 'Download Manual Distribution for MySQL']);" class="md-nav__link md-nav__link--active" style="font-size: .7rem;">
Download PDF
</a>
</label>
Expand Down
2 changes: 1 addition & 1 deletion _resource/overrides/partials/banner.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@

<div class="actions">

<a href="https://docs.percona.com/percona-distribution-for-mysql/8.4/get-help.html" style="color: var(--md-typeset-a-color);">Get help from Percona</a>
<a href="https://docs.percona.com/percona-distribution-for-mysql/9.7/get-help.html" style="color: var(--md-typeset-a-color);">Get help from Percona</a>
</div>
</div>
2 changes: 1 addition & 1 deletion _resourcepdf/overrides/partials/banner.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@

<div class="actions">

<a href="https://docs.percona.com/percona-distribution-for-mysql/8.4/get-help.html" style="color: var(--md-typeset-a-color);">Get help from Percona</a>
<a href="https://docs.percona.com/percona-distribution-for-mysql/9.7/get-help.html" style="color: var(--md-typeset-a-color);">Get help from Percona</a>
</div>
</div>
2 changes: 1 addition & 1 deletion _resourcepdf/overrides/partials/edit.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
<div class="banner-divider"></div>

<!-- Contributing Guide below, smaller -->
<a href="https://github.com/percona/pdmysql-docs/blob/8.4/CONTRIBUTING.md"
<a href="https://github.com/percona/pdmysql-docs/blob/9.7/CONTRIBUTING.md"
title="Contributing guide"
class="contrib-link"
target="_blank"
Expand Down
10 changes: 6 additions & 4 deletions docs/components.md
View file
Open in desktop
Comment thread
alina-derkach-oaza marked this conversation as resolved.
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/{{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 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.
Comment thread
alina-derkach-oaza marked this conversation as resolved.

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

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

<!-- 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 8.4 becomes available.
This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available.

ProxySQL contains counters that have not been updated to use the new terminology. Unexpected results may occur. In an 8.4.x environment, the binlog reader errors out during initialization due to the use of old terminology, such as the SHOW MASTER STATUS command.
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.
6 changes: 4 additions & 2 deletions docs/deployment-variants.md
View file
Open in desktop
Comment thread
alina-derkach-oaza marked this conversation as resolved.
Comment thread
alina-derkach-oaza marked this conversation as resolved.
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,13 @@ Percona Distribution for MySQL provides two deployment variants: one is Percona
| MySQL Shell | YES |
| MySQL Router | YES |

<!-- 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 8.4 becomes available.
This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available.

ProxySQL contains counters that have not been updated to use the new terminology. Unexpected results may occur. In an 8.4.x environment, the binlog reader errors out during initialization due to the use of old terminology, such as the SHOW MASTER STATUS command.
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.

## What deployment variant to choose?

Expand Down
20 changes: 6 additions & 14 deletions docs/downgrade.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,14 +1,16 @@
# Downgrade Percona Distribution for MySQL

<!-- 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 8.4 becomes available.
This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available.

ProxySQL contains counters that have not been updated to use the new terminology. Unexpected results may occur. In an 8.4.x environment, the binlog reader errors out during initialization due to the use of old terminology, such as the SHOW MASTER STATUS command.
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.

You have the following downgrade options:

1. Within Same LTS Version (Example: 8.4.5 to 8.4.3):
1. Within Same LTS Version (Example: 9.7.3 to 9.7.1):

* Methods Available:

Expand All @@ -20,17 +22,7 @@ You have the following downgrade options:

* Replication-based downgrade

2. From LTS to Previous LTS (Example: 8.4.x to 8.0.y):

* Methods Available:

* Logical dump and restore

* Replication-based downgrade

* Important: Only works for rollback if you haven't used new features

3. From LTS to Innovation Release (Example: 8.4.x to 8.3.0):
2. From LTS to Previous LTS (Example: 9.7.x to 8.4.y):

* Methods Available:

Expand Down
2 changes: 1 addition & 1 deletion docs/download-instructions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Do the following steps to select the software, the software version, and downloa
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-8.4.4`.
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)`.

The `Package Download Options` may include both `AMD64` and `ARM64` packages. Select the correct CPU architecture for your system.
Expand Down
8 changes: 5 additions & 3 deletions docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Percona Distribution for MySQL {{vers}} Documentation

Percona Distribution for MySQL is a single solution with the best and most critical enterprise components from the MySQL open source community, designed and tested to work together. With [Percona Server for MySQL :octicons-link-external-16:](https://www.percona.com/software/mysql-database/percona-server) or [Percona XtraDB Cluster :octicons-link-external-16:](https://www.percona.com/software/mysql-database/percona-xtradb-cluster) as the base server, the distribution brings you the enterprise-grade [features](#features) for free. The set of carefully selected [components](components.md) helps you operate your MySQL database to meet your application and business needs.
Percona Distribution for MySQL is a single solution with the best and most critical enterprise components from the MySQL open source community, designed and tested to work together. With [Percona Server for MySQL :octicons-link-external-16:](https://www.percona.com/mysql/software/percona-server) or [Percona XtraDB Cluster :octicons-link-external-16:](https://www.percona.com/mysql/software/percona-xtradb-cluster) as the base server, the distribution brings you the enterprise-grade [features](#features) for free. The set of carefully selected [components](components.md) helps you operate your MySQL database to meet your application and business needs.
Copy link
Copy Markdown

@github-actions github-actions bot Mar 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [linkspector] reported by reviewdog 🐶
Cannot reach https://www.percona.com/mysql/software/percona-server. Status: 403

Copy link
Copy Markdown

@github-actions github-actions bot Mar 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [linkspector] reported by reviewdog 🐶
Cannot reach https://www.percona.com/mysql/software/percona-xtradb-cluster. Status: 403


## Features

Expand All @@ -14,11 +14,13 @@ Percona Distribution for MySQL is a single solution with the best and most criti

Percona Distribution for MySQL comes in two [deployment variants](deployment-variants.md): one is based on Percona Server for MySQL and another one - on Percona XtraDB Cluster. They differ in the set of components and how you can use them.

<!-- 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 8.4 becomes available.
This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available.

ProxySQL contains counters that have not been updated to use the new terminology. Unexpected results may occur. In an 8.4.x environment, the binlog reader errors out during initialization due to the use of old terminology, such as the SHOW MASTER STATUS command.
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.

<div data-grid markdown><div data-banner markdown>

Expand Down
4 changes: 2 additions & 2 deletions docs/install-pdps.md
View file
Open in desktop
Comment thread
alina-derkach-oaza marked this conversation as resolved.
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,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:
Expand Down Expand Up @@ -125,7 +125,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 Orchestrator
Expand Down
10 changes: 5 additions & 5 deletions docs/install-pdpxc.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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/{{vers}}/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/8.4/telemetry.html) in the Percona packages and Docker images.

## Prerequisites

Expand Down Expand Up @@ -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 `8.4.2` repository:
To enable either the `pdpxc-9.7.0` or `pdpxc-9.7.2` version repository, use the following command. The example enables the `{{minorpkgpxc}}` repository:

```shell
sudo percona-release setup {{minorpkgpxc}}
Expand All @@ -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:
Expand All @@ -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 `8.4.2` repository:
To enable either the `pdpxc-9.7.0` or `pdpxc-9.7.2` version repository, use the following command. The example enables the `{{minorpkgpxc}}` repository:

```shell
sudo percona-release setup {{minorpkgpxc}}
Expand All @@ -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:
Expand Down
Loading
Loading