Merge pull request #417 from percona/ps-9528

PS-9528 [DOC] - add a disclaimer that percona-release does not work w…

Author: patrickbirch

docs/apt-repo.md

@@ -13,6 +13,8 @@ The DEB builds for Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04, DEBIAN 11, and DEBI
 
 ## Install Percona Server for MySQL using APT
 
+--8<--- "percona-release.md"
+
 To install Percona Server for MySQL using APT, do the following steps:
 {.power-number}
 

docs/installation.md

@@ -6,6 +6,8 @@ We gather [Telemetry data] in the Percona packages and Docker images.
 
 ## Install Percona Server for MySQL from Repositories
 
+--8<--- "percona-release.md"
+
 Percona provides repositories for yum (`RPM` packages for Red Hat, CentOS and Amazon Linux AMI) and apt (`.deb` packages for Ubuntu and Debian) for software such as Percona Server for MySQL, Percona XtraBackup, and Percona Toolkit. This makes it easy to install and update your software and its dependencies through your operating system’s package manager. This is the recommended way of installing where possible.
 
 The following guides describe the installation process for using the official Percona repositories for the `.deb` and `.rpm` packages.

docs/upgrade.md

@@ -52,10 +52,4 @@ Review other [Percona blogs](https://www.percona.com/blog/) that contain upgrade
 
 ## Limitations
 
-An upgrade on Ubuntu 20.04 from the following releases does not restart the MySQL service automatically. You must start the service manually.
-
-* Percona Server for MySQL 8.0.x to Percona Server for MySQL 8.1
-
-* Percona Server for MySQL 8.0.x to Percona Server for MySQL 8.2
-
-* Percona Server for MySQL 8.1 to Percona Server for MySQL 8.2
+--8<--- "percona-release.md"

docs/yum-repo.md

@@ -22,6 +22,8 @@ The RPM builds for *RHEL* 8 and *RHEL* 9 contain ARM packages with the `aarch64.
 
 ## Install
 
+--8<--- "percona-release.md"
+
 To install using the Percona Software repository, run the following commands either as a `root` user or, as in the example, using `sudo`.
 
     ```{.bash data-prompt="$"}

snippets/percona-release.md

@@ -0,0 +1,3 @@
+**The `percona-release` tool currently shows an Unknown alias specification error when you use `ps-84-lts`. The next release of the percona-release tool will fix this error.**
+
+**In the meantime, use your platform’s version of the APT or YUM package management tools instead.**