Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

v9.2 Changelog #6717

Merged
merged 29 commits into from
Nov 6, 2023
Merged
Show file tree
Hide file tree
Changes from 22 commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
22005a2
v9.2 Changelog
amyblais Oct 17, 2023
a0f51ca
Update download-latest-tarball.rst
amyblais Oct 17, 2023
9ef4dcc
Update important-upgrade-notes.rst
amyblais Oct 17, 2023
97cd93c
Update open-source-components.rst
amyblais Oct 17, 2023
b4a7d39
Update release-lifecycle.rst
amyblais Oct 17, 2023
ea9bb63
Update self-managed-changelog.md
amyblais Oct 17, 2023
f19e5f7
Update important-upgrade-notes.rst
amyblais Oct 17, 2023
bdc47b3
Update release-lifecycle.rst
amyblais Oct 17, 2023
a647f72
Update version-archive.rst
amyblais Oct 17, 2023
7f9d658
Update extended-support-release.rst
amyblais Oct 17, 2023
e7f5d3e
Update prepare-to-upgrade-mattermost.rst
amyblais Oct 17, 2023
dd2757c
Update software-hardware-requirements.rst
amyblais Oct 17, 2023
28fe810
Update self-managed-changelog.md
amyblais Oct 17, 2023
fb18337
Update extended-support-release.rst
amyblais Oct 17, 2023
d77322b
Add files via upload
amyblais Oct 17, 2023
403bc41
Update self-managed-changelog.md
amyblais Oct 18, 2023
5a02449
Update self-managed-changelog.md
amyblais Oct 19, 2023
7a4d294
Update self-managed-changelog.md
amyblais Oct 20, 2023
22539e9
Update important-upgrade-notes.rst
amyblais Oct 20, 2023
eee1c3f
Update self-managed-changelog.md
amyblais Oct 20, 2023
f5de850
Add bug fix
amyblais Oct 24, 2023
39c863c
Add bug fix
amyblais Oct 25, 2023
765617c
Merge branch 'v9.2-documentation' into amyblais-patch-1
amyblais Oct 27, 2023
38d22f6
Update self-managed-changelog.md
amyblais Oct 27, 2023
919cd7f
Update self-managed-changelog.md
amyblais Oct 31, 2023
e7f9680
Update source/install/self-managed-changelog.md
amyblais Nov 3, 2023
3704898
Update download-latest-tarball.rst
amyblais Nov 3, 2023
0b04d75
Update self-managed-changelog.md
amyblais Nov 3, 2023
b79581b
Update self-managed-changelog.md
amyblais Nov 6, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added source/images/ESR_update.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion source/install/download-latest-tarball.rst
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Using ``wget``, download the Mattermost Server release you want to install.

<div class="mm-code-copy__wrapper">
<code class="mm-code-copy__text mm-code-copy__trigger" data-click-el="Snippet">
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
</code>
<span class="mm-code-copy__copied-notice">Copied to clipboard</span>
</div>
Expand Down
67 changes: 67 additions & 0 deletions source/install/self-managed-changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,78 @@ 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 any custom retention policy is enabled even when the global retention policy is set to "keep-forever". Before this fix, the enabled custom data retention policies wouldn't run as long as the global data retention policy was set to "keep-forever" or was disabled. After the fix, the custom data retention policies will run automatically even when the global data retention policy is set to "keep-forever". Once the server is upgraded, posts may unintentionally be deleted. Admins should make sure to disable all custom data retention 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).

### 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 types in system messages.
- Added a new user preference to disable webapp prefetching via **Settings > Advanced > Allow Mattermost to prefetch channel posts**.
- Pre-packaged NPS plugin version [v1.3.3](https://github.com/mattermost/mattermost-plugin-nps/releases/tag/v1.3.3).

#### 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.
- 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.
- Fixed post props on update to properly see channel links.
- Fixed an issue where the API for drafts would return empty drafts.
- 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.
- Fixed an issue where plugin developers were unable to create a ``textarea`` in interactive dialogs.
- Fixed an issue where copy pasting images from Chrome failed.

### 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:
- Under ``LogSettings`` in ``config.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.
amyblais marked this conversation as resolved.
Show resolved Hide resolved

### Go Version
- v9.2 is built with Go ``v1.20.7``.

### Known Issues
- 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**
Expand Down
2 changes: 1 addition & 1 deletion source/install/software-hardware-requirements.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://mattermost.com/apps/>`_ or another supported browser. See `this forum post <https://forum.mattermost.com/t/mattermost-is-dropping-support-for-internet-explorer-ie11-in-v5-16/7575>`__ to learn more.

Expand Down
4 changes: 2 additions & 2 deletions source/upgrade/extended-support-release.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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?
------------------------------------------------------
Expand All @@ -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 <https://eepurl.com/dCKn2P>`__.

.. 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?
Expand Down
8 changes: 7 additions & 1 deletion source/upgrade/important-upgrade-notes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Important Upgrade Notes
:start-after: :nosearch:

.. important::
- Support for Mattermost Server v7.8 :doc:`Extended Support Release </upgrade/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 </upgrade/extended-support-release>` or later is recommended.
- Support for Mattermost Server v7.8 :doc:`Extended Support Release </upgrade/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 </upgrade/extended-support-release>` or later is required.
- MySQL 8.0.22 contains an `issue with JSON column types <https://bugs.mysql.com/bug.php?id=101284>`__ 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.
Expand All @@ -14,6 +14,12 @@ Important Upgrade Notes
+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| If you’re upgrading from a version earlier than... | Then... |
+====================================================+==================================================================================================================================================================+
| v9.2 | Fixed data retention policies to run jobs when any custom retention policy is enabled even when the global retention policy is set to "keep-forever". Before |
| | this fix, the enabled custom data retention policies wouldn't run as long as the global data retention policy was set to "keep-forever" or was disabled. After |
| | the fix, the custom data retention policies will run automatically even when the global data retention policy is set to "keep-forever". Once the server is |
| | upgraded, posts may unintentionally be deleted. Admins should make sure to disable all custom data retention policies before upgrading, and then re-enable |
| | them again after upgrading. |
+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| v9.1 | In v9.1.0, improved performance on data retention ``DeleteOrphanedRows`` queries. |
| | |
| | New migration for a new table: |
Expand Down
2 changes: 2 additions & 0 deletions source/upgrade/open-source-components.rst
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ Desktop
Mobile
-------

- Mattermost Mobile v2.10.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.10/NOTICE.txt>`_.
- Mattermost Mobile v2.9.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.9/NOTICE.txt>`_.
- Mattermost Mobile v2.8.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.8/NOTICE.txt>`_.
- Mattermost Mobile v2.7.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.7/NOTICE.txt>`_.
Expand Down Expand Up @@ -98,6 +99,7 @@ Mobile
Server
------------------------------

- Mattermost Enterprise Edition v9.2.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-9.2/NOTICE.txt>`_.
- Mattermost Enterprise Edition v9.1.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-9.1/NOTICE.txt>`_.
- Mattermost Enterprise Edition v9.0.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-9.0/NOTICE.txt>`_.
- Mattermost Enterprise Edition v8.1.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-8.1/NOTICE.txt>`_.
Expand Down
2 changes: 1 addition & 1 deletion source/upgrade/prepare-to-upgrade-mattermost.rst
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ We strongly recommend that you:

.. important::

Support for Mattermost Server v7.8 :doc:`Extended Support Release </upgrade/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 </upgrade/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
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down
4 changes: 3 additions & 1 deletion source/upgrade/release-lifecycle.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,13 @@ During each monthly release, Mattermost backports high severity or high impact s

.. important::

Support for Mattermost Server v7.8 :doc:`Extended Support Release </upgrade/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 </upgrade/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 |
+=============+=======================+==========================+==========================+==========================+
| 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 | |
Expand Down
2 changes: 1 addition & 1 deletion source/upgrade/version-archive.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 </upgrade/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 </upgrade/extended-support-release>` or later is recommended.
Support for Mattermost Server v7.8 :doc:`Extended Support Release </upgrade/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 </upgrade/extended-support-release>` or later is required.

.. contents:: On this page
:backlinks: top
Expand Down