From a554af368e984fd9c657a1f6bc425d5ae07a5b29 Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Fri, 3 Sep 2021 19:13:42 +0200 Subject: document new s aggregator sharding --- manpages/taler-exchange-aggregator.1.rst | 4 ++++ manpages/taler.conf.5.rst | 3 +++ 2 files changed, 7 insertions(+) diff --git a/manpages/taler-exchange-aggregator.1.rst b/manpages/taler-exchange-aggregator.1.rst index cf8f3edb..4a15c227 100644 --- a/manpages/taler-exchange-aggregator.1.rst +++ b/manpages/taler-exchange-aggregator.1.rst @@ -27,6 +27,10 @@ Description to the same merchant into larger wire transfers. The actual transfers are then done by **taler-exchange-transfer**. +The AGGREGATOR_SHARD_SIZE option can be used to allow multiple aggregator processes to run in parallel and share the load. This is only recommended if a single aggregator is insufficient for the workload. + +The aggregator uses a special table to lock shards it is working on. If an aggregator process dies (say due to a power failure), these shard locks may prevent the aggregator from resuming normally. In this case, you must run "taler-exchange-dbinit -s" to release the shard locks before restarting the aggregator. + **-c** *FILENAME* \| **--config=**\ ‌\ *FILENAME* Use the configuration and other resources for the exchange to operate from *FILENAME*. diff --git a/manpages/taler.conf.5.rst b/manpages/taler.conf.5.rst index ee67358e..0aa24e22 100644 --- a/manpages/taler.conf.5.rst +++ b/manpages/taler.conf.5.rst @@ -119,6 +119,9 @@ AGGREGATOR_IDLE_SLEEP_INTERVAL For how long should the aggregator sleep when it is idle before trying to look for more work? Default is 60 seconds. +AGGREGATOR_SHARD_SIZE + Which share of the range from [0,..2147483648] should be processed by one of the shards of the aggregator. Useful only for Taler exchanges with ultra high-performance needs. When changing this value, you must stop all aggregators and run "taler-exchange-dbinit -s" before resuming. Default is 2147483648 (no sharding). + SIGNKEY_LEGAL_DURATION For how long are signatures with signing keys legally valid? -- cgit v1.2.3