From 22005a25b6e44615a4f78485573263beb7b0031e Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 13:10:32 -0400
Subject: [PATCH 01/28] v9.2 Changelog
---
source/install/self-managed-changelog.md | 61 ++++++++++++++++++++++++
1 file changed, 61 insertions(+)
diff --git a/source/install/self-managed-changelog.md b/source/install/self-managed-changelog.md
index 519b3f7036e..4e85318a387 100644
--- a/source/install/self-managed-changelog.md
+++ b/source/install/self-managed-changelog.md
@@ -6,11 +6,72 @@ See the [changelog in progress](https://bit.ly/2nK3cVf) for the upcoming release
Latest Mattermost Releases:
+- [Release v9.2 - Feature Release](#release-v9-2-feature-release)
- [Release v9.1 - Feature Release](#release-v9-1-feature-release)
- [Release v9.0 - Major Release](#release-v9-0-major-release)
- [Release v8.1 - Extended Support Release](#release-v8-1-extended-support-release)
- [Release v7.8 - Extended Support Release](#release-v7-8-extended-support-release)
+## Release v9.2 - [Feature Release](https://docs.mattermost.com/upgrade/release-definitions.html#feature-release)
+
+**Release day: November 16, 2023**
+
+### Important Upgrade Notes
+ - Fixed Data Retention Policies to run jobs when their is any "Custom retention policy" enabled even when the "Global retention policy" is set to "keep-forever". Earlier due to this bug, the Enabled Custom Policies wouldn't run as long as Global Policy was set to "keep-forever"/disabled. After this fix, the custom policies would run automatically even when the Global Policy is set to "keep-forever". So once upgraded, this may unintentionally delete posts. So, admins should make sure to "disable" all custom policies before upgrading. Then re-enable them again as per the requirement.
+
+**IMPORTANT:** If you upgrade from a release earlier than v9.1, please read the other [Important Upgrade Notes](https://docs.mattermost.com/upgrade/important-upgrade-notes.html).
+
+### Compatibility
+ - Updated minimum required Edge version to 116+.
+
+### Improvements
+
+#### User Interface (UI)
+ - Improved readability by displaying system messages on multiple lines when editing a channel header.
+ - Combined "joined/left" event type in system messages.
+ - Added a new user preference to disable webapp prefetching via **Settings > Advanced > Allow Mattermost to prefetch channel posts**.
+
+#### Administration
+ - JSON null value cases are now handled correctly by also checking that the pointer is no longer null when unmarshalling to a pointer.
+ - An annotated logger is now used to capture LDAP and SAML logs.
+ - Replaced ``github.com/mattermost/gziphandler`` with ``github.com/klauspost/compress/gzhttp``.
+ - Performance metrics now contain information on if a given request was sent during a page load or a websocket reconnect.
+ - Elasticsearch aggregation jobs no longer start when a bulk indexing job is currently running.
+
+### Bug Fixes
+ - Fixed a panic where a simple worker would crash if it failed to get a job.
+ - Fixed post props on update to properly see channel links.
+ - Fixed an issue where the API for drafts would return empty drafts.
+ - Fixed alignment of the help menu in the global header.
+ - Fixed a broken link in the **Edit Channel** header modal.
+ - Fixed a bug preventing users to be added to channels from the system console.
+
+### config.json
+Multiple setting options were added to ``config.json``. Below is a list of the additions and their default values on install. The settings can be modified in ``config.json``, or the System Console when available.
+
+#### Changes to all plans:
+ - A new config value added to LogSettings so that log fields can be size limited during logging. (MaxFieldSize)
+
+### API Changes
+ - Added ``origin_client to the mattermost_api_time`` metrics.
+
+### Go Version
+ - v9.2 is built with Go ``v1.20.7``.
+
+### Known Issues
+ - Copy pasting images from Chrome fails [MM-54486](https://mattermost.atlassian.net/browse/MM-54486).
+ - Adding an @mention at the start of a post draft and pressing the left or right arrow key can clear the post draft and the undo history [MM-33823](https://mattermost.atlassian.net/browse/MM-33823).
+ - Status may sometimes get stuck as **Away** or **Offline** in High Availability mode with IP Hash turned off.
+ - Searching stop words in quotation marks with Elasticsearch enabled returns more than just the searched terms.
+ - Slack import through the CLI fails if email notifications are enabled.
+ - Push notifications don't always clear on iOS when running Mattermost in High Availability mode.
+ - The Playbooks left-hand sidebar doesn't update when a user is added to a run or playbook without a refresh.
+ - If a user isn't a member of a configured broadcast channel, posting a status update might fail without any error feedback. As a temporary workaround, join the configured broadcast channels, or remove those channels from the run configuration.
+ - The Playbooks left-hand sidebar does not update when a user is added to a run or playbook without a refresh.
+
+### Contributors
+ -
+
## Release v9.1 - [Feature Release](https://docs.mattermost.com/upgrade/release-definitions.html#feature-release)
**Release day: October 16, 2023**
From a0f51ca38d65cb57fd42c106c6c9f3751aea4af5 Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 13:12:02 -0400
Subject: [PATCH 02/28] Update download-latest-tarball.rst
---
source/install/download-latest-tarball.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/install/download-latest-tarball.rst b/source/install/download-latest-tarball.rst
index daa0791b2b8..c581b6de373 100644
--- a/source/install/download-latest-tarball.rst
+++ b/source/install/download-latest-tarball.rst
@@ -15,7 +15,7 @@ Using ``wget``, download the Mattermost Server release you want to install.
- wget https://releases.mattermost.com/9.1.0/mattermost-9.1.0-linux-amd64.tar.gz
+ wget https://releases.mattermost.com/9.2.0/mattermost-9.2.0-linux-amd64.tar.gz
Copied to clipboard
From 9ef4dccb1c90656292d933d01337d3e67337ef54 Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 13:12:48 -0400
Subject: [PATCH 03/28] Update important-upgrade-notes.rst
---
source/upgrade/important-upgrade-notes.rst | 2 ++
1 file changed, 2 insertions(+)
diff --git a/source/upgrade/important-upgrade-notes.rst b/source/upgrade/important-upgrade-notes.rst
index 888e23561ad..f2c0fd8ac4f 100644
--- a/source/upgrade/important-upgrade-notes.rst
+++ b/source/upgrade/important-upgrade-notes.rst
@@ -14,6 +14,8 @@ Important Upgrade Notes
+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| If you’re upgrading from a version earlier than... | Then... |
+====================================================+==================================================================================================================================================================+
+| v9.2 | |
++----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| v9.1 | In v9.1.0, improved performance on data retention ``DeleteOrphanedRows`` queries. |
| | |
| | New migration for a new table: |
From 97cd93c65313e1fef327124cf0a6c2c057346842 Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 13:13:21 -0400
Subject: [PATCH 04/28] Update open-source-components.rst
---
source/upgrade/open-source-components.rst | 2 ++
1 file changed, 2 insertions(+)
diff --git a/source/upgrade/open-source-components.rst b/source/upgrade/open-source-components.rst
index 35887095263..1ef00d84caf 100644
--- a/source/upgrade/open-source-components.rst
+++ b/source/upgrade/open-source-components.rst
@@ -28,6 +28,7 @@ Desktop
Mobile
-------
+ - Mattermost Mobile v2.10.0 - `View Open Source Components `_.
- Mattermost Mobile v2.9.0 - `View Open Source Components `_.
- Mattermost Mobile v2.8.0 - `View Open Source Components `_.
- Mattermost Mobile v2.7.0 - `View Open Source Components `_.
@@ -98,6 +99,7 @@ Mobile
Server
------------------------------
+ - Mattermost Enterprise Edition v9.2.0 - `View Open Source Components `_.
- Mattermost Enterprise Edition v9.1.0 - `View Open Source Components `_.
- Mattermost Enterprise Edition v9.0.0 - `View Open Source Components `_.
- Mattermost Enterprise Edition v8.1.0 - `View Open Source Components `_.
From b4a7d3928ba0c48ac2fceed3c66c41e416707f06 Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 13:13:49 -0400
Subject: [PATCH 05/28] Update release-lifecycle.rst
---
source/upgrade/release-lifecycle.rst | 2 ++
1 file changed, 2 insertions(+)
diff --git a/source/upgrade/release-lifecycle.rst b/source/upgrade/release-lifecycle.rst
index 199bc4c9556..940d2358b13 100644
--- a/source/upgrade/release-lifecycle.rst
+++ b/source/upgrade/release-lifecycle.rst
@@ -16,6 +16,8 @@ During each monthly release, Mattermost backports high severity or high impact s
+-------------+-----------------------+--------------------------+--------------------------+--------------------------+
| Version | Release Type | Lifecyle Start Date | Lifecycle End Date | Extended Support Release |
+=============+=======================+==========================+==========================+==========================+
+| 9.3 | Feature | 2023-12-16 | 2024-03-15 | |
++-------------+-----------------------+--------------------------+--------------------------+--------------------------+
| 9.2 | Feature | 2023-11-16 | 2024-02-15 | |
+-------------+-----------------------+--------------------------+--------------------------+--------------------------+
| 9.1 | Feature | 2023-10-16 | 2024-01-15 | |
From ea9bb63dcfff755d4bab371b1144c65da6e3c189 Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 14:26:15 -0400
Subject: [PATCH 06/28] Update self-managed-changelog.md
---
source/install/self-managed-changelog.md | 11 ++++++-----
1 file changed, 6 insertions(+), 5 deletions(-)
diff --git a/source/install/self-managed-changelog.md b/source/install/self-managed-changelog.md
index 4e85318a387..2d5fb77dc54 100644
--- a/source/install/self-managed-changelog.md
+++ b/source/install/self-managed-changelog.md
@@ -17,7 +17,7 @@ Latest Mattermost Releases:
**Release day: November 16, 2023**
### Important Upgrade Notes
- - Fixed Data Retention Policies to run jobs when their is any "Custom retention policy" enabled even when the "Global retention policy" is set to "keep-forever". Earlier due to this bug, the Enabled Custom Policies wouldn't run as long as Global Policy was set to "keep-forever"/disabled. After this fix, the custom policies would run automatically even when the Global Policy is set to "keep-forever". So once upgraded, this may unintentionally delete posts. So, admins should make sure to "disable" all custom policies before upgrading. Then re-enable them again as per the requirement.
+ - Fixed Data Retention Policies to run jobs when there is any "Custom retention policy" enabled even when the "Global retention policy" is set to "keep-forever". Before this fix, the Enabled Custom Policies wouldn't run as long as Global Policy was set to "keep-forever" or was disabled. After the fix, the custom policies will run automatically even when the Global Policy is set to "keep-forever". Once the server is upgraded, posts may unintentionally be deleted. Admins should make sure to disable all custom policies before upgrading, and then re-enable them again after upgrading.
**IMPORTANT:** If you upgrade from a release earlier than v9.1, please read the other [Important Upgrade Notes](https://docs.mattermost.com/upgrade/important-upgrade-notes.html).
@@ -28,7 +28,7 @@ Latest Mattermost Releases:
#### User Interface (UI)
- Improved readability by displaying system messages on multiple lines when editing a channel header.
- - Combined "joined/left" event type in system messages.
+ - Combined "joined/left" event types in system messages.
- Added a new user preference to disable webapp prefetching via **Settings > Advanced > Allow Mattermost to prefetch channel posts**.
#### Administration
@@ -42,15 +42,16 @@ Latest Mattermost Releases:
- Fixed a panic where a simple worker would crash if it failed to get a job.
- Fixed post props on update to properly see channel links.
- Fixed an issue where the API for drafts would return empty drafts.
- - Fixed alignment of the help menu in the global header.
+ - Fixed the alignment of the **Help** menu in the global header.
- Fixed a broken link in the **Edit Channel** header modal.
- - Fixed a bug preventing users to be added to channels from the system console.
+ - Fixed an issue that prevented users to be added to channels from the System Console.
### config.json
Multiple setting options were added to ``config.json``. Below is a list of the additions and their default values on install. The settings can be modified in ``config.json``, or the System Console when available.
#### Changes to all plans:
- - A new config value added to LogSettings so that log fields can be size limited during logging. (MaxFieldSize)
+ - Under ``LogSettings`` in ``confi.json``:
+ - Added a new configuration setting ``MaxFieldSize`` to add the ability to size-limit log fields during logging.
### API Changes
- Added ``origin_client to the mattermost_api_time`` metrics.
From f19e5f7ee4b9b660564dcf07743b4960cc99f5a6 Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 14:27:42 -0400
Subject: [PATCH 07/28] Update important-upgrade-notes.rst
---
source/upgrade/important-upgrade-notes.rst | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/source/upgrade/important-upgrade-notes.rst b/source/upgrade/important-upgrade-notes.rst
index f2c0fd8ac4f..f6f572507bd 100644
--- a/source/upgrade/important-upgrade-notes.rst
+++ b/source/upgrade/important-upgrade-notes.rst
@@ -5,7 +5,7 @@ Important Upgrade Notes
:start-after: :nosearch:
.. important::
- - Support for Mattermost Server v7.8 :doc:`Extended Support Release ` is coming to the end of its life cycle in November 15, 2023. Upgrading to Mattermost Server v8.1 :doc:`Extended Support Release ` or later is recommended.
+ - Support for Mattermost Server v7.8 :doc:`Extended Support Release ` has come to the end of its life cycle in November 15, 2023. Upgrading to Mattermost Server v8.1 :doc:`Extended Support Release ` or later is required.
- MySQL 8.0.22 contains an `issue with JSON column types `__ changing string values to integers which is preventing Mattermost from working properly. Users are advised to avoid this database version.
- Upgrading the Microsoft Teams Calling plugin to v2.0.0 requires users to reconnect their accounts.
- When upgrading to 7.x from a 5.x release please make sure to upgrade to 5.37.10 first for the upgrade to complete successfully.
@@ -14,7 +14,10 @@ Important Upgrade Notes
+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| If you’re upgrading from a version earlier than... | Then... |
+====================================================+==================================================================================================================================================================+
-| v9.2 | |
+| v9.2 | Fixed Data Retention Policies to run jobs when there is any "Custom retention policy" enabled even when the "Global retention policy" is set to "keep-forever". |
+| | Before this fix, the Enabled Custom Policies wouldn't run as long as Global Policy was set to "keep-forever" or was disabled. After the fix, the custom policies |
+| | will run automatically even when the Global Policy is set to "keep-forever". Once the server is upgraded, posts may unintentionally be deleted. Admins should |
+| | make sure to disable all custom policies before upgrading, and then re-enable them again after upgrading. |
+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| v9.1 | In v9.1.0, improved performance on data retention ``DeleteOrphanedRows`` queries. |
| | |
From bdc47b3146f993e9cb983c4d2b9bf652d0f8d9ed Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 14:27:58 -0400
Subject: [PATCH 08/28] Update release-lifecycle.rst
---
source/upgrade/release-lifecycle.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/upgrade/release-lifecycle.rst b/source/upgrade/release-lifecycle.rst
index 940d2358b13..dfde194c034 100644
--- a/source/upgrade/release-lifecycle.rst
+++ b/source/upgrade/release-lifecycle.rst
@@ -11,7 +11,7 @@ During each monthly release, Mattermost backports high severity or high impact s
.. important::
- Support for Mattermost Server v7.8 :doc:`Extended Support Release ` is coming to the end of its life cycle on November 15, 2023. Upgrading to Mattermost Server v8.1 or later is recommended.
+ Support for Mattermost Server v7.8 :doc:`Extended Support Release ` has come to the end of its life cycle on November 15, 2023. Upgrading to Mattermost Server v8.1 or later is required.
+-------------+-----------------------+--------------------------+--------------------------+--------------------------+
| Version | Release Type | Lifecyle Start Date | Lifecycle End Date | Extended Support Release |
From a647f72ef1ec5ac1775ec22c8480366b39d93577 Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 14:28:34 -0400
Subject: [PATCH 09/28] Update version-archive.rst
---
source/upgrade/version-archive.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/upgrade/version-archive.rst b/source/upgrade/version-archive.rst
index b9cb807df19..daec3ee9292 100644
--- a/source/upgrade/version-archive.rst
+++ b/source/upgrade/version-archive.rst
@@ -8,7 +8,7 @@ If you want to check that the version of Mattermost you are installing is the of
.. important::
- Support for Mattermost Server v7.8 :doc:`Extended Support Release ` is coming to the end of its life cycle on November 15, 2023. Upgrading to Mattermost Server v8.1 :doc:`Extended Support Release ` or later is recommended.
+ Support for Mattermost Server v7.8 :doc:`Extended Support Release ` has come to the end of its life cycle on November 15, 2023. Upgrading to Mattermost Server v8.1 :doc:`Extended Support Release ` or later is required.
.. contents:: On this page
:backlinks: top
From 7f9d65862483f2071f2113bf9d2cebbab0917d89 Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 14:31:08 -0400
Subject: [PATCH 10/28] Update extended-support-release.rst
---
source/upgrade/extended-support-release.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/upgrade/extended-support-release.rst b/source/upgrade/extended-support-release.rst
index 13b42bdd5e8..9e5b5db9c9a 100644
--- a/source/upgrade/extended-support-release.rst
+++ b/source/upgrade/extended-support-release.rst
@@ -10,7 +10,7 @@ What is an Extended Support Release?
During each monthly release, Mattermost backports security fixes and high impact bug fixes to the previous three monthly releases. Extended Support Releases (ESRs) are releases that will receive backports for security fixes and major bug fixes for the length of their life cycle.
.. important::
- Support for Mattermost Server v7.8 Extended Support Release is coming to the end of its life cycle on November 15, 2023. Upgrading to Mattermost Server v8.1 Extended Support Release or later is recommended.
+ Support for Mattermost Server v7.8 Extended Support Release has come to the end of its life cycle on November 15, 2023. Upgrading to Mattermost Server v8.1 Extended Support Release or later is required.
What is the life cycle of an Extended Support Release?
------------------------------------------------------
From e7f5d3e29a0492ca85b9ade871d1ddaa40ed718e Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 14:34:27 -0400
Subject: [PATCH 11/28] Update prepare-to-upgrade-mattermost.rst
---
source/upgrade/prepare-to-upgrade-mattermost.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/upgrade/prepare-to-upgrade-mattermost.rst b/source/upgrade/prepare-to-upgrade-mattermost.rst
index 78a74701bbd..694df043e87 100644
--- a/source/upgrade/prepare-to-upgrade-mattermost.rst
+++ b/source/upgrade/prepare-to-upgrade-mattermost.rst
@@ -63,7 +63,7 @@ We strongly recommend that you:
.. important::
- Support for Mattermost Server v7.8 :doc:`Extended Support Release ` is coming to the end of its life cycle on November 15, 2023. Upgrading to Mattermost Server v8.1 Extended Support Release or later is recommended. Upgrading from a previous Extended Support Release to the latest Extended Support Release is supported. Upgrading from v5.31 to v5.37 should take roughly the same amount of time as upgrading from v5.31 to v5.35, then upgrading v5.35 to 5.37. However, an upgrade directly from v5.31 to v5.37 could potentially take hours due to the database schema migrations required for v5.35. Review the :doc:`important-upgrade-notes` for all intermediate versions in between to ensure you’re aware of the possible migrations that could affect your upgrade.
+ Support for Mattermost Server v7.8 :doc:`Extended Support Release ` has come to the end of its life cycle on November 15, 2023. Upgrading to Mattermost Server v8.1 Extended Support Release or later is required. Upgrading from a previous Extended Support Release to the latest Extended Support Release is supported. Upgrading from v5.31 to v5.37 should take roughly the same amount of time as upgrading from v5.31 to v5.35, then upgrading v5.35 to 5.37. However, an upgrade directly from v5.31 to v5.37 could potentially take hours due to the database schema migrations required for v5.35. Review the :doc:`important-upgrade-notes` for all intermediate versions in between to ensure you’re aware of the possible migrations that could affect your upgrade.
v6.0 database schema migrations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
From dd2757c2b944d48ef8bda47256fb4cc7146032b6 Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 14:36:04 -0400
Subject: [PATCH 12/28] Update software-hardware-requirements.rst
---
source/install/software-hardware-requirements.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/install/software-hardware-requirements.rst b/source/install/software-hardware-requirements.rst
index f69e7312b46..a7def4a33e5 100644
--- a/source/install/software-hardware-requirements.rst
+++ b/source/install/software-hardware-requirements.rst
@@ -52,7 +52,7 @@ PC web
"Chrome", "v116+", "v116+"
"Firefox", "v102+", "v102+"
"Safari", "v16.2+", "v16.2+"
- "Edge", "v112+", "v112+"
+ "Edge", "v116+", "v116+"
`*` Internet Explorer (IE11) is no longer supported. We recommend using the `Mattermost desktop app `_ or another supported browser. See `this forum post `__ to learn more.
From 28fe810faf8d0e19705d8d595ed7eb1dd5cefe3f Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 15:03:40 -0400
Subject: [PATCH 13/28] Update self-managed-changelog.md
---
source/install/self-managed-changelog.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/source/install/self-managed-changelog.md b/source/install/self-managed-changelog.md
index 2d5fb77dc54..ffb93e55140 100644
--- a/source/install/self-managed-changelog.md
+++ b/source/install/self-managed-changelog.md
@@ -30,6 +30,7 @@ Latest Mattermost Releases:
- Improved readability by displaying system messages on multiple lines when editing a channel header.
- Combined "joined/left" event types in system messages.
- Added a new user preference to disable webapp prefetching via **Settings > Advanced > Allow Mattermost to prefetch channel posts**.
+ - Pre-packaged Focalboard plugin version [v7.11.4](https://github.com/mattermost/focalboard/releases/tag/v7.11.4).
#### Administration
- JSON null value cases are now handled correctly by also checking that the pointer is no longer null when unmarshalling to a pointer.
@@ -37,6 +38,8 @@ Latest Mattermost Releases:
- Replaced ``github.com/mattermost/gziphandler`` with ``github.com/klauspost/compress/gzhttp``.
- Performance metrics now contain information on if a given request was sent during a page load or a websocket reconnect.
- Elasticsearch aggregation jobs no longer start when a bulk indexing job is currently running.
+ - Added heap profile, CPU profile, and goroutines profile to the support package.
+ - Merged WIP i18n locales, but disallowed selecting unsupported locales.
### Bug Fixes
- Fixed a panic where a simple worker would crash if it failed to get a job.
@@ -45,6 +48,7 @@ Latest Mattermost Releases:
- Fixed the alignment of the **Help** menu in the global header.
- Fixed a broken link in the **Edit Channel** header modal.
- Fixed an issue that prevented users to be added to channels from the System Console.
+ - Fixed an issue where the channel member count increased when adding an already present user.
### config.json
Multiple setting options were added to ``config.json``. Below is a list of the additions and their default values on install. The settings can be modified in ``config.json``, or the System Console when available.
From fb1833705fef1632c5ea64f4d3b7658017365954 Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 15:13:34 -0400
Subject: [PATCH 14/28] Update extended-support-release.rst
---
source/upgrade/extended-support-release.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/upgrade/extended-support-release.rst b/source/upgrade/extended-support-release.rst
index 9e5b5db9c9a..5f4089cadca 100644
--- a/source/upgrade/extended-support-release.rst
+++ b/source/upgrade/extended-support-release.rst
@@ -21,7 +21,7 @@ When an ESR is at the end of its life cycle, there will be announcements ahead o
To receive updates about Extended Support Releases, sign up for our mailing list `here `__.
-.. image:: ../images/ESR_graphic.png
+.. image:: ../images/ESR_update.png
:alt: Timeline-based chart showing the lifecycle of Mattermost Extended Support Releases and feature releases from last year and this year.
What is included in an Extended Support Release dot release?
From d77322b7eb67c3b8daef0e6c1c579acdd8a9339b Mon Sep 17 00:00:00 2001
From: Amy Blais <29708087+amyblais@users.noreply.github.com>
Date: Tue, 17 Oct 2023 15:14:02 -0400
Subject: [PATCH 15/28] Add files via upload
---
source/images/ESR_update.png | Bin 0 -> 252325 bytes
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 source/images/ESR_update.png
diff --git a/source/images/ESR_update.png b/source/images/ESR_update.png
new file mode 100644
index 0000000000000000000000000000000000000000..75aab706db0db096e8b0a56e3a742673052be033
GIT binary patch
literal 252325
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