Update database connection pool defaults for MM-63726 #8259

lieut-data · 2025-07-30T16:26:44Z

Summary

Updates documentation to reflect the v11 breaking changes from MM-63726:

MaxOpenConns default changed from 300 to 100
MaxIdleConns default changed from 20 to 50 (implementing 2:1 ratio)
Moved MaxIdleConns from deprecated back to active configuration settings

This also corrects #7122 which incorrectly marked the MaxIdleConns setting as deprecated.

Implementation: mattermost/mattermost#33593

Test plan

Updated environment configuration settings documentation
Removed deprecated MaxIdleConns section
Updated high availability deployment example
Verified no other references to old default values remain

- Update MaxOpenConns default from 300 to 100 - Update MaxIdleConns default from 20 to 50 - Move MaxIdleConns from deprecated to active configuration settings - Update high availability deployment example configuration - Remove deprecated MaxIdleConns section as it's no longer deprecated This implements the v11 breaking changes to adjust database connection pool settings to use a safer 2:1 ratio (MaxOpenConns:MaxIdleConns).

lieut-data · 2025-07-30T16:27:38Z

source/configure/deprecated-configuration-settings.rst

 | This feature's ``config.json`` setting is ``"StreamingPort": ":8075"`` with string input. |
 +-------------------------------------------------------------------------------------------+

-Maximum idle database connections


This setting was incorrectly marked as deprecated in #7122.

github-actions · 2025-07-30T16:29:56Z

Newest code from mattermost has been published to preview environment for Git SHA c759155

…abase-connection-defaults

lieut-data · 2025-07-31T17:53:35Z

@cwarnermm, I remember your teaching me about a branch for upcoming changes, but I regret I can't remember what to do here. Is there a v11 branch I should be using?

github-actions · 2025-07-31T17:55:59Z

Newest code from mattermost has been published to preview environment for Git SHA 91147f9

cwarnermm · 2025-07-31T18:02:38Z

@lieut-data - Release management creates a new monthly release branch following each monthly release on the 16th.

There's a v10.11-documentation branch for v10.11-specific docs updates, but a v11.0-documentation branch isn't yet available. For v11-specific docs updates, including deprecations, I recommend adding the v11.0 milestone instead to applicable PRs. That's sufficient visibility for the time being until a v11.0-documentation branch is created by release management.

github-actions · 2025-07-31T18:02:41Z

Newest code from mattermost has been published to preview environment for Git SHA 92712a2

github-actions · 2025-07-31T18:06:51Z

Newest code from mattermost has been published to preview environment for Git SHA 2d24c39

github-actions · 2025-08-11T17:08:45Z

Newest code from mattermost has been published to preview environment for Git SHA fdf7dfa

isacikgoz

LGTM, I was looking at the preview and wondering how useful would it be to explain when to change these values (not only the ones in the PR). It may look a bit verbose but as it is, this doesn't look helpful IMHO.

github-actions · 2025-08-14T12:39:51Z

Newest code from mattermost has been published to preview environment for Git SHA 0761e82

lieut-data · 2025-08-14T14:00:24Z

You're right, @isacikgoz -- an addition to https://docs.mattermost.com/administration-guide/scale/scaling-for-enterprise.html might be an excellent place to document how to effectively use these parameters, but I fear I don't currently know how to codify that knowledge. I think the defaults here inch us towards a better initial experience, but will still require expertise for the particular system being deployed.

github-actions · 2025-08-14T14:03:46Z

Newest code from mattermost has been published to preview environment for Git SHA 70df772

* Update SAML encryption documentation for AES-256-GCM support - Add clarification that AES-256-GCM encryption support was introduced in v10.9 and backported to v10.6.5 - Include backwards compatibility messaging that existing SAML integrations continue working without changes - Note that only customers wanting to use AES-256-GCM keys need to update their configuration - Update main SAML SSO documentation to reference new encryption support - Update technical documentation to include version information Resolves #8349 🤖 Generated with [Claude Code](https://claude.ai/code) Co-authored-by: Carrie Warner (Mattermost) <[email protected]> * Update source/administration-guide/onboard/sso-saml-technical.rst Co-authored-by: Ben Schumacher <[email protected]> * Update source/administration-guide/onboard/sso-saml.rst Co-authored-by: Ben Schumacher <[email protected]> * Update source/deployment-guide/encryption-options.rst * Update source/deployment-guide/encryption-options.rst * Minor updates based on reviewer feedback --------- Co-authored-by: claude[bot] <209825114+claude[bot]@users.noreply.github.com> Co-authored-by: Carrie Warner (Mattermost) <[email protected]> Co-authored-by: Ben Schumacher <[email protected]>

* Add references to Azure Local * Editorial review updates --------- Co-authored-by: Carrie Warner (Mattermost) <[email protected]>

* docs: Update v10.5.11 dot release documentation - Added v10.5.11 changelog entry with security fixes notice - Updated server releases table to reference v10.5.11 downloads and SBOMs - Updated version archive for both Enterprise and Team editions 🤖 Generated with [Claude Code](https://claude.ai/code) Co-authored-by: Amy Blais <[email protected]> * Update mattermost-v10-changelog.md * Update version-archive.rst --------- Co-authored-by: claude[bot] <209825114+claude[bot]@users.noreply.github.com> Co-authored-by: Amy Blais <[email protected]> Co-authored-by: Carrie Warner (Mattermost) <[email protected]>

* Update docs for Desktop v5.13.1 release - Updated download links and version references from v5.13.0 to v5.13.1 - Added v5.13.1 changelog entry as patch release - Updated installation instructions for all platforms 🤖 Generated with [Claude Code](https://claude.ai/code) Co-authored-by: Amy Blais <[email protected]> * Update desktop-app-changelog.md * Update desktop-msi-installer-and-group-policy-install.rst * Update desktop-msi-installer-and-group-policy-install.rst * Update desktop-app-changelog.md * Update desktop-app-changelog.md * Update desktop-app-changelog.md --------- Co-authored-by: claude[bot] <209825114+claude[bot]@users.noreply.github.com> Co-authored-by: Amy Blais <[email protected]>

* Update deprecated-features.rst * Update deprecated-features.rst * Update deprecated-features.rst * Update deprecated-features.rst * Update source/product-overview/deprecated-features.rst * Update source/product-overview/deprecated-features.rst Co-authored-by: Alejandro García Montoro <[email protected]> --------- Co-authored-by: Carrie Warner (Mattermost) <[email protected]> Co-authored-by: Alejandro García Montoro <[email protected]>

* Environmental config setting consistency & normalization script * Fixed malformed tables * Config consistency & malformed table fixes * Removed helper script

* Update faq-business.rst Review and refinement * Update source/product-overview/faq-business.rst * Update faq-license.rst Removed redundant information, linking to single source * Update faq-business.rst * Update faq-business.rst * Update faq-license.rst Combined Business & Licensing since the pages covered redundant questions. * Delete source/product-overview/faq-business.rst Moved content to License FAQ & renamed * Added page redirect & child page nav * Incorporated reviewer feedback * Update faq-general.rst * Delete source/product-overview/faq-illicit-use.rst * Cleaned up nav following content moves --------- Co-authored-by: Carrie Warner (Mattermost) <[email protected]>

* Update v9.x releases to legacy status - Remove v9.x versions from active release table in mattermost-server-releases.md - Move v9 changelog content to unsupported-legacy-releases.md - Update release-policy.md to include v9.x in legacy releases table - Replace v9 changelog with redirect to unsupported legacy releases - Update references to point to legacy releases documentation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-authored-by: Amy Blais <[email protected]> * Update unsupported-legacy-releases.md * Update mattermost-server-releases.md * Update mattermost-v9-changelog.md * Update server.rst * Update common-esr-support-upgrade.md * Update unsupported-legacy-releases.md * Update prepare-to-upgrade-mattermost.rst * Update prepare-to-upgrade-mattermost.rst * Update prepare-to-upgrade-mattermost.rst * Update prepare-to-upgrade-mattermost.rst * Update prepare-to-upgrade-mattermost.rst * Update prepare-to-upgrade-mattermost.rst * Update common-esr-support-upgrade.md * Update common-esr-support-upgrade.md * Update release-policy.md * Update prepare-to-upgrade-mattermost.rst --------- Co-authored-by: claude[bot] <209825114+claude[bot]@users.noreply.github.com> Co-authored-by: Amy Blais <[email protected]> Co-authored-by: Carrie Warner (Mattermost) <[email protected]> Co-authored-by: Sven Hüster <[email protected]>

* Update deprecated-features.rst * Update common-esr-support-upgrade.md * Update release-policy.md

* Moved client availability page to end user guide * Returned headings to tabbed content with toctree pages

github-actions · 2025-09-15T14:29:57Z

Newest code from mattermost has been published to preview environment for Git SHA 3ec9942

lieut-data commented Jul 30, 2025

View reviewed changes

lieut-data requested a review from agnivade July 30, 2025 16:28

lieut-data marked this pull request as ready for review July 30, 2025 16:29

lieut-data added the 1: Dev Review Requires review by a core commiter label Jul 30, 2025

agnivade approved these changes Jul 31, 2025

View reviewed changes

Merge remote-tracking branch 'origin/master' into mm-63726-update-dat…

91147f9

…abase-connection-defaults

rst magic?

92712a2

lieut-data added this to the v11.0 milestone Jul 31, 2025

more magic

2d24c39

cwarnermm added 3: Reviews Complete All reviewers have approved the pull request and removed 1: Dev Review Requires review by a core commiter labels Jul 31, 2025

cwarnermm added Guidance Do Not Merge/Awaiting Next Release To be merged with the next release (e.g. API documentation updates) labels Aug 1, 2025

lieut-data requested a review from isacikgoz August 11, 2025 17:05

lieut-data removed the Do Not Merge/Awaiting Next Release To be merged with the next release (e.g. API documentation updates) label Aug 11, 2025

Merge branch 'master' into mm-63726-update-database-connection-defaults

fdf7dfa

lieut-data added the Do Not Merge/Awaiting Next Release To be merged with the next release (e.g. API documentation updates) label Aug 11, 2025

isacikgoz approved these changes Aug 14, 2025

View reviewed changes

Merge branch 'master' into mm-63726-update-database-connection-defaults

0761e82

Merge branch 'master' into mm-63726-update-database-connection-defaults

70df772

cwarnermm and others added 14 commits September 10, 2025 09:18

Add references to Azure Local (#8367)

1ed8c71

* Add references to Azure Local * Editorial review updates --------- Co-authored-by: Carrie Warner (Mattermost) <[email protected]>

Environmental config setting consistency (#8368)

5875b45

* Environmental config setting consistency & normalization script * Fixed malformed tables * Config consistency & malformed table fixes * Removed helper script

Update deprecated-features.rst (#8387)

5abeabc

* Update deprecated-features.rst * Update common-esr-support-upgrade.md * Update release-policy.md

Linked experimental config settings to feature label desc (#8388)

f57db3f

Removed v9 changlog, added redirect (#8389)

e0b0ab0

Moved client availability page to end user guide (#8390)

c0827c7

* Moved client availability page to end user guide * Returned headings to tabbed content with toctree pages

remove apache2 docs (#8391)

8762d5c

Merge branch 'master' into mm-63726-update-database-connection-defaults

3ec9942

cwarnermm changed the base branch from master to v11.0-documentation September 15, 2025 14:26

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Update database connection pool defaults for MM-63726 #8259

Update database connection pool defaults for MM-63726 #8259

Uh oh!

lieut-data commented Jul 30, 2025 •

edited by atlassian bot

Loading

Uh oh!

lieut-data Jul 30, 2025

Uh oh!

github-actions bot commented Jul 30, 2025

Uh oh!

lieut-data commented Jul 31, 2025

Uh oh!

github-actions bot commented Jul 31, 2025

Uh oh!

cwarnermm commented Jul 31, 2025

Uh oh!

github-actions bot commented Jul 31, 2025

Uh oh!

github-actions bot commented Jul 31, 2025

Uh oh!

github-actions bot commented Aug 11, 2025

Uh oh!

isacikgoz left a comment

Uh oh!

github-actions bot commented Aug 14, 2025

Uh oh!

lieut-data commented Aug 14, 2025

Uh oh!

github-actions bot commented Aug 14, 2025

Uh oh!

github-actions bot commented Sep 15, 2025

Uh oh!

Uh oh!

Update database connection pool defaults for MM-63726 #8259

Are you sure you want to change the base?

Update database connection pool defaults for MM-63726 #8259

Uh oh!

Conversation

lieut-data commented Jul 30, 2025 • edited by atlassian bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

lieut-data Jul 30, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Jul 30, 2025

Uh oh!

lieut-data commented Jul 31, 2025

Uh oh!

github-actions bot commented Jul 31, 2025

Uh oh!

cwarnermm commented Jul 31, 2025

Uh oh!

github-actions bot commented Jul 31, 2025

Uh oh!

github-actions bot commented Jul 31, 2025

Uh oh!

github-actions bot commented Aug 11, 2025

Uh oh!

isacikgoz left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Aug 14, 2025

Uh oh!

lieut-data commented Aug 14, 2025

Uh oh!

github-actions bot commented Aug 14, 2025

Uh oh!

github-actions bot commented Sep 15, 2025

Uh oh!

Uh oh!

lieut-data commented Jul 30, 2025 •

edited by atlassian bot

Loading