diff --git a/docs/release-notes/5.7.44-31.65.3.md b/docs/release-notes/5.7.44-31.65.3.md new file mode 100644 index 00000000..558bb427 --- /dev/null +++ b/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 \ No newline at end of file diff --git a/docs/release-notes/release-notes_index.md b/docs/release-notes/release-notes_index.md index b1ce2e1c..614959a2 100644 --- a/docs/release-notes/release-notes_index.md +++ b/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) diff --git a/docs/upgrade-third-party-lib.md b/docs/upgrade-third-party-lib.md new file mode 100644 index 00000000..8ce57ef5 --- /dev/null +++ b/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. \ No newline at end of file diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 87aec512..984e31df 100644 --- a/mkdocs-base.yml +++ b/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 diff --git a/variables.yml b/variables.yml index aaaec993..aa4dde72 100644 --- a/variables.yml +++ b/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' \ No newline at end of file