Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion _resourcepdf/overrides/main.html
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,8 @@
{% endblock %}

{% block scripts %}
{{ super() }}
<script src="https://cmp.osano.com/Azqe5vTyLOSbN3OuT/49ad85b5-0418-4794-ab81-7599dddd534c/osano.js"></script>
{{ super() }}
{% endblock %}

{% block extrahead %}
Expand Down
Binary file added docs/_images/percona-logomark-one-color-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
64 changes: 64 additions & 0 deletions docs/css/kapa.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
button#ask-percona-ai {
display: inline-flex;
align-items: center;
justify-content: center;

gap: 0.45rem;

/* Match MkDocs Material search field */
height: 1.8rem;
padding: 0 0.9rem;
margin-left: 0.5rem;

border: none;
border-radius: 0.1rem;

background: #AB4213;
color: #E7C8BB;

box-shadow: var(--md-shadow-z1);

cursor: pointer;

font-family: inherit;
font-size: 0.8rem;
font-weight: 400;
line-height: 1;

white-space: nowrap;

transition:
background-color 0.25s ease,
box-shadow 0.25s ease;
}

button#ask-percona-ai:hover {
background: #EB6F3B;
}

button#ask-percona-ai:focus-visible {
outline: none;
box-shadow:
0 0 0 0.1rem rgba(235, 111, 59, 0.35),
var(--md-shadow-z2);
}

button#ask-percona-ai .percona-star,
button#ask-percona-ai .percona-text {
color: inherit;
}

button#ask-percona-ai .percona-star {
font-size: 0.85rem;
line-height: 1;
}

@media screen and (max-width: 768px) {
button#ask-percona-ai {
padding: 0 0.75rem;
}

button#ask-percona-ai .percona-text {
display: none;
}
}
2 changes: 0 additions & 2 deletions docs/deployment-variants.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,6 @@ 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 {{vers}} becomes available.
Expand Down
2 changes: 0 additions & 2 deletions docs/downgrade.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# 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 {{vers}} becomes available.
Expand Down
2 changes: 0 additions & 2 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,6 @@ 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 {{vers}} becomes available.
Expand Down
8 changes: 4 additions & 4 deletions docs/install-pdpxc.md
Original file line number Diff line number Diff line change
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-9.7.0` or `pdpxc-9.7.2` version repository, use the following command. The example enables the `{{minorpkgpxc}}` repository:
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:

```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-97
sudo apt install percona-xtrabackup-84
```

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-9.7.0` or `pdpxc-9.7.2` version repository, use the following command. The example enables the `{{minorpkgpxc}}` repository:
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:

```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-97
sudo yum install percona-xtrabackup-84
```

Install Percona Toolkit:
Expand Down
4 changes: 1 addition & 3 deletions docs/installing.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# Install Percona Distribution for MySQL

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

!!! 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.
Expand All @@ -11,7 +9,7 @@ We recommend to install Percona Distribution for MySQL from Percona repositories
* `APT` - for Debian and Ubuntu Linux
* `YUM` or `DNF` - for Red Hat Enterprise Linux and compatible Linux derivatives

Find the full list of supported platforms on the [Percona Software and Platform Lifecycle :octicons-link-external-16:](https://www.percona.com/services/policies/percona-software-support-lifecycle#mysql) page.
Find the full list of supported platforms on the [Percona Software and Platform Lifecycle :octicons-link-external-16:](https://www.percona.com/release-lifecycle-overview/#mysql) page.

??? admonition "Repository overview: Major and Minor repositories"

Expand Down
98 changes: 98 additions & 0 deletions docs/js/kapa.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
(function () {
function createAIButton() {
if (document.getElementById("ask-percona-ai")) {
return;
}

const search = document.querySelector(".md-search");

if (!search || !search.parentNode) {
return;
}

const button = document.createElement("button");

button.id = "ask-percona-ai";
button.type = "button";

button.innerHTML = `
<span class="percona-star">✨</span>
<span class="percona-text">Ask Percona AI</span>
`;

// Place button AFTER search component
search.parentNode.insertBefore(button, search.nextSibling);
}

function loadKapa() {
// Prevent duplicate loading
if (document.getElementById("kapa-widget-script")) {
return;
}

const script = document.createElement("script");

script.id = "kapa-widget-script";

script.src = "https://widget.kapa.ai/kapa-widget.bundle.js";

script.async = true;

// REQUIRED CONFIG
script.setAttribute(
"data-website-id",
"0e0d55cf-6370-4a6d-a987-96670a7fe935"
);

script.setAttribute(
"data-modal-override-open-selector",
"#ask-percona-ai"
);

script.setAttribute(
"data-button-hide",
"true"
);

script.setAttribute(
"data-project-name",
"Percona"
);

script.setAttribute(
"data-modal-title",
"Percona AI Assistant"
);

script.setAttribute(
"font-size",
"0.875rem"
);

// MODAL CONTENT
script.setAttribute(
"data-modal-disclaimer",
"The **Percona AI Assistant** helps you find simple, clear answers to your Percona questions using [official documentation](https://docs.percona.com/), resolved [forum posts](https://forums.percona.com/) and [blog posts](https://www.percona.com/blog/). Note, do not enter personal or confidential information. Before using Percona AI assistant, read the [Legal Notice](https://docs.percona.com/percona-distribution-for-mysql/9.7/legal-notice.html)."
);

script.setAttribute(
"data-modal-example-questions",
"How do I select a deployment variant?, How do I install Percona Distribution for MySQL?, How do I achive high availability?, How do I use the Percona Distribution for MySQL components?"
);

script.setAttribute(
"data-project-logo",
"https://docs.percona.com/percona-distribution-for-mysql/9.7/_images/percona-logomark-one-color-dark.png"
);

document.head.appendChild(script);
}

createAIButton();
loadKapa();

document.addEventListener("navigation.instant", () => {
createAIButton();
loadKapa();
});
})();
3 changes: 3 additions & 0 deletions docs/legal-notice.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Legal Notice

You are interacting with an AI-powered chatbot that provides automated responses for general information about our IT services and software. Responses may be inaccurate or incomplete and do not constitute professional or contractual advice. Do not submit personal data, confidential information, credentials, or other sensitive information through this chat. Conversations may be logged and processed to improve our services in accordance with our [Privacy Policy](https://www.percona.com/privacy-policy#h.c033wws8ytgb) and applicable laws, including the GDPR. If you require assistance, please contact a [human representative](https://www.percona.com/about/contact).
4 changes: 1 addition & 3 deletions docs/minor-upgrade.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# Upgrade 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 {{vers}} becomes available.
Expand Down Expand Up @@ -84,6 +82,6 @@ To upgrade Percona Distribution for MySQL, [install the `percona-release` reposi

!!! admonition "See also"

[Upgrading Percona XtraDB Cluster :octicons-link-external-16:](https://docs.percona.com/percona-xtradb-cluster/{{vers}}/upgrade-guide.html)
[Upgrading Percona XtraDB Cluster :octicons-link-external-16:](https://docs.percona.com/percona-xtradb-cluster/8.4/upgrade-guide.html)

To upgrade the components, refer to [Installing Percona Distribution for MySQL](installing.md) for installation instructions relevant to your operating system.
4 changes: 2 additions & 2 deletions docs/uninstalling.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,7 +148,7 @@ To uninstall Percona Distribution for MySQL, stop the `mysql` service and remove
* Remove Percona XtraBackup

```shell
sudo apt remove percona-xtrabackup-97
sudo apt remove percona-xtrabackup-84
```

* Remove Percona Toolkit
Expand Down Expand Up @@ -180,7 +180,7 @@ To uninstall Percona Distribution for MySQL, stop the `mysql` service and remove
* Remove Percona XtraBackup

```shell
sudo yum remove percona-xtrabackup-97
sudo yum remove percona-xtrabackup-84
```

* Remove Percona Toolkit
Expand Down
2 changes: 2 additions & 0 deletions mkdocs-base.yml
Original file line number Diff line number Diff line change
Expand Up @@ -72,12 +72,14 @@ extra_css:
- css/nocopy.css
- css/mysql.css
- css/rating.css
- css/kapa.css

extra_javascript:
- js/version-select.js
- js/promptremover.js
- js/consent.js
- js/rating.js
- js/kapa.js

markdown_extensions:
attr_list: {}
Expand Down
10 changes: 5 additions & 5 deletions variables.yml
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# variables for HTML output

release: '9.7.0'
release: '9.7.1'
version: '9.7'
psvers: '9.7.0-0'
psvers: '9.7.1-1'
vers: '9.7'
majorpkg: 'pdps-97-lts'
minorpkg: 'pdps-9.7.0'
majorpkgpxc: 'pdpxc-97-lts'
minorpkgpxc: 'pdpxc-9.7.0'
minorpkg: 'pdps-9.7.1'
majorpkgpxc: 'pdpxc-84-lts'
minorpkgpxc: 'pdpxc-8.4.8'
release_date: '2026-0-'
title_date: '2026-0-'
Loading