From 536d946adaee235adcfcb35e544795b707dc67fc Mon Sep 17 00:00:00 2001 From: Erik Johnston Date: Mon, 2 Nov 2020 21:17:20 +0000 Subject: [PATCH 1/3] Document how to set up multiple event persisters --- docs/workers.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/workers.md b/docs/workers.md index eb47b1eb7008..214fb47e4718 100644 --- a/docs/workers.md +++ b/docs/workers.md @@ -319,6 +319,18 @@ stream_writers: events: event_persister1 ``` +The `events` stream also experimentally supports having multiple writers, where +work is sharded between them by room ID. Note that you *must* restart all +instances when adding or removing event persisters. An example `stream_writers` +configuration with multiple writers: + +```yaml +stream_writers: + events: + - event_persister1 + - event_persister2 +``` + #### Background tasks There is also *experimental* support for moving background tasks to a separate From 2b57c0aa9201ab76edc6b63998e4c00c718a502e Mon Sep 17 00:00:00 2001 From: Erik Johnston Date: Mon, 2 Nov 2020 21:18:45 +0000 Subject: [PATCH 2/3] Newsfile --- changelog.d/8706.doc | 1 + 1 file changed, 1 insertion(+) create mode 100644 changelog.d/8706.doc diff --git a/changelog.d/8706.doc b/changelog.d/8706.doc new file mode 100644 index 000000000000..96a0427e7354 --- /dev/null +++ b/changelog.d/8706.doc @@ -0,0 +1 @@ +Document experimental support for running multiple event persisters. From f346661a28bcb13e2a0da64a3bfe46502f7537b6 Mon Sep 17 00:00:00 2001 From: Erik Johnston Date: Tue, 3 Nov 2020 10:23:02 +0000 Subject: [PATCH 3/3] Fixup wording --- docs/workers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/workers.md b/docs/workers.md index 214fb47e4718..53a2179a7406 100644 --- a/docs/workers.md +++ b/docs/workers.md @@ -320,7 +320,7 @@ stream_writers: ``` The `events` stream also experimentally supports having multiple writers, where -work is sharded between them by room ID. Note that you *must* restart all +work is sharded between them by room ID. Note that you *must* restart all worker instances when adding or removing event persisters. An example `stream_writers` configuration with multiple writers: