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.

Sign up for GitHub

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

Jump to bottom

v9.1 changelog & docs #6662

Merged
merged 27 commits into from
Oct 13, 2023
Merged

v9.1 changelog & docs #6662

Show file tree
Hide file tree
Changes from 16 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
c1d0555
Update self-managed-changelog.md
amyblais Sep 27, 2023
f8048ff
Update self-managed-changelog.md
amyblais Sep 27, 2023
d13148e
Update self-managed-changelog.md
amyblais Sep 27, 2023
8030f80
Update download-latest-tarball.rst
amyblais Sep 27, 2023
c2de6c4
Update open-source-components.rst
amyblais Sep 27, 2023
1a2ae6f
Update release-lifecycle.rst
amyblais Sep 27, 2023
61286ad
Update important-upgrade-notes.rst
amyblais Sep 27, 2023
d85fc76
Update self-managed-changelog.md
amyblais Sep 27, 2023
38c7f86
Update self-managed-changelog.md
amyblais Sep 28, 2023
1718b74
Apply suggestions from code review
amyblais Sep 28, 2023
e946f1a
Update self-managed-changelog.md
amyblais Sep 28, 2023
93daef5
Update self-managed-changelog.md
amyblais Sep 28, 2023
dc53ace
Update self-managed-changelog.md
amyblais Sep 28, 2023
ca61a32
Update self-managed-changelog.md
amyblais Sep 28, 2023
03316d2
Add link
amyblais Sep 28, 2023
03d48f1
Update self-managed-changelog.md
amyblais Oct 2, 2023
c408612
Add contributors
amyblais Oct 2, 2023
d606274
Update self-managed-changelog.md
amyblais Oct 2, 2023
0416ac4
Update self-managed-changelog.md
amyblais Oct 3, 2023
ae80895
Update self-managed-changelog.md
amyblais Oct 5, 2023
c94e85b
Update known issues
amyblais Oct 6, 2023
29c8d0d
Update self-managed-changelog.md
amyblais Oct 6, 2023
0eb0d53
Merge branch 'v9.1-documentation' into amyblais-patch-13
amyblais Oct 6, 2023
8b5ef30
Update self-managed-changelog.md
amyblais Oct 6, 2023
4327785
Apply suggestions from code review
amyblais Oct 11, 2023
1f7fecf
Update self-managed-changelog.md
amyblais Oct 13, 2023
758de2c
Update self-managed-changelog.md
amyblais Oct 13, 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
2 changes: 1 addition & 1 deletion source/install/download-latest-tarball.rst
View file
Open in desktop
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.0.0/mattermost-9.0.0-linux-amd64.tar.gz
wget https://releases.mattermost.com/9.1.0/mattermost-9.1.0-linux-amd64.tar.gz
</code>
<span class="mm-code-copy__copied-notice">Copied to clipboard</span>
</div>
Expand Down
96 changes: 95 additions & 1 deletion source/install/self-managed-changelog.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,106 @@ See the [changelog in progress](https://bit.ly/2nK3cVf) for the upcoming release

Latest Mattermost Releases:

- [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 v8.0 - Major Release](#release-v8-0-major-release)
- [Release v7.10 - Feature Release](#release-v7-10-feature-release)
- [Release v7.8 - Extended Support Release](#release-v7-8-extended-support-release)

## Release v9.1 - [Feature Release](https://docs.mattermost.com/upgrade/release-definitions.html#feature-release)

**Release day: October 16, 2023**

### Important Upgrade Notes
- Improved performance on data retention ``DeleteOrphanedRows`` queries. See the [Important Upgrade Notes](https://docs.mattermost.com/upgrade/important-upgrade-notes.html) for notes on a new migration that was added. Removed feature flag ``DataRetentionConcurrencyEnabled``. Data retention now runs without concurrency in order to avoid any performance degradation. Added a new configuration setting ``DataRetentionSettings.RetentionIdsBatchSize``, which allows admins to to configure how many batches of IDs will be fetched at a time when deleting orphaned reactions. The default value is 100.

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

### Compatibility
- Updated Chromium minimum supported version to 116+.

### Improvements

#### User Interface (UI)
- Added a **Cancel** button to the **Delete category** modal.
- Added the ability to resize the channel sidebar and right-hand sidebar.
- Added two new filtering options (show all channel types and show private channels) to the **Browse channels** modal.
- Pre-packaged GitLab plugin version [v1.7.0](https://github.com/mattermost/mattermost-plugin-gitlab/releases/tag/v1.7.0).
- Pre-packaged Calls version v0.19.1.
- Added additional reaction options when viewing threads or messages when the sidebar is larger than its minimum width.
- Added a link to [notification documentation](https://docs.mattermost.com/preferences/manage-your-notifications.html) in the **Notification Settings** modal.
- Updated the post textbox measurement code to be more reliable.
- The ``/invite`` slash command now supports custom user groups.
- Re-enabled the remote marketplace functionality, when configured as per ``PluginSettings.EnableRemoteMarketplace`` [documentation](https://docs.mattermost.com/configure/plugins-configuration-settings.html#plugins-enableremotemarketplace).
- "Added the ability to convert a group message to a private channel.
- Group messages (GMs) now behave like direct messages (DMs). The badge count increases for every new message.

#### Administration
- Added ``mattermost-plugin-api`` into the mattermost repo.
amyblais marked this conversation as resolved.
Show resolved Hide resolved
- Updated the public server module version to v0.0.9.
- Added 2 new URL parameters to ``GET /api/v4/groups``: ``include_archived`` and ``filter_archived``. Added the ability to restore archived groups from the user groups modal.
- Added file storage information to the support package.
- A ``user_id`` is now included in all HTTP logs (debug level) to help determine who is generating unexpected traffic.
- Added new URL Parameter to ``GET /api/v4/groups`` and ``GET /api/v4/groups/:group_id``. ``include_member_ids`` will add all the members ``user_ids`` to the group response objects. You can now also add group members to a channel, any members that are not part of the team can be added to the team through this flow and subsequently added the channel.
amyblais marked this conversation as resolved.
Show resolved Hide resolved

#### Plugin Changes
- Added new frontend plugin extension point for the new messages separator bar.
- Added a new plugin extensibility point to add actions to the code blocks.
- Added the plugin hook ``UserHasBeenDeactivated``.
- Added a new server side plugin API method to set the searchable content for file info (``SetFileSearchableContent``). The ``MessageHasBeenPosted`` plugin hook is now executed after the attachments are linked to the post.

### Bug Fixes
- Fixed keyboard support for the left-hand side channel menu, the left-hand side category menu, and the post dot menu.
- Fixed display name in the ``comment_on`` component.
- Fixed an issue with keyboard support for some menus with submenus.
amyblais marked this conversation as resolved.
Show resolved Hide resolved
- Fixed an issue with disappearing punctuation when following a group mention.
- Fixed an issue where compliance export jobs were not able to start after disabling and enabling the compliance export.
- Fixed a potential read after write issue when loading a license.
- Fixed the API to block any changes to direct and group messages names, display name, or purpose.

### 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:
- Removed ``ServiceSettingsDefaultGfycatAPISecret`` and ``ServiceSettingsDefaultGfycatAPIKey`` configuration settings.
- Under ``TeamSettings`` in ``config.json``:
- Added a new config setting ``EnableJoinLeaveMessageByDefault`` that sets the default value for ``UserSetting``, ``ADVANCED_FILTER_JOIN_LEAVE``.
- Under ``DisplaySettings`` in ``config.json``:
- Added a setting ``MaxMarkdownNodes`` to limit the maximum complexity of markdown text on mobile.

#### Changes to Enterprise plan:
- Under ``DataRetentionSettings`` in ``config.json``:
- Added a new configuration setting ``RetentionIdsBatchSize``, which allows admins to to configure how many batches of IDs will be fetched at a time when deleting orphaned reactions. The default value is 100.

### API Changes
- Added the ``X-Forwarded-For`` request header to the audit stream for all Rest API calls.
- Added API endpoint ``POST /api/v4/user/login/desktop_login``. Modified OAuth/SAML flows to include ``desktop_login`` where applicable.
- Added new API endpoint ``GET`` ``/api/v4/channels/<channel-id>/common_teams`` to fetch list of teams common between members of a group message.
- Added new API endpoint ``POST`` ``/api/v4/channels/<channel-id>/convert_to_channel`` to convert a group message to a private channel.
- Added a new ``MessageHasBeenDeleted`` hook to the plugin API.
- Moved the ``request`` package into the public shared folder.

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

### Known Issues
- A known issue related to the new feature to convert a Group Message channel to a private channel [MM-54526](https://mattermost.atlassian.net/browse/MM-54526).
amyblais marked this conversation as resolved.
Show resolved Hide resolved
- ``/invite`` user to a channel incorrectly posts an ephemeral message of ``<no value> added to {channel_name} channel`` [MM-54555](https://mattermost.atlassian.net/browse/MM-54555).
- Left-hand side resize option overrides the **Browse/Create Channel** menu if To-Do plugin is installed [MM-54367](https://mattermost.atlassian.net/browse/MM-54367).
- 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).
- Google login fails on the Classic mobile apps.
- 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.0 - [Major Release](https://docs.mattermost.com/upgrade/release-definitions.html#major-release)

**Release day: September 15, 2023**
Expand Down
30 changes: 30 additions & 0 deletions source/upgrade/important-upgrade-notes.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,36 @@ Important Upgrade Notes
+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| If you’re upgrading from a version earlier than... | Then... |
+====================================================+==================================================================================================================================================================+
| v9.1 | In v9.1.0, improved performance on data retention ``DeleteOrphanedRows`` queries. |
| | |
| | New migration for a new table: |
| | |
| | MySQL: |
| | |
| | ``CREATE TABLE IF NOT EXISTS RetentionIdsForDeletion (`` |
| | ``Id varchar(26) NOT NULL,`` |
| | ``TableName varchar(64),`` |
| | ``Ids json,`` |
| | ``PRIMARY KEY (Id),`` |
| | ``KEY idx_retentionidsfordeletion_tablename (TableName)`` |
| | ``) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;`` |
| | |
| | PostgreSQL: |
| | |
| | ``CREATE TABLE IF NOT EXISTS retentionidsfordeletion (`` |
| | ``id varchar(26) PRIMARY KEY,`` |
| | ``tablename varchar(64),`` |
| | ``ids varchar(26)[]`` |
| | ``);`` |
| | ``CREATE INDEX IF NOT EXISTS idx_retentionidsfordeletion_tablename ON retentionidsfordeletion (tablename);`` |
| | |
| | Hard deleting a user or a channel will now also clean up associated reactions. |
| | |
| | Removed feature flag ``DataRetentionConcurrencyEnabled``. Data retention now runs without concurrency in order to avoid any performance degradation. |
| | |
| | Added a new configuration setting ``DataRetentionSettings.RetentionIdsBatchSize``, which allows admins to configure how many batches of IDs will be fetched at |
| | a time when deleting orphaned reactions. The default value is 100. |
+----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| v9.0 | Removed the deprecated Insights feature. |
| +------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| | Mattermost Boards and various other plugins have transitioned to being fully community supported. See this |
Expand Down
2 changes: 2 additions & 0 deletions source/upgrade/open-source-components.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ Desktop
Mobile
-------

- 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>`_.
- Mattermost Mobile v2.6.0 - `View Open Source Components <https://github.com/mattermost/mattermost-mobile/blob/release-2.6/NOTICE.txt>`_.
Expand Down Expand Up @@ -97,6 +98,7 @@ Mobile
Server
------------------------------

- 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>`_.
- Mattermost Enterprise Edition v8.0.0 - `View Open Source Components <https://github.com/mattermost/mattermost-server/blob/release-8.0/NOTICE.txt>`_.
Expand Down
2 changes: 2 additions & 0 deletions source/upgrade/release-lifecycle.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.2 | Feature | 2023-11-16 | 2024-02-15 | |
+-------------+-----------------------+--------------------------+--------------------------+--------------------------+
| 9.1 | Feature | 2023-10-16 | 2024-01-15 | |
+-------------+-----------------------+--------------------------+--------------------------+--------------------------+
| 9.0 | Major | 2023-09-16 | 2023-12-15 | |
Expand Down