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

v10.2 Changelog #7497

Open
wants to merge 34 commits into
base: v10.2-documentation
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 28 commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
3ac0bb2
Update mattermost-server-releases.md
amyblais Oct 16, 2024
ffb8838
Update download-latest-tarball.rst
amyblais Oct 16, 2024
6ffaa51
Update deprecated-features.rst
amyblais Oct 16, 2024
0dd9d8c
Update mattermost-server-releases.md
amyblais Oct 16, 2024
9055958
Update release-policy.md
amyblais Oct 16, 2024
58a9432
Update mattermost-mobile-releases.md
amyblais Oct 16, 2024
30a8ad9
Update mattermost-desktop-releases.md
amyblais Oct 16, 2024
eaad447
Update mattermost-v10-changelog.md
amyblais Oct 16, 2024
ba37876
Update mattermost-v9-changelog.md
amyblais Oct 16, 2024
2e928ab
Update version-archive.rst
amyblais Oct 16, 2024
2f82873
Update important-upgrade-notes.rst
amyblais Oct 16, 2024
20c2106
Update prepare-to-upgrade-mattermost.rst
amyblais Oct 16, 2024
dd25c5c
Update open-source-components.rst
amyblais Oct 16, 2024
aa8c9ed
Update mattermost-v10-changelog.md
amyblais Oct 16, 2024
5f9552c
Update important-upgrade-notes.rst
amyblais Oct 16, 2024
4652133
Update deprecated-features.rst
amyblais Oct 16, 2024
357b82b
Update mattermost-server-releases.md
amyblais Oct 16, 2024
7b84cc9
Update release-policy.md
amyblais Oct 16, 2024
153b4ac
Update mattermost-v10-changelog.md
amyblais Oct 16, 2024
2a44e2b
Update mattermost-v10-changelog.md
amyblais Oct 17, 2024
b3d834b
Update mattermost-v10-changelog.md
amyblais Oct 17, 2024
f257b1d
Update mattermost-v10-changelog.md
amyblais Oct 18, 2024
615be9a
Update mattermost-v10-changelog.md
amyblais Oct 18, 2024
f0bc122
Apply suggestions from code review
amyblais Oct 18, 2024
045f6af
Update source/about/mattermost-v10-changelog.md
amyblais Oct 18, 2024
93c7b1b
Apply suggestions from code review
amyblais Oct 18, 2024
9551035
Update source/about/mattermost-v10-changelog.md
amyblais Oct 21, 2024
a1369fb
Update source/about/mattermost-v10-changelog.md
amyblais Oct 21, 2024
4ed05a2
Update mattermost-v10-changelog.md
amyblais Oct 24, 2024
ceb6388
Update mattermost-v10-changelog.md
amyblais Oct 24, 2024
84dff81
Merge branch 'v10.2-documentation' into amyblais-patch-19
amyblais Oct 28, 2024
8ba3c83
Update mattermost-v10-changelog.md
amyblais Oct 28, 2024
1a31e83
Update mattermost-v10-changelog.md
amyblais Nov 1, 2024
4aba9e3
Update mattermost-v10-changelog.md
amyblais Nov 4, 2024
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
8 changes: 4 additions & 4 deletions source/about/deprecated-features.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,13 +11,13 @@ Mattermost Server v10.3.0

- As part of our continuous efforts to enhance your user experience, we will be phasing out the Classic Mobile App. Please download the new v2 Mobile App from the `Apple App Store <https://apps.apple.com/us/app/mattermost/id1257222717>`_ or `Google Play Store <https://play.google.com/store/apps/details?id=com.mattermost.rn>`_ to continue enjoying our services without interruption. See more details in the `classic mobile app deprecation <https://forum.mattermost.com/t/classic-mobile-app-deprecation/18703>`_ Mattermost forum post.

Removed features by Mattermost version
----------------------------------------

Mattermost Server v10.2.0
~~~~~~~~~~~~~~~~~~~~~~~~~

- Docker Content Trust (DCT) for signing Docker image artifacts will be replaced by Sigstore Cosign in our upcoming release, v10.2 (November, 2024). If you rely on artifact verification using DCT, please `transition to using Cosign <https://edu.chainguard.dev/open-source/sigstore/cosign/how-to-install-cosign/>`_. See `this forum post <https://forum.mattermost.com/t/upcoming-dct-deprecation/19275>`_ for more details.

Removed features by Mattermost version
----------------------------------------
- Docker Content Trust (DCT) for signing Docker image artifacts has been replaced by Sigstore Cosign in v10.2 (November, 2024). If you rely on artifact verification using DCT, please `transition to using Cosign <https://edu.chainguard.dev/open-source/sigstore/cosign/how-to-install-cosign/>`_. See `this forum post <https://forum.mattermost.com/t/upcoming-dct-deprecation/19275>`_ for more details.

Mattermost Server v10.0.0
~~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down
2 changes: 1 addition & 1 deletion source/about/mattermost-desktop-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
```

```{Important}
Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) is coming to the end of its life cycle in November 15, 2024. Upgrading to Mattermost Server v9.11 or later is recommended.
Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) has come to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is required.
```

## Frequency
Expand Down
2 changes: 1 addition & 1 deletion source/about/mattermost-mobile-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
```

```{Important}
- Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) is coming to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is recommended.
- Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) has come to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is required.
- We strongly recommend using the latest mobile app release available that contains the latest security fixes and user experience enhancements. Mobile app releases are tested against all generally available Mattermost server and extended support releases.
```

Expand Down
3 changes: 2 additions & 1 deletion source/about/mattermost-server-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
```

```{Important}
Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) is coming to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is recommended.
Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) has come to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is required.
- Upgrading from ESR-to-ESR (``major`` -> ``major_next``) is fully supported and tested. However, upgrading from ESR-to-ESR (``major`` to ``major+2``) is supported, but not tested. If you plan to upgrade across multiple releases, we strongly recommend upgrading from an ESR to another ESR. For example, if you're upgrading from the v8.1 ESR, upgrade to the [v9.5 ESR](https://docs.mattermost.com/about/mattermost-v9-changelog.html#release-v9-5-extended-support-release) or the v9.11 ESR.
```

Expand All @@ -19,6 +19,7 @@ Mattermost releases a new server version on the 16th of each month in [binary fo

| **Release** | **Released on** | **Support ends** |
|:---|:---|:---|
| v10.2 [Download](https://releases.mattermost.com/10.2.0/mattermost-10.2.0-linux-amd64.tar.gz) \| {ref}`Changelog <release-v10.2-feature-release>` | 2024-11-15 | 2025-02-15 |
| v10.1 [Download](https://releases.mattermost.com/10.1.1/mattermost-10.1.1-linux-amd64.tar.gz) \| {ref}`Changelog <release-v10.1-feature-release>` | 2024-10-16 | 2025-01-15 |
| v10.0 [Download](https://releases.mattermost.com/10.0.1/mattermost-10.0.1-linux-amd64.tar.gz) \| {ref}`Changelog <release-v10.0-major-release>` | 2024-09-16 | 2024-12-15 |
| v9.11 [Download](https://releases.mattermost.com/9.11.3/mattermost-9.11.3-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-11-extended-support-release>` | 2024-08-16 | 2025-05-15 {ref}`EXTENDED <release-types>` |
Expand Down
78 changes: 77 additions & 1 deletion source/about/mattermost-v10-changelog.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,88 @@
# v10 changelog

```{Important}
Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) is coming to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is recommended.
Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) has come to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is required.
- Upgrading from ESR-to-ESR (``major`` -> ``major_next``) is fully supported and tested. However, upgrading from ESR-to-ESR (``major`` to ``major+2``) is supported, but not tested. If you plan to upgrade across multiple releases, we strongly recommend upgrading from an ESR to another ESR. For example, if you're upgrading from the v8.1 ESR, upgrade to the [v9.5 ESR](https://docs.mattermost.com/about/mattermost-v9-changelog.html#release-v9-5-extended-support-release) or the v9.11 ESR.
- See the [Important Upgrade Notes](https://docs.mattermost.com/upgrade/important-upgrade-notes.html) documentation for details on upgrading to a newer release.
- See the [changelog in progress](https://bit.ly/2nK3cVf) for details about the upcoming release.
```

(release-v10.2-feature-release)=
## Release v10.2 - [Feature Release](https://docs.mattermost.com/about/release-policy.html#release-types)

**Release Day: November 15, 2024**

### Important Upgrade Notes

- Docker Content Trust (DCT) for signing Docker image artifacts has been replaced by Sigstore Cosign in v10.2 (November, 2024). If you rely on artifact verification using DCT, please [transition to using Cosign](https://edu.chainguard.dev/open-source/sigstore/cosign/how-to-install-cosign/). See the [DCT deprecation Mattermost forum post](https://forum.mattermost.com/t/upcoming-dct-deprecation/19275) for more details.

```{Important}
If you upgrade from a release earlier than v10.0, please read the other [Important Upgrade Notes](https://docs.mattermost.com/upgrade/important-upgrade-notes.html).
```

### Improvements

#### User Interface (UI)
- Pre-packaged Calls plugin [v1.2.0](https://github.com/mattermost/mattermost-plugin-calls/releases/tag/v1.2.0).
- Changed the logic of ``useMilitaryTime`` to ``false`` to default to 12-hour time format unless the user's preference from ``data.Value`` is ``true``. When a notification email is sent to a user, the time should now default to the 12-hour format unless otherwise stated by the user.
- A warning is now shown when deleting a post or comment from a remote/shared channel.
- Bot messages will now properly mention both users when they happen on non-bot Direct Messages.
- Updated the channel header to hide pinned posts when there aren't any in the channel.
- Added full support for @mentions in the values of fields in message attachments.

#### Administration
- Added a new URL parameter called ``permanent`` to ``DELETE /api/v4/posts/<post-id>``, and set ``permanent`` to ``true`` in order to permanently delete a post and its attachments.
- Added Shared Channels administration page to the System Console.
- Added a team selector to accept connection invite flow in Shared Workspaces.
- Restricted activation and deactivation of LDAP-managed users through both the System Admin Console UI and Mattermost API.
- Export/import improvements: added the ability to export all user preferences and flagged posts.
- Increased timeouts to fetch cluster logs.
- Improved log messages for cluster communication.
- Information about deleted rows from the Data Retention job are now logged.
- License details to logs are now emitted when added or removed.
- Added a new mmctl command, ``mmctl post delete <post-id>``, in order to permanently delete a post and its attachments.

#### Performance
- Added metrics to prometheus to check the mobile versions for each session daily.
- Improved the performance of LDAP sync jobs when group-contained teams and channels are used.
- Added minor improvements to notification metrics.
- Added minor improvements to mobile push notifications.

### Bug Fixes
- Fixed an issue with email notifications using 24-hour timestamps by default.
- Fixed an issue where bots were not ignored when counting deactivated accounts for statistics.
- Fixed an issue where drafts didn’t allow scrolling if the user had many drafts.
- Fixed an issue that caused Javascript errors in the System Console.
- Fixed racy use of session in ``NewWebConn``.
- Fixed a race condition that would happen after a server start if ``EnableTesting`` was enabled.
- Fixed an issue where no error message was shown when replying to a deleted post from the draft screen.
- Fixed an issue where the check icons were missing from the Sort and Show options in the Direct Messages tab, and the Sort tab of the Channels tab.
- Fixed desyncing issues with unreads between the team sidebar and the title bar.
- Fixed an issue with message export file attachments with dedicated filestore: when the dedicated filestore is set, file attachments will be found and exported correctly.

### config.json
New 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 ``ServiceSettings`` in ``config.json``:
- Added a new configuration setting ``EnableAPIPostDeletion`` in order to enable/disable post deletion. This configuration setting does not need to be enabled when running mmctl in local mode.
- Added ``EnableDesktopLandingPage`` to allow the desktop app landing page to be disabled.
- Under ``NativeAppSettings`` in ``config.json``:
- Added a configuration setting ``MobileExternalBrowser`` that tells the Mobile app to perform SSO Authentication using the external default browser.

### Go Version
- v10.2 is built with Go ``v1.22.6``.

### Known Issues
- Shared Channels: Direct Messages are not supported.
amyblais marked this conversation as resolved.
Show resolved Hide resolved
- 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.
- 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.

### Contributors
-

(release-v10.1-feature-release)=
## Release v10.1 - [Feature Release](https://docs.mattermost.com/about/release-policy.html#release-types)

Expand Down
2 changes: 1 addition & 1 deletion source/about/mattermost-v9-changelog.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# v9 changelog

```{Important}
Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) is coming to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is recommended.
Support for Mattermost Server v9.5 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) has come to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is required.
- Upgrading from ESR-to-ESR (``major`` -> ``major_next``) is fully supported and tested. However, upgrading from ESR-to-ESR (``major`` to ``major+2``) is supported, but not tested. If you plan to upgrade across multiple releases, we strongly recommend upgrading from an ESR to another ESR. For example, if you're upgrading from the v8.1 ESR, upgrade to the [v9.5 ESR](https://docs.mattermost.com/about/mattermost-v9-changelog.html#release-v9-5-extended-support-release) or the v9.11 ESR.
- See the [Important Upgrade Notes](https://docs.mattermost.com/upgrade/important-upgrade-notes.html) documentation for details on upgrading to a newer release.
- See the [changelog in progress](https://bit.ly/2nK3cVf) for details about the upcoming release.
Expand Down
12 changes: 6 additions & 6 deletions source/about/release-policy.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,13 +56,13 @@ gantt
v9.5 Extended Support :crit, 2024-02-16, 2024-11-15
v9.6 :done, 2024-03-16, 2024-06-15
v9.7 :done, 2024-04-16, 2024-07-15
v9.8 :active, 2024-05-15, 2024-08-15
v9.9 :active, 2024-06-16, 2024-09-15
v9.10 :active, 2024-07-16, 2024-10-15
v9.8 :done, 2024-05-15, 2024-08-15
v9.9 :done, 2024-06-16, 2024-09-15
v9.10 :done, 2024-07-16, 2024-10-15
v9.11 & Desktop App v5.9 Extended Support :crit, 2024-08-16, 2025-05-15
v10.0 :upcoming, 2024-09-16, 2024-12-15
v10.1 :upcoming, 2024-10-16, 2025-01-15
v10.2 :upcoming, 2024-11-16, 2025-02-15
v10.0 :active, 2024-09-16, 2024-12-15
v10.1 :active, 2024-10-16, 2025-01-15
v10.2 :active, 2024-11-15, 2025-02-15
v10.3 :upcoming, 2024-12-16, 2025-03-15

section 2025
Expand Down
2 changes: 1 addition & 1 deletion source/about/version-archive.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Version archive
:start-after: :nosearch:

.. important::
- Support for Mattermost Server v9.5 :ref:`Extended Support Release <about/release-policy:extended support releases>` is coming to the end of its life cycle in November 15, 2024. Upgrading to Mattermost Server v9.11 or later is recommended.
- Support for Mattermost Server v9.5 :ref:`Extended Support Release <about/release-policy:extended support releases>` has come to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is required.
- Note that our package signing key has been moved away from Keybase. If you still reference Keybase in your deployment steps for retrieving the key, update them to the new key location: https://deb.packages.mattermost.com/pubkey.gpg.
- If you want to check that the version of Mattermost you are installing is the official, unmodified version, compare the SHA-256 checksum or the file's GPG signature with the one published in this version archive. To verify the GPG signature of a Mattermost release, use the public key stored at the following URL: https://deb.packages.mattermost.com/pubkey.gpg.

Expand Down
2 changes: 1 addition & 1 deletion source/install/download-latest-tarball.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Using ``wget``, download the Mattermost Server release you want to install.

.. code-block:: sh

wget https://releases.mattermost.com/10.1.1/mattermost-10.1.1-linux-amd64.tar.gz
wget https://releases.mattermost.com/10.2.0/mattermost-10.2.0-linux-amd64.tar.gz

.. tab:: Current ESR

Expand Down
7 changes: 5 additions & 2 deletions source/upgrade/important-upgrade-notes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,18 +5,21 @@ Important Upgrade Notes
:start-after: :nosearch:

.. important::
- Support for Mattermost Server v9.5 :ref:`Extended Support Release <about/release-policy:extended support releases>` is coming to the end of its life cycle in November 15, 2024. Upgrading to Mattermost Server v9.11 or later is recommended.
- Support for Mattermost Server v9.5 :ref:`Extended Support Release <about/release-policy:extended support releases>` has come to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 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.
- Mattermost plugins built with Go versions 1.22.0 and 1.22.1 do not work. Plugin developers should use go 1.22.2 or newer instead.
- Keybase has stopped serving our Ubuntu repository signing key. If you were using it, update your installation scripts to retrieve the key as mentioned in our docs: https://docs.mattermost.com/install/install-ubuntu.html.
- Docker Content Trust (DCT) for signing Docker image artifacts will be replaced by Sigstore Cosign in our upcoming release, v10.2 (November, 2024). If you rely on artifact verification using DCT, please `transition to using Cosign <https://edu.chainguard.dev/open-source/sigstore/cosign/how-to-install-cosign/>`_. See the `upcoming DCT deprecation <https://forum.mattermost.com/t/upcoming-dct-deprecation/19275>`_ Mattermost forum post for more details.

+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| If you’re upgrading | Then... |
| from a version earlier than... | |
+====================================================+==================================================================================================================================================================+
| v10.2 | Docker Content Trust (DCT) for signing Docker image artifacts has been replaced by Sigstore Cosign in v10.2 (November, 2024). If you rely |
| | on artifact verification using DCT, please `transition to using Cosign <https://edu.chainguard.dev/open-source/sigstore/cosign/how-to-install-cosign/>`_. See |
| | the `upcoming DCT deprecation <https://forum.mattermost.com/t/upcoming-dct-deprecation/19275>`_ Mattermost forum post for more details. |
+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| v10.0 | We no longer support new installations using MySQL starting in v10. All new customers and/or deployments will only be supported with the minimum supported |
| | version of the PostgreSQL database. End of support for MySQL is targeted for Mattermost v11. |
| +------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Expand Down
Loading
Loading