You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@james.apache.org by bt...@apache.org on 2020/10/16 03:54:35 UTC
[james-project] 03/06: JAMES-3428 Document read-repairs for mailbox
counters
This is an automated email from the ASF dual-hosted git repository.
btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git
commit 01d79e36f74eece1dba7e2446aa71daf7029dad3
Author: Benoit Tellier <bt...@linagora.com>
AuthorDate: Wed Oct 14 14:25:45 2020 +0700
JAMES-3428 Document read-repairs for mailbox counters
---
CHANGELOG.md | 1 +
.../servers/pages/distributed/configure/cassandra.adoc | 14 ++++++++++++++
src/site/xdoc/server/config-cassandra.xml | 10 ++++++++++
3 files changed, 25 insertions(+)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 89b2e5e..790db3d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,6 +15,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
- JAMES-3202 Reindex only outdated documents with the Mode option set to CORRECT in reindexing tasks
- JAMES-3405 Expose metrics of Guice servers over HTTP - enables easy Prometheus metrics collection
- JAMES-3407 Distributed server: Read-repairs for the mailbox entity
+- JAMES-3428 Distributed server: Read-repairs for the mailbox counters entity
### Changed
- Switch to Java 11 for build and run
diff --git a/docs/modules/servers/pages/distributed/configure/cassandra.adoc b/docs/modules/servers/pages/distributed/configure/cassandra.adoc
index d4bdafe..3439948 100644
--- a/docs/modules/servers/pages/distributed/configure/cassandra.adoc
+++ b/docs/modules/servers/pages/distributed/configure/cassandra.adoc
@@ -139,6 +139,20 @@ If you want more explanation about Cassandra configuration, you should visit the
| Optional. Defaults to 0.1 (10% chance).
Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox read.
+| mailbox.read.repair.chance
+| Optional. Defaults to 0.1 (10% chance).
+Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox read.
+
+| mailbox.counters.read.repair.chance.max
+| Optional. Defaults to 0.1 (10% chance).
+Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox counters read.
+Formula: read_repair_chance = min(mailbox.counters.read.repair.chance.max, (100/unseens)*mailbox.counters.read.repair.chance.one.hundred)
+
+| mailbox.counters.read.repair.chance.one.hundred
+| Optional. Defaults to 0.01 (1% chance).
+Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox counters read.
+Formula: read_repair_chance = min(mailbox.counters.read.repair.chance.max, (100/unseens)*mailbox.counters.read.repair.chance.one.hundred)
+
| mailbox.max.retry.acl
| Optional. Defaults to 1000.
Controls the number of retries upon Cassandra ACL updates.
diff --git a/src/site/xdoc/server/config-cassandra.xml b/src/site/xdoc/server/config-cassandra.xml
index 23280c4..a8e2470 100644
--- a/src/site/xdoc/server/config-cassandra.xml
+++ b/src/site/xdoc/server/config-cassandra.xml
@@ -120,6 +120,16 @@
<dt><strong>mailbox.read.repair.chance</strong></dt>
<dd>Optional. Defaults to 0.1 (10% chance).<br/> Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox read.</dd>
+ <dt><strong>mailbox.counters.read.repair.chance.max</strong></dt>
+ <dd>Optional. Defaults to 0.1 (10% chance).<br/>
+ Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox counters read.<br/>
+ Formula: read_repair_chance = min(mailbox.counters.read.repair.chance.max, (100/unseens)*mailbox.counters.read.repair.chance.one.hundred)
+ </dd>
+ <dt><strong>mailbox.counters.read.repair.chance.one.hundred</strong></dt>
+ <dd>Optional. Defaults to 0.01 (1% chance).<br/>
+ Must be between 0 and 1 (inclusive). Controls the probability of doing a read-repair upon mailbox counters read.<br/>
+ Formula: read_repair_chance = min(mailbox.counters.read.repair.chance.max, (100/unseens)*mailbox.counters.read.repair.chance.one.hundred)
+ </dd>
<dt><strong>mailbox.max.retry.acl</strong></dt>
<dd>Optional. Defaults to 1000.<br/> Controls the number of retries upon Cassandra ACL updates.</dd>
<dt><strong>mailbox.max.retry.modseq</strong></dt>
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org