Add comments to currently used visitor operation config parameters

Mark the remaining parameters as deprecated.

1 files changed, 31 insertions, 1 deletions

diff --git a/storage/src/vespa/storage/config/stor-visitordispatcher.def b/storage/src/vespa/storage/config/stor-visitordispatcher.def
index fcbafdd2aee..13466ab7cd5 100644
--- a/storage/src/vespa/storage/config/stor-visitordispatcher.def
+++ b/storage/src/vespa/storage/config/stor-visitordispatcher.def
@@ -1,13 +1,43 @@
 # Copyright 2016 Yahoo Inc. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
 namespace=vespa.config.content.core
 
+# For any given client visitor operation, this specifies a maximum fan-out
+# factor for concurrent content node visitor operations towards a particular
+# content node.
+# Having several visitor operations running concurrently increases the
+# potential data processing parallelism on the content nodes at the expense
+# of using additional resources.
 maxvisitorspernodeperclientvisitor int default=4
+
+# Minimum number of buckets that have to be present on a given content node
+# before more than one visitor operation may be sent in parallel towards it.
+# This config is directly related to maxvisitorspernodeperclientvisitor.
+# Example: with max visitors of 4, min buckets of 5 and total of 40 buckets on
+# a content node, a total of 4 visitors of 10 buckets each will be sent to the
+# node. If min buckets were 20, only 2 visitors of 20 buckets each would be
+# sent.
 minbucketspervisitor int default=5
+
+# Deprecated - not in use
+storagenetworklatency int default=2
+
+# Deprecated - not in use
 maxbucketspervisitor int default=100
+
+# Deprecated - not in use
 minpendingperstoragevisitor int default=2
+
+# Deprecated - not in use
 minsuperbucketsactive int default=50
+
+# Deprecated - not in use
 minsubbucketsactive int default=10000
-storagenetworklatency int default=2
+
+# Deprecated - not in use
 progresstimeout int default=180000
+
+# Deprecated - not in use
 highprioritylimit int default=600000
+
+# Deprecated - not in use
 veryhighprioritylimit int default=60000