PS-9098 Release notes for 5.7 EOL update 5.7.44-49 (#276)

On branch ps-9098
	new file:   docs/release-notes/5.7.44-49.md
	modified:   docs/release-notes/release-notes_index.md
	modified:   mkdocs-base.yml
	modified:   variables.yml

Co-authored-by: Alina Derkach <[email protected]>

Author: patrickbirch

docs/index.md

@@ -9,8 +9,30 @@ Percona Server for MySQL is a freely available, fully compatible, enhanced, and
 
 Percona Server for MySQL is trusted by thousands of enterprises to provide better performance and concurrency for their most demanding workloads.
 
+## {{post}}
+
+Leverage [{{post}}](https://www.percona.com/navigating-mysql-5-7-end-of-life) to ensure continued security and performance for your MySQL applications. While this service provides critical bug fixes and security patches, consider migrating to the next major version to unlock a wider range of benefits:
+
+* Enhanced performance and scalability: Gain access to performance improvements and better handle growing data volumes.
+
+* Improved security features: Benefit from the latest security advancements to safeguard your data more effectively.
+
+* Access to the latest features and functionality: Utilize the newest features and functionalities to improve your database management experience.
+
+### Releases
+
+* [Percona Server for MySQL 5.7.44-49](release-notes/5.7.44-49.md)
+
+### Installation links 
+
+* [Install {{post}} releases](installation/install-eol.md)
+
+* [Download {{post}} releases from binary tarballs](./installation/binary-tarball.md)
+
+
 ## For Monitoring and Management
 
 Percona Monitoring and Management (PMM )monitors and provides actionable performance data for MySQL variants, including Percona Server for MySQL, Percona XtraDB Cluster, Oracle MySQL Community Edition, Oracle MySQL Enterprise Edition, and MariaDB. PMM captures metrics and data for the InnoDB, XtraDB, and MyRocks storage engines, and has specialized dashboards for specific engine details.
 
-[Install PMM and connect your server instances to it.](https://docs.percona.com/percona-monitoring-and-management/get-started/index.html)
+[Install PMM and connect your server instances to it.](https://docs.percona.com/percona-monitoring-and-management/get-started/index.html)
+

docs/installation.md

@@ -14,6 +14,8 @@ Following guides describe the installation process for using the official Percon
 
 * [Installing Percona Server for MySQL on Red Hat Enterprise Linux and CentOS](installation/yum_repo.md)
 
+* [Installing {{post}} releases](installation/install-eol.md)
+
 
 ## Building *Percona Server for MySQL* Debian/Ubuntu packages
 

docs/installation/binary-tarball.md

@@ -1,36 +1,59 @@
-# Installing _Percona Server for MySQL_ 5.7 from a Binary Tarball
+# Installing Percona Server for MySQL 5.7 from a Binary Tarball
 
 !!! note
 
-    The following instructions install Percona Server for MySQL 5.7. 
+    The following instructions install Percona Server for MySQL 5.7.
     The instructions to install [Percona Server for MySQL 8.0 are available at this location](https://docs.percona.com/percona-server/latest/installation.html#installing-percona-server-from-a-binary-tarball).
 
-In _Percona Server for MySQL_ 5.7.31-34 and later, the multiple binary 
+## Download a {{post}} binary tarball
+
+You can download the binary tarball for Percona Server for MySQL release in the {{post}} program using your `CLIENTID` and `TOKEN`.
+
+| Type    | Name                                                                |Description         |
+|---------|---------------------------------------------------------------------|--------------------|
+| Full    | Percona-Server-<release>/private/[CLIENTID]-[TOKEN]/Percona-Server-5.7/Percona-Server-<release>/binary/tarball/Percona-Server-<release>-Linux.x86_64.glibc2.17.tar.gz   | Contains binaries, libraries, test files, and debug symbols   |
+| Minimal | Percona-Server-<release>/private/[CLIENTID]-[TOKEN]/Percona-Server-5.7/Percona-Server-<release>-Linux.x86_64.glibc2.12-minimal.tar.gz | Contains binaries, and libraries but does not include test files, or debug symbols. |
+
+Fetch and extract the correct binary tarball using your `CLIENTID` and `TOKEN`. For example, for Oracle Linux 9, use the following command:
+
+```{.bash data-prompt="$"}
+ $ wget https://repo.percona.com/private/[CLIENTID-[TOKEN]/Percona-Server-5.7/Percona-Server-{{release}}/binary/tarball/Percona-Server-{{release}}-Linux.x86_64.glibc2.17.tar.gz 
+```
+
+## Types and names of binary tarballs
+
+In _Percona Server for MySQL_ 5.7.31-34 and later, the multiple binary
 tarballs are replaced with the following:
 
 | Type    | Name                                                                |Description         |
 |---------|---------------------------------------------------------------------|--------------------|
-| Full    | Percona-Server-<version number>-Linux.x86_64.glibc2.12.tar.gz  | Contains binaries, libraries, test files, and debug symbols   |
-| Minimal | Percona-Server-<version number>-Linux.x86_64.glibc2.12-minimal.tar.gz | Contains binaries, and libraries but does not include test files, or debug symbols. |
+| Full    | Percona-Server-&lt;version number&gt;-Linux.x86_64.glibc2.12.tar.gz  | Contains binaries, libraries, test files, and debug symbols   |
+| Minimal | Percona-Server-&lt;version number&gt;-Linux.x86_64.glibc2.12-minimal.tar.gz | Contains binaries, and libraries but does not include test files, or debug symbols. |
 
-Select the _Percona Server for MySQL_ 5.7 version number and type of tarball for your installation. Both binary tarballs support all distributions.
+Select the Percona Server for MySQL 5.7 version number and type of tarball for 
+your installation. Both binary tarballs support all distributions.
 
-In _Percona Server for MySQL_ before 5.7.31-34, multiple tarballs are provided based on the _OpenSSL_ library available in the distribution:
+In Percona Server for MySQL before 5.7.31-34, multiple tarballs are provided 
+based on the OpenSSL library available in the distribution:
+
+*   ssl100 - for Debian prior to 9 and Ubuntu prior to 14.04 versions (`libssl.so.1.0.0 => /usr/lib/x86_64-linux-gnu/libssl.so.1.0.0`);
 
-*   ssl100 - for _Debian_ prior to 9 and _Ubuntu_ prior to 14.04 versions (`libssl.so.1.0.0 => /usr/lib/x86_64-linux-gnu/libssl.so.1.0.0`);
-    
 *   ssl101 - for _CentOS_ 6 and _CentOS_ 7 (`libssl.so.10 => /usr/lib64/libssl.so.10`);
-     
+
 *   ssl102 - for _Debian_ 9 and _Ubuntu_ versions starting from 14.04 (`libssl.so.1.1 => /usr/lib/libssl.so.1.1`);
-    
-*   ssl1:111 - for _CentOS_ 8 and _RedHat_ 8 (`libssl.so.1.1 => /usr/lib64/libssl.so.1.1.1b`);    
 
-You can download the binary tarballs from the [`Linux - Generic` 
-section](https://www.percona.com/downloads/Percona-Server-5.7/LATEST/binary/tarball/) on the download page.
+*   ssl1:111 - for _CentOS_ 8 and _RedHat_ 8 (`libssl.so.1.1 => /usr/lib64/libssl.so.1.1.1b`);
 
-Fetch the correct binary tarball. The example fetches Percona Server 
+You can download the binary tarballs from the [`Linux - Generic`
+section](https://www.percona.com/downloads) on the download page. See [download instructions](download-instructions.md)
+
+Fetch the correct binary tarball. The example fetches Percona Server
 for MySQL 5.7.38-41 for Debian 10:
 
 ```shell
 $ wget https://downloads.percona.com/downloads/Percona-Server-5.7/Percona-Server-5.7.38-41/binary/debian/buster/x86_64/Percona-Server-5.7.38-41-rda46e5474f9-buster-x86_64-bundle.tar
-```
+```
+
+
+
+

docs/installation/docker.md

@@ -1,10 +1,64 @@
-# Running Percona Server for MySQL 5.7 in a Docker Container
+# Run Percona Server for MySQL 5.7 in a Docker Container
 
 !!! note
 
     The following instructions run Percona Server for MySQL 5.7 in a Docker container. 
     The instructions on how to run [Percona Server for MySQL 8.0 in a Docker container are available at this location](https://docs.percona.com/percona-server/latest/installation/docker.html).
 
+## {{post}} Docker containers
+
+To use {{post}} in a Docker container, you must request access to the {{post}} repository from Percona Support. This request provides you with the client ID and the access token. The Docker image is stored in a binary tarball. 
+
+Download the tar file.
+
+```{.bash data-prompt="$"}
+$ sudo docker load -i percona-server-5.7.44-49-1.docker.tar
+```
+
+Provide a password before the download begins.
+
+After the download, check the Docker images:
+
+```{.bash data-prompt="$"}
+$ sudo docker images
+```
+
+??? example "Expected output"
+
+    ```{.text .no-copy}
+    Repository              TAG            IMAGE ID       CREATED       SIZE
+    percona/percona-server  5.7           (image number) (when created) (size of file)
+    percona/percona-server  5.7.44 
+    percona/percona-server  5.7.44-49
+    percona/percona-server  5.7.44-49.1
+    ```
+
+Run the image in a container in detached mode with the following command:
+
+```{.bash data-prompt="$"}
+sudo docker run -d --name ps57 -t percona/percona-server:5.7 bash
+```
+
+Access the detached mode container with the following command:
+
+```{.bash data-prompt="$"}
+$ sudo docker exec -it ps57 /bin/bash
+```
+
+In the container, verify the version.
+
+```{.bash data-prompt="$"}
+$ mysql -V
+```
+
+??? example "Expected output"
+
+    ```{.text .no-copy}
+    mysql Ver 14.14 Distrib 5.7.44-49, for Linux (x86_64) using 7.0
+    ```
+
+## Docker images for versions that are not {{post}}
+
 Docker images of Percona Server are hosted publicly on Docker Hub at
 [https://hub.docker.com/r/percona/percona-server/](https://hub.docker.com/r/percona/percona-server/).
 
@@ -31,8 +85,8 @@ To start a container named `ps`
 running the latest version in the Percona Server 5.7 series,
 with the root password set to `root`:
 
-```
-[root@docker-host] $ docker run -d \
+```{.bash data-prompt="$"}
+$ docker run -d \
   --name ps \
   -e MYSQL_ROOT_PASSWORD=root \
   percona/percona-server:5.7
@@ -52,13 +106,13 @@ with the root password set to `root`:
 
 To access the shell in the container:
 
-```shell
+```{.bash data-prompt="$"}
 [root@docker-host] $ docker exec -it ps /bin/bash
 ```
 
 From the shell, you can view the error log:
 
-```text
+```{.text .no-copy}
 [mysql@ps] $ more /var/log/mysql/error.log
 2017-08-29T04:20:22.190474Z 0 [Warning] 'NO_ZERO_DATE', 'NO_ZERO_IN_DATE' and 'ERROR_FOR_DIVISION_BY_ZERO' sql modes should be used with strict mode. They will be merged with strict mode in a future release.
 2017-08-29T04:20:22.190520Z 0 [Warning] 'NO_AUTO_CREATE_USER' sql mode was not set.
@@ -68,13 +122,13 @@ From the shell, you can view the error log:
 You can also run the MySQL command-line client
 to access the database directly:
 
-```shell
+```{.bash data-prompt="$"}
 [mysql@ps] $ mysql -uroot -proot
 ```
 
 The output may be similar to the following:
 
-```text
+```{.text .no-copy}
 mysql: [Warning] Using a password on the command line interface can be insecure.
 Welcome to the MySQL monitor.  Commands end with ; or \g.
 Your MySQL connection id is 4
@@ -100,25 +154,24 @@ To link a container running your application
 with the Percona Server container,
 run it with the following command:
 
-```shell
+```{.bash data-prompt="$"}
 [root@docker-host] $ docker run -d \
   --name app \
   --link ps \
   app/image:latest
 ```
 
-This application container will be able to access the Percona Server container
+This application container can access the Percona Server container
 via port 3306.
 
 ## Environment Variables
 
 When running a Docker container with Percona Server,
-you can adjust the configuration of the instance
-by passing one or more environment variables with the `docker run` command.
+you can adjust the instance's configuration by passing one or more environment variables with the `docker run` command.
 
 !!! note
 
-    These variables will not have any effect if you start the container with a data directory that already contains a database: any pre-existing database will always remain untouched on container startup.
+    If you start the container with a data directory containing a database, these variables are not effective. Any pre-existing database will always remain untouched on container startup.
 
 The variables are optional, except that you must specify at least one of the following:
 
@@ -142,24 +195,22 @@ that run in Docker containers:
 
 * Let Docker manage the storage of your data
 by writing the database files to disk on the host system
-using its own internal volume management.
+using its internal volume management.
 
 * Create a data directory on the host system
-(outside the container on high performance storage)
+(outside the container on high-performance storage)
 and mount it to a directory visible from inside the container.
-This places the database files in a known location on the host system,
-and makes it easy for tools and applications on the host system
+This directory places the database files in a known location on the host system and makes it easy for tools and applications on the host system
 to access the files.
-The user should make sure that the directory exists,
-and that permissions and other security mechanisms on the host system
+The user should ensure that the directory exists and that permissions and other security mechanisms on the host system
 are set up correctly.
 
 For example, if you create a data directory on a suitable volume
 on your host system named `/local/datadir`,
 you run the container with the following command:
 
-```shell
-[root@docker-host] $ docker run -d \
+```{.bash data-prompt="$"}
+$ docker run -d \
   --name ps \
   -e MYSQL_ROOT_PASSWORD=root \
   -v /local/datadir:/var/lib/mysql \
@@ -177,10 +228,10 @@ which is the default data directory used by Percona Server.
 
 !!! note
 
-    If you have SELinux enabled, assign the relevant policy type to the new data directory, so that the container will be allowed to access it:
+    If you have SELinux enabled, assign the relevant policy type to the new data directory so that the container will be allowed to access it:
 
-    ```shell
-    [root@docker-host] $ chcon -Rt svirt_sandbox_file_t /local/datadir
+    ```{.bash data-prompt="$"}
+    $ sudo chcon -Rt svirt_sandbox_file_t /local/datadir
     ```
 
 ## Port Forwarding
@@ -190,11 +241,11 @@ using the `-p` option.
 If you run the container with this option,
 you can connect to the database by connecting your client
 to a port on the host machine.
-This can greatly simplify consolidating many instances to a single host.
+This can significantly simplify consolidating many instances to a single host.
 
 To map the standard MySQL port 3306 to port 6603 on the host:
 
-```shell
+```{.bash data-prompt="$"}
 [root@docker-host] $ docker run -d \
  --name ps \
  -e MYSQL_ROOT_PASSWORD=root \
@@ -204,19 +255,18 @@ To map the standard MySQL port 3306 to port 6603 on the host:
 
 ## Passing Options to Percona Server
 
-You can pass options to Percona Server when running the container
-by appending them to the `docker run` command.
+You can pass options to the Percona Server by appending them to the `docker run` command when running the container.
 For example, to start run Percona Server with UTF-8
 as the default setting for character set
 and collation for all databases:
 
-```shell
-[root@docker-host] $ docker run -d \
+```{.bash data-prompt="$"}
+$ docker run -d \
  --name ps \
  -e MYSQL_ROOT_PASSWORD=root \
  percona/percona-server:5.7 \
  --character-set-server=utf8 \
  --collation-server=utf8_general_ci
 ```
 
-[Telemetry data]: ../telemetry.md
+[Telemetry data]: ../telemetry.md

docs/installation/download-instructions.md

@@ -0,0 +1,25 @@
+# Percona Product Download Instructions
+
+## Select the software
+
+Do the following steps to select the software:
+
+1. Open [Percona Product Downloads](https://www.percona.com/downloads)
+2. Locate the Percona Server for MySQL section.
+3. In `Select Product`, select the Percona Server version. 
+4. In `Select Product Version`, select the version, for example, PERCONA-SERVER-{{release}}
+5. In `Select Software`, select the operating system, for example, RED HAT ENTERPRISE LINUX / CENTOS/ ORACLE LINUX 9
+
+The easiest method is to download all packages.
+
+## Download to a local computer
+
+ In`Package Download Options`, select a specific package or select the `DOWNLOAD ALL PACKAGES` button
+
+The selected packages are downloaded to the local computer.
+
+## Download to another computer
+
+In `Package Download Options`, select a specific package or select the `DOWNLOAD ALL PACKAGES` button, and hover your cursor over the `DOWNLOAD` arrow. Right-click, and in the drop-down menu, select `Copy Link`.
+
+Paste the link in your terminal to download the selected package.