Explain how to set index.numStripedLocks Tuning the value is quite an empirical process, there is no formula to find the correct setting. Change-Id: I2ddef3eca44b325d3467ebc213ed6e1b52223ed0
diff --git a/src/main/resources/Documentation/config.md b/src/main/resources/Documentation/config.md index 68fa8eb..482d301 100644 --- a/src/main/resources/Documentation/config.md +++ b/src/main/resources/Documentation/config.md
@@ -180,7 +180,11 @@ Defaults to true. ```index.numStripedLocks``` -: Number of striped locks to use during reindexing. +: Number of striped locks to use during reindexing. Should be of the same order + of magnitude of the open changes. I.e.: if one has 5000 changes, one might want + to have at least 1000 striped locks. The value has to be tuned empirically + by checking the number of failures in acquiring the locking. Checking the + `consider increasing the number of shards` warnings should help. Defaults to 10. ```index.synchronize```