Skip to content

Commit

Permalink
Clarify use of read replicas
Browse files Browse the repository at this point in the history
The docs suggest that reads are evenly distributed between the master DB and the read replica DBs. Based on both the server code and the observed behaviour, I do not believe that is the case - I believe that (if any read replicas are available) read queries are distributed among the read replicas only. This is a useful distinction to keep in mind for site admins.
  • Loading branch information
grubbins authored Aug 17, 2023
1 parent 2b83bab commit 0937635
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion source/scale/high-availability-cluster.rst
Original file line number Diff line number Diff line change
Expand Up @@ -214,7 +214,7 @@ Migrating to NAS or S3 from local storage is beyond the scope of this document.
Database configuration
^^^^^^^^^^^^^^^^^^^^^^

Use the read replica feature to scale the database. The Mattermost server can be set up to use one master database and multiple read replica databases. Mattermost distributes read requests across all databases, and sends write requests to the master database, and those changes are then sent to update the read replicas.
Use the read replica feature to scale the database. The Mattermost server can be set up to use one master database and multiple read replica databases. Mattermost distributes read requests across all read replica databases, and sends write requests to the master database, and those changes are then sent to update the read replicas.

On large deployments, consider using the search replica feature to isolate search queries onto one or more database servers. A search replica is similar to a read replica, but is used only for handling search queries.

Expand Down

0 comments on commit 0937635

Please sign in to comment.