Skip to content

Commit fdf88b3

Browse files
patrickbirchpatrickbirch
authored
Merge pull request #356 from percona/ps-9305
PS-9305 8.4.0-1 release notes and release note tasks
2 parents 8c1fd5d + 3888e64 commit fdf88b3

File tree

5 files changed

+116
-10
lines changed

5 files changed

+116
-10
lines changed

‎.github/workflows/main.yml

+6-5
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
name: Build Percona Server 8.3 docs
1+
name: Build Percona Server 8.4 docs
22
on:
33
push:
44
branches:
5-
- innovation-release
5+
- 8.4
66
jobs:
77
build:
88
name: Deploy docs
@@ -44,9 +44,10 @@ jobs:
4444
# Deploy docs
4545
- name: Deploy docs
4646
run: |
47-
mike deploy innovation-release -b publish -p
48-
mike set-default innovation-release -b publish -p
49-
mike retitle innovation-release "Innovation 8.3" -b publish -p
47+
mike deploy 8.4 -b publish -p
48+
mike set-default 8.4 -b publish -p
49+
mike retitle 8.4 "8.4" -b publish -p
50+
5051
# - name: Install Node.js 14.x
5152
# uses: percona-platform/setup-node@v2
5253
# with:

‎docs/release-notes/8.4.0-1.md

+105
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
# Percona Server for MySQL 8.4.0-1 (2024-08-28)
2+
3+
Get started with [Quickstart Guide for Percona Server for MySQL].
4+
5+
[Percona Server for MySQL 8.4.0-1] includes all the features and bug fixes available in the
6+
MySQL 8.4 Community Edition in addition to enterprise-grade features developed by Percona.
7+
8+
## Release highlights
9+
10+
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.
11+
12+
MySQL then moved to a versioning model with two options: Innovation releases and Long-Term Support (LTS) releases. Both types are production-ready.
13+
14+
Innovation releases offer access to the latest features, making them ideal for dynamic environments with strong automated testing and continuous integration.
15+
16+
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.
17+
18+
- [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)
19+
20+
- [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)
21+
22+
- [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)
23+
24+
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.
25+
26+
This 8.4.0-1 release is the first 8.4 LTS series.
27+
28+
Improvements and bug fixes introduced by Oracle for MySQL 8.4 and included in Percona Server for MySQL are the following:
29+
30+
* The MySQL native password has been deprecated and is no longer loaded by default. However, it can be loaded if needed.
31+
32+
* 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.
33+
34+
* GTIDs (Global Transaction Identifiers) can now handle groups of transactions, which helps speed up processing.
35+
36+
* `mysqldump` can now create output for older versions of MySQL.
37+
38+
* 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.
39+
40+
* 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.
41+
42+
* 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.
43+
44+
* Removed the the `mysqlpump` utility.
45+
46+
* Removed the `mysql_upgrade` utility.
47+
48+
* 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.
49+
50+
Find the complete list of bug fixes and changes in the [MySQL 8.4 Release Notes].'
51+
52+
## New features
53+
54+
* [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).
55+
56+
## Improvements
57+
58+
* [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.
59+
60+
## Bug fixes
61+
62+
* [PS-9092](https://perconadev.atlassian.net/browse/PS-9092): There were data inconsistencies during a high rate of page split/merge.
63+
64+
* [PS-9121](https://perconadev.atlassian.net/browse/PS-9121): MySQL exited when InnoDB failed to update a spatial index.
65+
66+
* [PS-9151](https://perconadev.atlassian.net/browse/PS-9151): Percona server 8.0 build failed on CentOS 7 with `-DWITH_SSL=openssl11`.
67+
68+
* [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.
69+
70+
* [PS-9155](https://perconadev.atlassian.net/browse/PS-9155): The server exited during the execution of the complicated query with 9 CTEs.
71+
72+
* [PS-9235](https://perconadev.atlassian.net/browse/PS-9235): Keyring vault failed to work with `binlog_rotate_encryption_master_key_at_startup`.
73+
74+
## Deprecation
75+
76+
* [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)
77+
78+
## Packaging notes
79+
80+
Percona Server for MySQL 8.4.0-1 is compatible with Ubuntu 24.04.
81+
82+
## Additional resources
83+
84+
* Install [Percona Server for MySQL 8.4]
85+
86+
* The [Percona Server for MySQL GitHub repository]
87+
88+
* Download product binaries, packages, and tarballs at [Percona Software Downloads]
89+
90+
* [Contribute to the documentation]
91+
92+
* For [training], contact [Percona Training - Start learning now]
93+
94+
[Quickstart Guide for Percona Server for MySQL]: ../quickstart-overview.md
95+
96+
[Quickstart Guide for Percona Server for MySQL]: ../quickstart-overview.md
97+
[Percona Server for MySQL 8.4.0-1]: https://www.percona.com/software/mysql-database/percona-server
98+
[MySQL 8.4 Release Notes]: https://dev.mysql.com/doc/relnotes/mysql/8.4/en/news-8-4-0.html
99+
[Percona Server for MySQL 8.4]: https://docs.percona.com/percona-server/8.4/installation.html
100+
101+
[Percona Server for MySQL GitHub repository]: https://github.com/percona/percona-server
102+
[Percona Software Downloads]: https://www.percona.com/downloads
103+
[Contribute to the documentation]: https://github.com/percona/psmysql-docs/blob/8.0/contributing.md
104+
[training]: https://www.percona.com/training
105+
[Percona Training - Start learning now]: https://learn.percona.com/contact-me

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

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Percona Server for MySQL {{vers}} release notes index
22

3-
* [Percona Server for MySQL 8.4.0-1 (2024-0-)](8.4.0-1.md)
3+
* [Percona Server for MySQL 8.4.0-1 (2024-08-28)](8.4.0-1.md)
44

55

66

‎mkdocs-base.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -123,9 +123,9 @@ plugins:
123123
# glob:
124124
# - file.md
125125
with-pdf: # https://github.com/orzih/mkdocs-with-pdf
126-
output_path: '_pdf/PerconaServer-8.2.pdf'
126+
output_path: '_pdf/PerconaServer-8.4.pdf'
127127
cover_title: 'Percona Server Documentation'
128-
cover_subtitle: 8.4.0-1 (2024-0-)
128+
cover_subtitle: 8.4.0-1 (2024-08-28)
129129
author: 'Percona Technical Documentation Team'
130130
cover_logo: docs/_static/pdf-logo.png
131131
debug_html: false

‎variables.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,6 @@ release: '8.4.0-1'
44
version: '8.4'
55
vers: '8.4' # we are going to use it instead of version
66
pkg: '84'
7-
release_date: '2024-0-'
8-
title_date: '2024-0-'
7+
release_date: '2024-08-28'
8+
title_date: '2024-08-28'
99

0 commit comments

Comments
 (0)