DISTMYSQL-389 Release notes for Percona Distribution for MySQL 8.2 (P…

…S) (#140) * DISTMYSQL-389 Release notes for Percona Distribution for MySQL 8.2 (PS) modified: .github/workflows/main.yml new file: docs/release-notes-ps-8.2.md modified: docs/release-notes.md modified: mkdocs-base.yml modified: variables.yml * Update release-notes-ps-8.2.md * Update release-notes-ps-8.2.md * Update release-notes-ps-8.2.md * Update release-notes-ps-8.2.md * Update release-notes.md * Update mkdocs-base.yml * Update variables.yml * Update services-banner.md (#142) --------- Co-authored-by: Patrick Birch <[email protected]>
percona · Feb 6, 2024 · a44d645 · a44d645
1 parent 01cb4ad
commit a44d645
Show file tree

Hide file tree

Showing 5 changed files with 90 additions and 11 deletions.
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -1,4 +1,4 @@
-name: Build Percona Distribution for MySQL 8.1 docs
+name: Build Percona Distribution for MySQL 8.2 docs
 on:
   push:
     branches: 
@@ -46,7 +46,7 @@ jobs:
         run: |
           mike deploy innovation-release  -b publish -p
           mike set-default innovation-release -b publish -p
-          mike retitle innovation-release "8.1 (LATEST)" -b publish -p
+          mike retitle innovation-release "8.2 (LATEST)" -b publish -p
 # - name: Install Node.js 14.x
 #        uses: percona-platform/setup-node@v2
 #        with:

diff --git a/docs/release-notes-ps-8.2.md b/docs/release-notes-ps-8.2.md
@@ -0,0 +1,76 @@
+# Percona Distribution for MySQL 8.2.0 using Percona Server for MySQL (2024-02-06)
+
+Percona Distribution for MySQL is the most stable, scalable, and secure open source MySQL distribution based on Percona Server for MySQL. [Install Percona Distribution for MySQL](installing.md).
+
+This release is based on [Percona Server for MySQL 8.2.0-1].
+
+## Release highlights
+
+This release merges the MySQL 8.2 code base. Withing this merge Percona introduces several sagnificant changes:
+
+* Removes remainders of Percona-specific encryption features (support for custom Percona 5.7 encrypted bilnog format.)
+
+* Removes the deprecated `rocksdb_strict_collation_check` and `rocksdb_strict_collation_exceptions` RocksDB system variables.
+
+Improvements and bug fixes introduced by Oracle for MySQL 8.2 and included in Percona Server for MySQL are the following:
+
+* The insert operations caused `records_in_range` to read too many disk blocks.
+
+* System schema tables with INSTANT ADD columns created before 8.0.29 are incompatible with MySQL versions higher than 8.0.29. Performing DMLs on these tables causes an unexpected server exit.
+
+* A FTS parser plugin now handles single character tokens correctly.
+
+## Known issues
+
+* [PS-9078](https://perconadev.atlassian.net/browse/PS-9078): An upgrade on Ubuntu 20.04 from the following releases does not restart the MySQL service automatically. You must start the service manually.
+
+    * Percona Server for MySQL 8.0.x to Percona Server for MySQL 8.1
+
+    * Percona Server for MySQL 8.0.x to Percona Server for MySQL 8.2
+
+    * Percona Server for MySQL 8.1 to Percona Server for MySQL 8.2
+
+## Deprecation or removal
+
+A future release may remove deprecated variables and options. The usage of these deprecated items may cause a warning. We recommend migrating from deprecated variables and options as soon as possible.
+
+This release deprecates the following variables and options:
+
+* The `binlog_transaction_dependency_tracking` server system variable
+
+* The `old` and `new` server system variables
+
+* The `--character-set-client-handshake` server variable
+
+* `INFORMATION_SCHEMA.PROCESSLIST`
+
+* The implementation of the `SHOW PROCESSLIST` command that uses the `INFORMATION_SCHEMA.PROCESSLIST` table
+
+* The `performance_schema_show_processlist` variable
+
+This release removes the following variables and options:
+
+* The `WAIT_UNTIL_SQL_THREAD_AFTER_GTIDS()` SQL function. Attempting to invoke this function now causes a syntax error. Use `WAIT_FOR_EXECUTED_GTID_SET()` instead.
+
+* The `--abort-slave-event-count` and `--disconnect-slave-event-count` server startup options. Attempting to use these options now results in an error.
+
+* The `expire_logs_days` server system variable. Attempting to use this variable now results in an error. Use the `binlog_expire_logs_seconds` variable instead.
+
+Find the full list of bug fixes and changes in the [MySQL 8.2 Release Notes].
+
+## Supplied components
+
+Review each component’s release notes for What’s new, improvements, or bug fixes. The following is a list of the components supplied with the Percona Server for MySQL-based variation of the Percona Distribution for MySQL:
+
+| Component           | Version   | Description                                |
+| ------------------- | --------- | -------------------------------------------|
+| Orchestrator        | [3.2.6-11](https://github.com/percona/orchestrator/releases/tag/v3.2.6-11)     | The replication topology manager for Percona Server for MySQL|
+| ProxySQL            | [2.5.5](https://docs.percona.com/proxysql/2.5.5.html)     | A high performance, high-availability, protocol-aware proxy for MySQL|
+| Percona XtraBackup  | [8.2.0](https://docs.percona.com/percona-xtrabackup/innovation-release/release-notes/8.2.0-1.html)| An open-source hot backup utility for MySQL-based servers|
+| Percona Toolkit     | [3.5.7](https://docs.percona.com/percona-toolkit/release_notes.html#v3-5-7-released-2023-12-23)     | The set of scripts to simplify and optimize database operation|
+| MySQL Shell         | [8.2.0](https://dev.mysql.com/doc/relnotes/mysql-shell/8.2/en/news-8-2-0.html)    | An advanced client and code editor for MySQL Server|
+| MySQL Router        | [8.2.0](https://dev.mysql.com/doc/relnotes/mysql-router/8.2/en/news-8-2-0.html)    | Lightweight middleware that provides transparent routing between your application and back-end MySQL servers|
+
+[Percona Server for MySQL 8.2.0-1]: https://www.percona.com/doc/percona-server/innovation-release/release-notes/8.2.0-1.html
+[MySQL 8.2 Release Notes]: https://dev.mysql.com/doc/relnotes/mysql/8.2/en/news-8-2-0.html
+
diff --git a/docs/release-notes.md b/docs/release-notes.md
@@ -1,5 +1,7 @@
 # Percona Distribution for MySQL {{vers}} release notes index
 
+* [Percona Distribution for MySQL using Percona Server for MySQL 8.2.0 (2024-02-05)](release-notes-ps-8.2.md)
+
 * [Percona Distribution for MySQL using Percona Server for MySQL 8.1.0 Second Update (2023-12-23)](release-notes-ps-8.1.upd2.md)
 
 * [Percona Distribution for MySQL using Percona Server for MySQL 8.1.0 Update (2023-12-21)](release-notes-ps-8.1.upd.md)

diff --git a/mkdocs-base.yml b/mkdocs-base.yml
@@ -1,7 +1,7 @@
 # MkDocs configuration for builds with material theme
 
 site_name: Percona Distribution for MySQL
-site_description: Percona Distribution for MySQL 8.1 Documentation
+site_description: Percona Distribution for MySQL 8.2 Documentation
 site_author: Percona LLC
 
 repo_name: /percona/pdmysql-docs
@@ -126,7 +126,7 @@ plugins:
   with-pdf: # https://github.com/orzih/mkdocs-with-pdf
           output_path: '_pdf/PerconaDistributionforMySQL.pdf'
           cover_title: 'Percona Distribution for MySQL Documentation'
-          cover_subtitle: 8.1.0 (2023-12-23)
+          cover_subtitle: 8.2.0 (2024-02-06)
           author: 'Percona Technical Documentation Team'
           cover_logo: docs/_images/Percona_Logo_Color.png
           debug_html: false
@@ -158,6 +158,7 @@ nav:
   - Home: index.md
   - Release notes:
     - Release notes index: release-notes.md
+    - release-notes-ps-8.2.md
     - release-notes-ps-8.1.upd2.md
     - release-notes-ps-8.1.upd.md
     - release-notes-ps-8.1.md

diff --git a/variables.yml b/variables.yml
@@ -1,12 +1,12 @@
 # variables for HTML output
 
-release: '8.1.0'
-version: '8.1'
-psvers: '8.1.0-1'
-vers: '8.1'
+release: '8.2.0'
+version: '8.2'
+psvers: '8.2.0-1'
+vers: '8.2'
 majorpkg: 'pdps-8x-innovation'
-minorpkg: 'pdps-8.1.0'
-release_date: '2023-12-23'
-title_date: '2023-12-23'
+minorpkg: 'pdps-8.2.0'
+release_date: '2024-02-06'
+title_date: '2024-02-06'