Merge pull request #198 from percona/psmysql-docs-5.7-8985

PS-8985 5.7.44-48 release notes and release note tasks (5.7)
percona · Dec 5, 2023 · c3c1327 · c3c1327
2 parents 8a77602 + 434b65a
commit c3c1327
Show file tree

Hide file tree

Showing 7 changed files with 68 additions and 69 deletions.
diff --git a/_resource/overrides/main.html b/_resource/overrides/main.html
@@ -71,7 +71,11 @@ <h4>Contact Us </h4>
                     {% include ".icons/material/file-eye-outline.svg" %}
                   </a>
                 {% endif %}
-
+                <label class="md-nav__title" for="__drawer">
+                  <a href="https://learn.percona.com/download-percona-server-5-7-manual" onclick="_gaq.push(['b._trackEvent', 'Percona Server', 'Download', 'Download Manual Percona Server']);" class="md-nav__link md-nav__link--active">
+                    Download PDF
+                  </a>
+                </label> 
                 <!--
                   Hack: check whether the content contains a h1 headline. If it
                   doesn't, the page title (or respectively site name) is used

diff --git a/_resource/overrides/partials/nav.html b/_resource/overrides/partials/nav.html
diff --git a/docs/diagnostics/libcoredumper.md b/docs/diagnostics/libcoredumper.md
@@ -1,29 +1,20 @@
-# Using libcoredumper
+# Using the libcoredumper
 
-
-* **Availability**
-
-    This feature is **tech preview** quality.
-
-
-This feature was implemented in *Percona Server for MySQL* 5.7.31-34 and has been tested against this version's supported operating systems.
+This feature was implemented in *Percona Server for MySQL* 5.7.31-34 and has been tested against the supported operating systems for that version.
 
 |Operating Systems|Versions|
 |--- |--- |
 |Debian|9, 10|
 |Red Hat Enterprise Linux and derivatives|6, 7, 8|
 |Ubuntu|16.04, 18.04, 20.04|
 
-
-The tool is experimental and may not be tested against newer operating systems in the future.
-
 The documented moment of a computer when either the computer or an application crashed is a core dump file. Developers examine the dump as one of the tasks when searching for the cause of a failure.
 
 The `libcoredumper` is a free and Open Source fork of `google-coredumper`, enhanced to work on newer Linux versions, and GCC and CLANG.
 
-You should test it before putting this tool into production.
+Test this tool in a safe environment before using in production.
 
-### Enabling the `libcoredumper`
+## Enable the libcoredumper
 
 Enable core dumps for troubleshooting purposes.
 
@@ -37,10 +28,9 @@ The variable can have the following possible values:
 |A path ending with `/`|The core dump is saved under the specified directory and named `core`.|
 |Full path with a filename|The core dump is saved under the specified directory and with the specified filename|
 
-
 Restart the server.
 
-### Verifying the `libcoredumper` is Active
+## Verify the tool is active
 
 MySQL writes to the log when generating a core file and delegates the core dump operation to the Linux kernel. An example of the log message is the following:
 
@@ -56,25 +46,21 @@ Writing a core file using lib coredumper
 
 Every core file adds a crash timestamp instead of a PID for the following reasons:
 
+* Correlates the core file with a crash. MySQL prints a UTC timestamp on the crash log.
 
-* Lets you correlate the core file with a crash. MySQL prints a UTC timestamp on the crash log.
-
-> ```text
-> 10:02:09 UTC - mysqld got signal 11;
-> ```
-
-
-* Lets you keep multiple core files.
+    > ```text
+    > 10:02:09 UTC - mysqld got signal 11;
+    > ```
 
-!!! note
+* Keeps multiple core files.
 
     For example, the operators and containers run as PID 1. If the process ID identified the core file, each container crash generates a core dump that overwrites the previous core file.
 
-### Disabling the libcoredumper
+### Disable the libcoredumper
 
 You can disable the libcoredumper. A core file may contain sensitive data and takes disk space.
 
-To disable the `libcoredumper` you must do the following:
+To disable the `libcoredumper`, do the following:
 
 1. In the `mysqld` section of my.cnf, remove the `libcoredumper` variable.
 

diff --git a/docs/release-notes/5.7.44-48.md b/docs/release-notes/5.7.44-48.md
@@ -0,0 +1,45 @@
+# Percona Server for MySQL 5.7.44-48 (2023-12-04)
+
+!!! important
+
+    Percona Server for MySQL 5.7.44-48 is the final release of the Percona Server for MySQL 5.7 series.
+
+    We recommend that you either [upgrade to MySQL 8.0 or stay on 5.7; we'll support you].
+
+[Percona Server for MySQL](https://www.percona.com/software/mysql-database/percona-server) 5.7.44-48
+includes all the features and bug fixes available in [MySQL 5.7.44 Community Edition](https://dev.mysql.com/doc/relnotes/mysql/5.7/en/news-5-7-44.html) in addition to enterprise-grade features developed by Percona.
+
+## Release highlights
+
+Percona Server for MySQL implements telemetry that fills the gaps in our understanding of how you use Percona Server to improve our products. Participation in the anonymous program is optional. You can opt out if you prefer not to share this information. Find more details in the [Telemetry on Percona Server for MySQL](../telemetry.md) document.
+
+Improvements and bug fixes provided by Oracle for MySQL 5.7.44 and included in Percona Server for MySQL are the following:
+
+* Upgraded the linked Open SSL library to OpenSSL 3.0.10
+* Removed the printed query string limit to display the characters for a detected deadlock section of the engine status log
+
+Find the complete list of additions or bug fixes in the [MySQL 5.7.44 Release Notes](https://dev.mysql.com/doc/relnotes/mysql/5.7/en/news-5-7-44.html).
+
+## Bug fixes
+
+* [PS-7806]: Working with tables with column compression broke asynchronous replication. Using column compression on the tables reduces the storage space and the memory usage of the data but also increases the CPU overhead and complexity. Asynchronous replication sends data from one node to another without waiting for acknowledgment, which improves performance and source availability but also risks data loss and inconsistency. With column compression, the replica must decompress the data in the columns, which can cause errors, delays, or conflicts.
+
+* [PS-8879]: A large table received an out-of-memory error when running `ALTER TABLE ... COLUMN_FORMAT COMPRESSED;` because the internal DDL copy operation consumed the available memory (thank you to minghuan zhao for your contribution).
+
+## Useful links
+
+[Install Percona Server for MySQL](https://www.percona.com/doc/percona-server/5.7/installation.html)
+
+The [Percona Server for MySQL GitHub repository](https://github.com/percona/percona-server)
+
+[Contribute to the documentation](https://github.com/percona/psmysql-docs/blob/8.0/contributing.md)
+
+Download product binaries, packages, and tarballs at [Percona Product Downloads](https://www.percona.com/downloads)
+
+For [training](https://www.percona.com/training), contact [Percona Training - Start learning now](https://learn.percona.com/contact-me)
+
+[PS-7806]: https://jira.percona.com/browse/PS-7806
+
+[PS-8879]: https://jira.percona.com/browse/PS-8879
+
+[upgrade to MySQL 8.0 or stay on 5.7; we'll support you]: https://www.percona.com/navigating-mysql-5-7-end-of-life
diff --git a/docs/release-notes/release-notes_index.md b/docs/release-notes/release-notes_index.md
@@ -1,5 +1,7 @@
 # Percona Server for MySQL 5.7 release notes index
 
+* [Percona Server for MySQL 5.7.44-48 (2023-12-04)](5.7.44-48.md)
+
 * [Percona Server for MySQL 5.7.43-47 (2023-08-17)](5.7.43-47.md)
 
 * [Percona Server for MySQL 5.7.42-46 (2023-06-01)](5.7.42-46.md)

diff --git a/mkdocs-base.yml b/mkdocs-base.yml
@@ -103,7 +103,7 @@ plugins:
   with-pdf: # https://github.com/orzih/mkdocs-with-pdf
           output_path: '_pdf/PerconaServer-5.7.pdf'
           cover_title: 'Percona Server Documentation'
-          cover_subtitle: 5.7.43-47 (2023-08-17)
+          cover_subtitle: 5.7.44-48 (2023-12-04)
           author: 'Percona Technical Documentation Team'
           cover_logo: docs/_static/Percona_Logo_Color.png
           debug_html: false
@@ -240,6 +240,7 @@ nav:
       - tokudb/removing_tokudb.md
   - Release notes:
       - Release notes index: release-notes/release-notes_index.md
+      - release-notes/5.7.44-48.md
       - release-notes/5.7.43-47.md
       - release-notes/5.7.42-46.md
       - release-notes/5.7.42-45.md

diff --git a/variables.yml b/variables.yml
@@ -1,5 +1,5 @@
 # variables for HTML output
 
-release: '5.7.43-47'
+release: '5.7.44-48'
 version: '5.7'
-release-date: August 17, 2023
+release-date: December 04, 2023