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 19 commits into
base: v10.2-documentation
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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 bee 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 in 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
75 changes: 74 additions & 1 deletion source/about/mattermost-v10-changelog.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,85 @@
# 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 except 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 at-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.
- 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.

### 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
- 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 in 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 in 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