From ef9fe66ed649c276c7712eb9bf1bec9ca811eb01 Mon Sep 17 00:00:00 2001 From: babolivier Date: Tue, 29 Mar 2022 09:41:41 +0000 Subject: deploy: b690fe749b5715f4c22b8a0a8640c264d8b94b3c --- v1.56/synctl_workers.html | 278 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 278 insertions(+) create mode 100644 v1.56/synctl_workers.html (limited to 'v1.56/synctl_workers.html') diff --git a/v1.56/synctl_workers.html b/v1.56/synctl_workers.html new file mode 100644 index 0000000000..dd11bb18d7 --- /dev/null +++ b/v1.56/synctl_workers.html @@ -0,0 +1,278 @@ + + + + + + Using synctl with Workers - Synapse + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + + +
+
+ +
+ +
+ +

Using synctl with workers

+

If you want to use synctl to manage your synapse processes, you will need to +create an an additional configuration file for the main synapse process. That +configuration should look like this:

+
worker_app: synapse.app.homeserver
+
+

Additionally, each worker app must be configured with the name of a "pid file", +to which it will write its process ID when it starts. For example, for a +synchrotron, you might write:

+
worker_pid_file: /home/matrix/synapse/worker1.pid
+
+

Finally, to actually run your worker-based synapse, you must pass synctl the -a +commandline option to tell it to operate on all the worker configurations found +in the given directory, e.g.:

+
synctl -a $CONFIG/workers start
+
+

Currently one should always restart all workers when restarting or upgrading +synapse, unless you explicitly know it's safe not to. For instance, restarting +synapse without restarting all the synchrotrons may result in broken typing +notifications.

+

To manipulate a specific worker, you pass the -w option to synctl:

+
synctl -w $CONFIG/workers/worker1.yaml restart
+
+ +
+ + +
+
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file -- cgit 1.4.1