Merge pull request #356 from percona/ps-9305

PS-9305 8.4.0-1 release notes and release note tasks

.github/workflows/main.yml

@@ -1,8 +1,8 @@
-name: Build Percona Server 8.3 docs
+name: Build Percona Server 8.4 docs
 on:
   push:
     branches: 
-      - innovation-release 
+      - 8.4 
 jobs:
   build:
     name: Deploy docs
@@ -44,9 +44,10 @@ jobs:
      # Deploy docs
       - name: Deploy docs
         run: |
-          mike deploy innovation-release -b publish -p
-          mike set-default innovation-release -b publish -p
-          mike retitle innovation-release "Innovation 8.3" -b publish -p
+          mike deploy 8.4 -b publish -p
+          mike set-default 8.4 -b publish -p
+          mike retitle 8.4 "8.4" -b publish -p
+          
 # - name: Install Node.js 14.x
 #        uses: percona-platform/setup-node@v2
 #        with:

docs/release-notes/8.4.0-1.md

@@ -0,0 +1,105 @@
+# Percona Server for MySQL 8.4.0-1 (2024-08-28)
+
+Get started with [Quickstart Guide for Percona Server for MySQL].
+
+[Percona Server for MySQL 8.4.0-1] includes all the features and bug fixes available in the
+MySQL 8.4 Community Edition in addition to enterprise-grade features developed by Percona.
+
+## Release highlights
+
+In MySQL 8.0, the release model changed to include new features in patch releases, allowing MySQL to introduce new features more frequently. However, this approach was complex for projects and applications needing only critical patches with minimal changes.
+
+MySQL then moved to a versioning model with two options: Innovation releases and Long-Term Support (LTS) releases. Both types are production-ready.
+
+Innovation releases offer access to the latest features, making them ideal for dynamic environments with strong automated testing and continuous integration.
+
+Changes were made to each Innovation release that are now included in the 8.4 (LTS) release. You should review the Innovation release notes for details.
+
+- [Percona Server for MySQL 8.1.0-1 (2023-11-27)](https://docs.percona.com/percona-server/innovation-release/release-notes/8.1.0-1.html)
+
+- [Percona Server for MySQL 8.2.0-1 (2024-02-05)](https://docs.percona.com/percona-server/innovation-release/release-notes/8.2.0-1.html)
+
+- [Percona Server for MySQL 8.3.0-1 (2024-04-16)](https://docs.percona.com/percona-server/innovation-release/release-notes/8.3.0-1.html)
+
+LTS releases are more suitable for stable, established environments where minimal changes are needed. These releases include only essential fixes, reducing the risk of changes in the database software’s behavior.
+
+This 8.4.0-1 release is the first 8.4 LTS series.
+
+Improvements and bug fixes introduced by Oracle for MySQL 8.4 and included in Percona Server for MySQL are the following:
+
+* The MySQL native password has been deprecated and is no longer loaded by default. However, it can be loaded if needed.
+
+* The clone plugin allows cloning between different point releases within the same series. You only must match the major and minor version numbers for cloning.
+
+* GTIDs (Global Transaction Identifiers) can now handle groups of transactions, which helps speed up processing.
+
+* `mysqldump` can now create output for older versions of MySQL.
+
+* Automatic updates for histograms. When enabled, the histogram updates automatically whenever `ANALYZE TABLE` is run on the table. InnoDB's automatic recalculation of persistent statistics also updates the histogram when automatic updates are enabled.
+
+* Adds a new privilege called FLUSH_PRIVILEGES. This privilege explicitly allows the use of FLUSH PRIVILEGES statements. Unlike the RELOAD privilege, FLUSH_PRIVILEGES only applies to FLUSH PRIVILEGES statements.
+
+* The terms "MASTER" and "SLAVE" in replication commands are being replaced with "SOURCE" and "REPLICA". This change is part of an ongoing effort to use more inclusive language.
+
+* Removed the the `mysqlpump` utility.
+
+* Removed the `mysql_upgrade` utility.
+
+* The default values for specific InnoDB server system variables have changed. See [What is new in MySQL 8.4 since 8.0](https://dev.mysql.com/doc/refman/8.4/en/mysql-nutshell.html) for details.
+
+Find the complete list of bug fixes and changes in the [MySQL 8.4 Release Notes].'
+
+## New features
+
+* [PS-9233](https://perconadev.atlassian.net/browse/PS-9233): Adds the [UUID_VX component](../uuid-versions.md) which provides a set of functions for generating and working with various versions of the Universally Unique Identifier (UUID).
+
+## Improvements
+
+* [PS-9302](https://perconadev.atlassian.net/browse/PS-9302): Changed underlying internal data structure used by the binlog transaction dependency tracking in `WRITESET` mode (MySQL 8.4 removed the `COMMIT_ORDER` mode). Instead of `std::map` (an RB-tree) we now use `std::unordered_map` (a hash) which gives much better performance for lookup operations. This change showed an up to 17% Queries per second (QPS) increase in the `oltp_inlist_update` workload.
+
+## Bug fixes
+
+* [PS-9092](https://perconadev.atlassian.net/browse/PS-9092): There were data inconsistencies during a high rate of page split/merge.
+
+* [PS-9121](https://perconadev.atlassian.net/browse/PS-9121): MySQL exited when InnoDB failed to update a spatial index.
+
+* [PS-9151](https://perconadev.atlassian.net/browse/PS-9151): Percona server 8.0 build failed on CentOS 7 with `-DWITH_SSL=openssl11`.
+
+* [PS-9219](https://perconadev.atlassian.net/browse/PS-9219): While converting the charset collation in a table, MySQL converted the date and time data types columns in the `.ibd` file. However, the `collation_id` in the `.ibd` file did not align with that of the data dictionary.
+
+* [PS-9155](https://perconadev.atlassian.net/browse/PS-9155): The server exited during the execution of the complicated query with 9 CTEs.
+
+* [PS-9235](https://perconadev.atlassian.net/browse/PS-9235): Keyring vault failed to work with `binlog_rotate_encryption_master_key_at_startup`.
+
+## Deprecation
+
+* [PS-8963](https://perconadev.atlassian.net/browse/PS-8963): The `SEQUENCE_TABLE()` function is deprecated and may be removed in a future release. We recommend that you use `PERCONA_SEQUENCE_TABLE()` instead. To maintain compatibility with existing third-party software, `SEQUENCE_TABLE` is no longer a reserved term and can be used as a regular identifier. Find more information in [PERCONA_SEQUENCE_TABLE(n) function](../percona-sequence-table.md)
+
+## Packaging notes
+
+Percona Server for MySQL 8.4.0-1 is compatible with Ubuntu 24.04.
+
+## Additional resources
+
+* Install [Percona Server for MySQL 8.4]
+
+* The [Percona Server for MySQL GitHub repository]
+
+* Download product binaries, packages, and tarballs at [Percona Software Downloads]
+
+* [Contribute to the documentation]
+
+* For [training], contact [Percona Training - Start learning now]
+
+[Quickstart Guide for Percona Server for MySQL]: ../quickstart-overview.md
+
+[Quickstart Guide for Percona Server for MySQL]: ../quickstart-overview.md
+[Percona Server for MySQL 8.4.0-1]: https://www.percona.com/software/mysql-database/percona-server
+[MySQL 8.4 Release Notes]: https://dev.mysql.com/doc/relnotes/mysql/8.4/en/news-8-4-0.html
+[Percona Server for MySQL 8.4]: https://docs.percona.com/percona-server/8.4/installation.html
+
+[Percona Server for MySQL GitHub repository]: https://github.com/percona/percona-server
+[Percona Software Downloads]: https://www.percona.com/downloads
+[Contribute to the documentation]: https://github.com/percona/psmysql-docs/blob/8.0/contributing.md
+[training]: https://www.percona.com/training
+[Percona Training - Start learning now]: https://learn.percona.com/contact-me

docs/release-notes/release-notes-index.md

@@ -1,6 +1,6 @@
 # Percona Server for MySQL {{vers}} release notes index
 
-* [Percona Server for MySQL 8.4.0-1 (2024-0-)](8.4.0-1.md)
+* [Percona Server for MySQL 8.4.0-1 (2024-08-28)](8.4.0-1.md)
 
 
 

mkdocs-base.yml

@@ -123,9 +123,9 @@ plugins:
 #      glob:
 #         - file.md
   with-pdf: # https://github.com/orzih/mkdocs-with-pdf
-          output_path: '_pdf/PerconaServer-8.2.pdf'
+          output_path: '_pdf/PerconaServer-8.4.pdf'
           cover_title: 'Percona Server Documentation'
-          cover_subtitle: 8.4.0-1 (2024-0-)
+          cover_subtitle: 8.4.0-1 (2024-08-28)
           author: 'Percona Technical Documentation Team'
           cover_logo: docs/_static/pdf-logo.png
           debug_html: false

variables.yml

@@ -4,6 +4,6 @@ release: '8.4.0-1'
 version: '8.4'
 vers: '8.4' # we are going to use it instead of version
 pkg: '84'
-release_date: '2024-0-'
-title_date: '2024-0-'
+release_date: '2024-08-28'
+title_date: '2024-08-28'