PS-9689 [Doc] Add docs for 8.0.41-32 PRO release (#474)

alina-derkach-oaza · web-flow · commit da7ab6d768d4 · 2025-02-27T12:32:09.000+01:00
new file:   docs/install-pro-amzn.md
	modified:   docs/install-pro.md
	modified:   docs/pro-files.md
	modified:   docs/psmysql-pro.md
	modified:   docs/yum-repo.md
	modified:   mkdocs-base.yml
	new file:   snippets/pro-build-announcement.md
diff --git a/docs/install-pro-amzn.md b/docs/install-pro-amzn.md
@@ -0,0 +1,44 @@
+# Install Percona Server for MySQL Pro on Amazon Linux 2023
+
+--8<--- "pro-build-announcement.md"
+
+This document provides guidelines how to install Pro packages of Percona Server for MySQL from Percona repositories. [Check files in packages built for Percona Server for MySQL Pro :material-arrow-right:](pro-files.md){.md-button}
+
+## Procedure
+
+!!! note 
+
+    Percona Server for MySQL 8.0.41-32 Pro build is available for the following platforms:
+
+    * Amazon Linux 2023 (AL2023) - We support both AMD64 and ARM64 versions of Amazon Linux 2023.
+
+1. Request the access to the pro repository from Percona Support. You will receive the client ID and the access token which you use when downloading the packages.
+
+
+2. Create the `/etc/yum.repos.d/psmysql-pro.repo` configuration file with the following contents with your [CLIENTID] and [TOKEN].
+
+    ```ini title="/etc/yum.repos.d/psmysql-pro.repo"
+    [ps-8.0-pro]
+    name=PS_8.0_PRO
+    baseurl=http://repo.percona.com/private/[CLIENTID]-[TOKEN]/ps-80-pro/yum/release/$releasever/RPMS/x86_64
+    enabled=1
+    gpgkey = https://repo.percona.com/yum/PERCONA-PACKAGING-KEY
+    ```
+
+3. Install Percona Server for MySQL packages
+        
+    ```{.bash .data-prompt="$"}
+    $ sudo yum install -y percona-server-server-pro
+    ```
+
+    Install other required packages. [Check files in packages built for Percona Server for MySQL Pro](pro-files.md).
+
+4. Start the server
+
+    ```{.bash .data-prompt="$"}
+    $ sudo systemctl start mysql
+    ```
+
+## Next step
+
+[Enable the FIPS mode :material-arrow-right:](fips.md){.md-button}
diff --git a/docs/install-pro.md b/docs/install-pro.md
@@ -1,13 +1,13 @@
 # Install Percona Server for MySQL Pro
 
-Percona Server for MySQL Pro includes the [capabilities](psmysql-pro.md#capabilities) that are typically requested by large enterprises. Percona Server for MySQL Pro contains packages created and tested by Percona. These packages are supported only for Percona Customers with a subscription.
-
-[Become a Percona Customer](https://www.percona.com/about/contact){.md-button}
+--8<--- "pro-build-announcement.md"
 
 Review [Get more help](get-help.md) for ways that we can work with you.
 
 This document provides guidelines how to install Pro packages of Percona Server for MySQL from Percona repositories. [Check files in packages built for Percona Server for MySQL Pro :material-arrow-right:](pro-files.md){.md-button}
 
+[Install Percona Server for MySQL Pro on Amazon Linux 2023 :material-arrow-right:](install-pro-amzn.md){.md-button}
+
 ## Procedure
 
 1. Request the access to the pro repository from Percona Support. You will receive the client ID and the access token which you use when downloading the packages.
@@ -68,7 +68,7 @@ This document provides guidelines how to install Pro packages of Percona Server
             $ sudo yum install -y percona-server-server-pro
             ```
 
-            Install other required packages. [Check files in the DEB package built for Percona Server for MySQL 8.0](apt-files.md).
+            Install other required packages. [Check files in the RPM package built for Percona Server for MySQL 8.0](yum-files.md).
 
 3. Start the server
 
diff --git a/docs/pro-files.md b/docs/pro-files.md
@@ -1,8 +1,6 @@
 # Files in packages built for Percona Server for MySQL Pro
 
-Percona Server for MySQL Pro includes the [capabilities](psmysql-pro.md#capabilities) that are typically requested by large enterprises. Percona Server for MySQL Pro contains packages created and tested by Percona. These packages are supported only for Percona Customers with a subscription.
-
-[Become a Percona Customer](https://www.percona.com/about/contact){.md-button}
+--8<--- "pro-build-announcement.md"
 
 ## Files in the DEB package
 
@@ -30,3 +28,8 @@ Percona Server for MySQL Pro includes the [capabilities](psmysql-pro.md#capabili
 | percona-server-pro-debuginfo | The debug symbols.                                                   |
 | percona-server-devel-pro     | Header files needed to compile software using the client library.    |
 
+## Next steps
+
+[Install Percona Server for MySQL Pro](install-pro.md){.md-button}
+
+[Install Percona Server for MySQL Pro on Amazon Linux 2023](install-pro-amzn.md){.md-button}
diff --git a/docs/psmysql-pro.md b/docs/psmysql-pro.md
@@ -1,15 +1,14 @@
 # Percona Server for MySQL Pro
 
-Percona Server for MySQL Pro includes the [capabilities](#capabilities) that are typically requested by large enterprises. Percona Server for MySQL Pro contains packages created and tested by Percona. These packages are supported only for Percona Customers with a subscription.
-
-[Become a Percona Customer](https://www.percona.com/about/contact){.md-button}
+--8<--- "pro-build-announcement.md"
 
 ## Capabilities
 
 Find the list of capabilities available in Percona Server for MySQL Pro:
 
 | Name                                | Version | Description  | 
 | ----------------------------------- | ------------- | -------------|
+| Install [Amazon Linux 2023](install-pro-amzn.md)| 8.0.41-32 | Install Percona Server for MySQL Pro on Amazon Linux 2023. We support both AMD64 and ARM64 versions of Amazon Linux 2023.|
 | [FIPS compliance](fips.md)| 8.0.40-31 | The FIPS feature has been tested on Percona Server for MySQL Pro 8.0.40-31. There are no changes to this release.|
 | [FIPS compliance](fips.md)| 8.0.39-30 | The FIPS feature has been tested on Percona Server for MySQL Pro 8.0.39-30. There are no changes to this release.|
 | [FIPS compliance](fips.md)| 8.0.37-29 | The FIPS feature has been tested on Percona Server for MySQL Pro 8.0.37-29. There are no changes to this release.|
@@ -23,8 +22,11 @@ Find the list of capabilities available in Percona Server for MySQL Pro:
 
 [Install Percona Server for MySQL Pro](install-pro.md){.md-button}
 
+[Install Percona XtraBackup Pro on Amazon Linux 2023](install-pro-amzn.md){.md-button}
+
 If you already use Percona Server for MySQL, you can
 
 [Upgrade to Percona Server for MySQL Pro](upgrade-pro.md){.md-button}
 
-Community users can receive all these capabilities by [building Percona Server for MySQL from the same source code](compile-percona-server.md).
+Community users can receive all these capabilities by [building Percona Server for MySQL from the same source code](compile-percona-server.md).
+
diff --git a/docs/yum-repo.md b/docs/yum-repo.md
@@ -3,26 +3,26 @@
 Ready-to-use packages are available from the Percona Server for MySQL software
 repositories and the [download page](https://www.percona.com/downloads). 
 
-The Percona YUM repository supports popular RPM-based
+The Percona yum repository supports popular RPM-based
 operating systems. The easiest way to install the Percona RPM repository is to install an RPM configuring yum and installing the [Percona GPG key](https://repo.percona.com/yum/PERCONA-PACKAGING-KEY).
 
 We gather [Telemetry data] in the Percona packages and Docker images.
 
 Review [Get more help](get-help.md) for ways that we can work with you.
 
-## Version changes
+### Version changes 
 
 Starting with Percona Server 8.0.33-25, the RPM builds for *RHEL* 8 and *RHEL* 9 contain ARM packages with the `aarch64.rpm` extension. This means that Percona Server for MySQL is available for users on ARM-based systems.
 
-## Supported platforms
+### Supported platforms
 
 Specific information on the supported platforms, products, and versions are described in [Percona Software and Platform Lifecycle](https://www.percona.com/services/policies/percona-software-platform-lifecycle#mysql).
 
-## Red Hat Certified
+### Red Hat Certified
 
 Percona Server for MySQL is certified for Red Hat Enterprise Linux 8. This certification is based on common and secure best practices and successful interoperability with the operating system. Percona Server is listed in the [Red Hat Ecosystem Catalog](https://catalog.redhat.com/software/applications/detail/112055).
 
-## Limitations
+### Limitations
 
 The RPM packages for Red Hat Enterprise Linux 7 and the compatible derivatives do not support TLSv1.3. This version requires OpenSSL 1.1.1, which is currently unavailable on this platform.
 
@@ -32,18 +32,17 @@ RHEL 8 and other EL8 systems enable the MySQL module by default. This module hid
 $ sudo yum module disable mysql
 ```
 
-If you are using the DNF package manager, you can disable the module using the following command:
+### Percona Server for MySQL PRO 
 
-```{.bash data-prompt="$"}
-$ sudo dnf module disable mysql
-```
+--8<--- "pro-build-announcement.md"
 
-## Install
+[Install Percona Server for MySQL Pro](install-pro.md){.md-button}
 
-Install from Percona Software Repository
-For more information on the Percona Software repositories and configuring Percona Repositories with `percona-release`, see the [Percona Software Repositories Documentation]. Run the following commands as a `root` user or with sudo.
+[Install Percona XtraBackup Pro on Amazon Linux 2023](install-pro-amzn.md){.md-button}
 
-DNF is the default package manager in RHEL 8 and newer versions, providing a more robust and efficient package management experience.
+## Install Percona Server for MySQL from Percona `yum` repository
+
+For more information on the Percona Software repositories and configuring Percona Repositories with `percona-release`, see the [Percona Software Repositories Documentation]. Run the following commands as a `root` user or with sudo.
 
 === "Install on Red Hat 7"
 
@@ -60,9 +59,9 @@ DNF is the default package manager in RHEL 8 and newer versions, providing a mor
      The first command uses `yum` to install the Percona repository from the Percona website. The second command uses the `percona-release` script to set up the `ps-80` release series of Percona Server. The third command installs Percona Server for MySQL.
 
     ```{.bash data-prompt="$"}
-    $ sudo dnf install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
+    $ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
     $ sudo percona-release setup ps-80
-    $ sudo dnf install percona-server-server
+    $ sudo yum install percona-server-server
     ```
 
 ## Available storage engines
@@ -75,7 +74,7 @@ For information on how to install and configure TokuDB, refer to the [TokuDB Ins
 
 For information on how to install and configure MyRocks, refer to the [Percona MyRocks Installation guide].
 
-### Percona YUM testing repository
+### Percona yum Testing repository
 
 Percona offers pre-release builds from our testing repository.
 
diff --git a/mkdocs-base.yml b/mkdocs-base.yml
@@ -144,7 +144,16 @@ extra:
 
 nav:
   - Home: index.md
-  - psmysql-pro.md
+  - Percona Server for MySQL PRO:
+    - psmysql-pro.md
+    - Install Percona Server for MySQL Pro:
+      - install-pro.md
+      - install-pro-amzn.md
+      - pro-files.md
+    - Pro build features:
+      - fips.md
+    - upgrade-pro.md
+    - downgrade-from-pro.md
   - get-help.md
   - Release notes:
     - Release notes index: release-notes/release-notes_index.md
@@ -212,14 +221,12 @@ nav:
         - binlog-space.md
         - extended-mysqlbinlog.md
         - extended-select-into-outfile.md
-        - fips.md
         - innodb-expanded-fast-index-creation.md
         - kill-idle-trx.md
         - percona-sequence-table.md
         - procfs-plugin.md
         - proxy-protocol-support.md
         - sequence-table.md
-
         - threadpool.md
         - trigger-updates.md
         - udf-percona-toolkit.md
@@ -228,7 +235,7 @@ nav:
        - quickstart-overview.md
        - quickstart-docker.md
        - quickstart-apt.md
-       - quickstart-dnf.md
+       - quickstart-yum.md
        - quickstart-next-steps.md
 
   - Install:
@@ -259,9 +266,6 @@ nav:
       - Docker:
         - Install using Docker: docker.md
         - docker-config.md
-      - Install Percona Server for MySQL Pro:
-        - install-pro.md
-        - pro-files.md
   - Upgrade:
       - upgrade.md
       - upgrade-plan.md
@@ -272,15 +276,14 @@ nav:
         - upgrade-changes-secure.md
         - upgrade-changes-deprecated.md
         - upgrade-changes-removed.md
-      - upgrade-pro.md
+      
       - upgrade-pt.md
       - in-place-upgrade-guide.md
       - upgrade-cutover.md
       - upgrade-percona-repos.md
       - upgrade-tokudb-myrocks.md
       - upgrade-standalone-packages.md
       - downgrade.md
-      - downgrade-from-pro.md
   - Post-Installation:
       - apparmor.md
       - binlogging-replication-improvements.md
diff --git a/snippets/pro-build-announcement.md b/snippets/pro-build-announcement.md
@@ -0,0 +1,3 @@
+Percona Server for MySQL Pro includes the [capabilities](psmysql-pro.md#capabilities) that are typically requested by large enterprises. Percona XtraBackup Pro contains packages created and tested by Percona. These packages are supported only for Percona Customers with a subscription.
+
+[Become a Percona Customer](https://www.percona.com/about/contact){.md-button}

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+Percona Server for MySQL Pro includes the [capabilities](psmysql-pro.md#capabilities) that are typically requested by large enterprises. Percona XtraBackup Pro contains packages created and tested by Percona. These packages are supported only for Percona Customers with a subscription.`
	`2`	`+`
	`3`	`+[Become a Percona Customer](https://www.percona.com/about/contact){.md-button}`