diff --git a/_resourcepdf/overrides/main.html b/_resourcepdf/overrides/main.html index 07a2b1d8..08629150 100644 --- a/_resourcepdf/overrides/main.html +++ b/_resourcepdf/overrides/main.html @@ -33,8 +33,8 @@ {% endblock %} {% block scripts %} + {{ super() }} -{{ super() }} {% endblock %} {% block extrahead %} diff --git a/docs/_images/percona-logomark-one-color-dark.png b/docs/_images/percona-logomark-one-color-dark.png new file mode 100644 index 00000000..28fbf02e Binary files /dev/null and b/docs/_images/percona-logomark-one-color-dark.png differ diff --git a/docs/css/kapa.css b/docs/css/kapa.css new file mode 100644 index 00000000..d2964b52 --- /dev/null +++ b/docs/css/kapa.css @@ -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; + } +} \ No newline at end of file diff --git a/docs/deployment-variants.md b/docs/deployment-variants.md index 794d5e5a..e5afe082 100644 --- a/docs/deployment-variants.md +++ b/docs/deployment-variants.md @@ -12,8 +12,6 @@ Percona Distribution for MySQL provides two deployment variants: one is Percona | MySQL Shell | YES | | MySQL Router | YES | - - !!! 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. diff --git a/docs/downgrade.md b/docs/downgrade.md index 4907b6c9..f44585b3 100644 --- a/docs/downgrade.md +++ b/docs/downgrade.md @@ -1,7 +1,5 @@ # Downgrade 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. diff --git a/docs/index.md b/docs/index.md index 8dc01d84..f861e2c9 100644 --- a/docs/index.md +++ b/docs/index.md @@ -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. - - !!! 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. diff --git a/docs/install-pdpxc.md b/docs/install-pdpxc.md index f30c61c8..2c70a2ff 100644 --- a/docs/install-pdpxc.md +++ b/docs/install-pdpxc.md @@ -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}} @@ -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: @@ -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}} @@ -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: diff --git a/docs/installing.md b/docs/installing.md index 94809060..6b468841 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -1,7 +1,5 @@ # Install Percona Distribution for MySQL - - !!! 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. @@ -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" diff --git a/docs/js/kapa.js b/docs/js/kapa.js new file mode 100644 index 00000000..b9ff889e --- /dev/null +++ b/docs/js/kapa.js @@ -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 = ` + ✨ + Ask Percona AI + `; + + // 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(); + }); +})(); \ No newline at end of file diff --git a/docs/legal-notice.md b/docs/legal-notice.md new file mode 100644 index 00000000..624be3ff --- /dev/null +++ b/docs/legal-notice.md @@ -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). \ No newline at end of file diff --git a/docs/minor-upgrade.md b/docs/minor-upgrade.md index 87757d54..3027e502 100644 --- a/docs/minor-upgrade.md +++ b/docs/minor-upgrade.md @@ -1,7 +1,5 @@ # Upgrade 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. @@ -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. diff --git a/docs/uninstalling.md b/docs/uninstalling.md index c525f58e..ef2b94d8 100644 --- a/docs/uninstalling.md +++ b/docs/uninstalling.md @@ -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 @@ -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 diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 60b69ce9..0f39e2f0 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -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: {} diff --git a/variables.yml b/variables.yml index cf5f8c7a..edce6e4a 100644 --- a/variables.yml +++ b/variables.yml @@ -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-'