Merge pull request #162 from percona/pxc-4458

PXC-4458 Percona XtraDB Cluster 5.7.44-31.65.3 release and release no…

docs/release-notes/5.7.44-31.65.3.md

@@ -0,0 +1,88 @@
+# Percona XtraDB Cluster 5.7.44-31.65.3 (2024-07-23)
+
+This release is part of {{post}}. The fixes are available to [MySQL 5.7 Post-EOL Support from Percona customers].
+
+We recommend upgrading to MySQL 8.0 or staying on 5.7; we'll support you.
+
+## Release Information
+
+Percona XtraDB Cluster 5.7.44-31.65.3 contains the following fixes and addresses two third-party CVEs.
+
+## Bug fixes
+
+* [Bug#36248967]: `mysqldump` sometimes failed to identify the version number correctly.
+
+* [Bug#35904044]: The server sometimes sent incorrect metadata to the client for specific queries.
+
+* [Bug#35846221]: An error occurred because the `Item_func_make_set::fix_after_pullout()` function was missing. This makes the `MAKE_SET` function appear constant (const), causing it to be evaluated too early during the process (resolving). We fixed this by implementing the missing `fix_after_pullout()` function.
+
+* [Bug#35854362]: Queries that used a group by loose index scan sometimes returned inaccurate results.
+
+* [Bug#36093405]: Implemented better management of GTID sets in Group Replication.
+
+* [Bug#35277407]: Transactions stopped unexpectedly. This bug occurred when the system encountered an incorrect value stored in the `trx->in_innodb` variable.
+
+* [Bug#36317795]: Ensured that calling the `plugin->deinit` function resulted in the same behavior for all plugins. All plugins follow a consistent process when being unloaded or shut down.
+
+* [Bug#36343647]: Addressed buffer handling during the tablespace deletion process. This issue could have caused the program to halt with an assertion failure in the past.
+
+* [Bug#34929814]: The Full-Text Search (FTS) system encountered issues maintaining consistency when multiple operations happened simultaneously (concurrent scenarios).
+
+* [PS-9092]: A high rate of page splits and merges in the past caused data inconsistencies.
+
+* [PS-9132]: After an unexpected server exit, persistent information about executed Global Transaction Identifiers (GTIDs) was lost during the `Gtid_state::save` operation.
+
+## Third-party fixes
+
+The following Common Vulnerabilities and Exposures (CVE) records have been identified in third-party libraries:
+
+| CVE            | Affected versions                                                |
+|----------------|------------------------------------------------------------------|
+| [CVE-2023-6129]  | OpenSSL versions 1.1.1 and 1.0.2 do not have this issue. If using OpenSSL 3.x.y, upgrade to 3.0.13, 3.1.5, or 3.2.1. |
+| [CVE-2024-0853]  | Version 8.5.0 is affected. Other versions are not. |
+
+We recommend that you [upgrade third-party libraries] to the latest version. 
+
+The operating system may port these fixes into the default version of the libraries installed in the systems.
+
+## Useful links
+
+[Install Percona XtraDB Cluster](https://www.percona.com/doc/percona-xtradb-cluster/5.7/install/index.html)
+
+[Percona XtraDB Cluster GitHub repository](https://github.com/percona/percona-xtradb-cluster)
+
+[Contribute to the documentation](https://github.com/percona/pxc-docs/blob/8.0/contributing.md)
+
+For [training](https://www.percona.com/training), contact [Percona Training - Start learning now](https://learn.percona.com/contact-me)
+
+[MySQL 5.7 Post-EOL Support from Percona customers]: https://www.percona.com/post-mysql-5-7-eol-support
+
+[build this release from the source]: ../installation/git-source-tree.md
+
+[Bug#36248967]: https://github.com/mysql/mysql-server/commit/f351ea92a5a
+
+[Bug#35904044]: https://github.com/mysql/mysql-server/commit/271dcf231d0
+
+[Bug#35846221]: https://github.com/mysql/mysql-server/commit/3cd7cd2066f
+
+[Bug#35854362]: https://github.com/mysql/mysql-server/commit/c7e824d18f7
+
+[Bug#36093405]: https://github.com/mysql/mysql-server/commit/6467f70f615
+
+[Bug#35277407]: https://github.com/mysql/mysql-server/commit/88b0ebafdf6
+
+[Bug#36317795]: https://github.com/mysql/mysql-server/commit/ce036717cb5
+
+[Bug#36343647]: https://github.com/mysql/mysql-server/commit/5d06230ae2a
+
+[Bug#34929814]: https://github.com/mysql/mysql-server/commit/c94f9d873b1
+
+[PS-9092]: https://perconadev.atlassian.net/browse/PS-9092
+
+[PS-9132]: https://perconadev.atlassian.net/browse/PS-9132
+
+[CVE-2024-0853]: https://curl.se/docs/CVE-2024-0853.html
+
+[CVE-2023-6129]: https://www.openssl.org/news/vulnerabilities.html#CVE-2023-6129
+
+[upgrade third-party libraries]: ../upgrade-third-party-lib.md

docs/release-notes/release-notes_index.md

@@ -1,5 +1,7 @@
 # Percona XtraDB Cluster 5.7 Release notes index
 
+* [Percona XtraDB Cluster 5.7.44-31.65.3 (2024-07-23)](5.7.44-31.65.3.md)
+
 * [Percona XtraDB Cluster 5.7.44-31.65.2 (2024-05-02)](5.7.44-31.65.2.md)
 
 * [Percona XtraDB Cluster 5.7.44-31.65 (2023-12-26)](5.7.44-31.65.md)

docs/upgrade-third-party-lib.md

@@ -0,0 +1,55 @@
+# Upgrade third-party libraries
+
+The following are generic instructions for updating libraries using a package manager. Your environment may differ. Upgrading libraries can have unintended consequences. Test the upgrade on a staging environment before upgrading production.
+
+## Prepare
+
+These steps apply to any package manager. The example updates the OpenSSL library.
+{.power-number}
+
+1. Create a full server backup to ensure data integrity in case of issues.
+2. Identify the library and review the installation method.
+3. Research the compatibility between the new library and your current MySQL version.
+4. Stop the server.
+
+## Upgrade
+
+=== "Distributions using the APT package manager"
+
+    Install the update:
+
+    ```{.bash data-prompt="$"}
+    $ sudo apt update
+    $ sudo apt install libssl-dev openssl
+    ```
+
+=== "Distributions using the YUM package manager"
+
+    Install the update:
+
+    ```{.bash data-prompt="$"}
+    $ sudo yum update
+    $ sudo yum install openssl
+    ```
+
+## Verify
+
+After the upgrade, do the following:
+{.power-number}
+
+1. Restart the server to ensure the library is loaded correctly.
+
+    ```{.bash data-prompt="$"}
+    $ sudo systemctl restart mysql
+    ```
+
+2. Connect to the server and verify the update with either `SHOW PLUGINS;` or `SHOW VARIABLES LIKE '%library_name%';`.
+
+3. Test the library functionality by running scripts or applications that rely on the upgraded library.
+
+## Troubleshoot
+
+If you find issues:
+
+* Check the error logs.
+* Consult the documentation for the library and online resources for any troubleshooting steps specific to this library. Look for any potential compatibility issues.

mkdocs-base.yml

@@ -101,7 +101,7 @@ plugins:
   with-pdf: # https://github.com/orzih/mkdocs-with-pdf
           output_path: '_pdf/PerconaXtradbCluster-5.7.pdf'
           cover_title: 'Percona XtraDB Cluster Documentation'
-          cover_subtitle: 5.7.44-31.65.2 (2024-05-02)
+          cover_subtitle: 5.7.44-31.65.3 (2024-07-23)
           author: 'Percona Technical Documentation Team'
           cover_logo: docs/_static/Percona_Logo_Color.png
           debug_html: false
@@ -123,6 +123,7 @@ nav:
   - Home: index.md
   - Release notes:
       - release-notes/release-notes_index.md
+      - release-notes/5.7.44-31.65.3.md
       - release-notes/5.7.44-31.65.2.md
       - release-notes/5.7.44-31.65.md
       - release-notes/5.7.43-31.65.md
@@ -179,6 +180,7 @@ nav:
       - bootstrap.md
       - add-node.md
       - verify.md
+      - upgrade-third-party-lib.md
   - Features:
       - features/highavailability.md
       - features/multimaster-replication.md

variables.yml

@@ -1,7 +1,7 @@
 # variables for HTML output
 
-release: '5.7.44-31.65.2'
+release: '5.7.44-31.65.3'
 version: '5.7'
-release-date: 2024-05-02
+release-date: 2024-07-23
 post: 'MySQL 5.7 Post-EOL Support from Percona'
 repo-post: 'ps-post-eol'