From: Kotresh HR <khiremat@redhat.com>
Date: Wed, 16 Aug 2023 06:45:36 +0000 (+0530)
Subject: doc: Fix doc for mds cap acquisition throttle
X-Git-Tag: v18.2.1~377^2
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=a7c8ac7f48cd26975b1d2ae84fda244b18efcc2a;p=ceph.git

doc: Fix doc for mds cap acquisition throttle

The config values picks the definition from the
description. Removed the duplicate description
in the doc.

Signed-off-by: Kotresh HR <khiremat@redhat.com>
(cherry picked from commit 65b0e45dd702fdedcf66f64dd6c5b8ae11df430b)
---

diff --git a/doc/cephfs/cache-configuration.rst b/doc/cephfs/cache-configuration.rst
index 19cf41433198..3fc757005d1a 100644
--- a/doc/cephfs/cache-configuration.rst
+++ b/doc/cephfs/cache-configuration.rst
@@ -154,14 +154,8 @@ readdir. The behavior of the decay counter is the same as for cache trimming or
 caps recall. Each readdir call increments the counter by the number of files in
 the result.
 
-The ratio of ``mds_max_caps_per_client`` that client must exceed before readdir
-maybe throttled by cap acquisition throttle:
-
 .. confval:: mds_session_max_caps_throttle_ratio
 
-The timeout in seconds after which a client request is retried due to cap
-acquisition throttling:
-
 .. confval:: mds_cap_acquisition_throttle_retry_request_timeout
 
 If the number of caps acquired by the client per session is greater than the
diff --git a/src/common/options/mds.yaml.in b/src/common/options/mds.yaml.in
index eeb895615d6a..44a07941f617 100644
--- a/src/common/options/mds.yaml.in
+++ b/src/common/options/mds.yaml.in
@@ -345,10 +345,10 @@ options:
   type: float
   level: advanced
   desc: decay rate for session readdir caps leading to readdir throttle
-  long_desc: The half-life for the session cap acquisition counter of caps acquired
-    by readdir. This is used for throttling readdir requests from clients slow to
-    release caps.
-  default: 10
+  long_desc: The half-life for the session cap acquisition counter of caps
+    acquired by readdir. This is used for throttling readdir requests from
+    clients.
+  default: 30
   services:
   - mds
   flags:
@@ -356,8 +356,8 @@ options:
 - name: mds_session_cap_acquisition_throttle
   type: uint
   level: advanced
-  desc: throttle point for cap acquisition decay counter
-  default: 500000
+  desc: threshold at which the cap acquisition decay counter throttles
+  default: 100000
   services:
   - mds
 - name: mds_session_max_caps_throttle_ratio