5 ``mon force standby active``
7 :Description: If ``true`` monitors force standby-replay to be active. Set
8 under ``[mon]`` or ``[global]``.
16 :Description: The maximum allowed file size to set when creating a
19 :Type: 64-bit Integer Unsigned
20 :Default: ``1ULL << 40``
25 :Description: The number of inodes to cache.
32 :Description: The insertion point for new items in the cache LRU
39 ``mds dir commit ratio``
41 :Description: The fraction of directory that is dirty before Ceph commits using
42 a full update (instead of partial update).
48 ``mds dir max commit size``
50 :Description: The maximum size of a directory update before Ceph breaks it into
51 smaller transactions) (MB).
57 ``mds decay halflife``
59 :Description: The half-life of MDS cache temperature.
63 ``mds beacon interval``
65 :Description: The frequency (in seconds) of beacon messages sent
74 :Description: The interval without beacons before Ceph declares an MDS laggy
75 (and possibly replace it).
81 ``mds blacklist interval``
83 :Description: The blacklist duration for failed MDSs in the OSD map.
85 :Default: ``24.0*60.0``
88 ``mds session timeout``
90 :Description: The interval (in seconds) of client inactivity before Ceph
91 times out capabilities and leases.
97 ``mds session autoclose``
99 :Description: The interval (in seconds) before Ceph closes
100 a laggy client's session.
106 ``mds reconnect timeout``
108 :Description: The interval (in seconds) to wait for clients to reconnect
115 ``mds tick interval``
117 :Description: How frequently the MDS performs internal periodic tasks.
122 ``mds dirstat min interval``
124 :Description: The minimum interval (in seconds) to try to avoid propagating
125 recursive stats up the tree.
130 ``mds scatter nudge interval``
132 :Description: How quickly dirstat changes propagate up.
137 ``mds client prealloc inos``
139 :Description: The number of inode numbers to preallocate per client session.
140 :Type: 32-bit Integer
146 :Description: Determines whether the MDS should allow clients to see request
147 results before they commit to the journal.
155 :Description: Use trivialmap for directory updates.
160 ``mds default dir hash``
162 :Description: The function to use for hashing files across directory fragments.
163 :Type: 32-bit Integer
164 :Default: ``2`` (i.e., rjenkins)
167 ``mds log skip corrupt events``
169 :Description: Determines whether the MDS should try to skip corrupt journal
170 events during journal replay.
176 ``mds log max events``
178 :Description: The maximum events in the journal before we initiate trimming.
179 Set to ``-1`` to disable limits.
181 :Type: 32-bit Integer
185 ``mds log max segments``
187 :Description: The maximum number of segments (objects) in the journal before
188 we initiate trimming. Set to ``-1`` to disable limits.
190 :Type: 32-bit Integer
194 ``mds log max expiring``
196 :Description: The maximum number of segments to expire in parallels
197 :Type: 32-bit Integer
201 ``mds log eopen size``
203 :Description: The maximum number of inodes in an EOpen event.
204 :Type: 32-bit Integer
208 ``mds bal sample interval``
210 :Description: Determines how frequently to sample directory temperature
211 (for fragmentation decisions).
217 ``mds bal replicate threshold``
219 :Description: The maximum temperature before Ceph attempts to replicate
220 metadata to other nodes.
226 ``mds bal unreplicate threshold``
228 :Description: The minimum temperature before Ceph stops replicating
229 metadata to other nodes.
237 :Description: Determines whether the MDS will fragment directories.
242 ``mds bal split size``
244 :Description: The maximum directory size before the MDS will split a directory
245 fragment into smaller bits.
247 :Type: 32-bit Integer
253 :Description: The maximum directory read temperature before Ceph splits
254 a directory fragment.
262 :Description: The maximum directory write temperature before Ceph splits
263 a directory fragment.
269 ``mds bal split bits``
271 :Description: The number of bits by which to split a directory fragment.
272 :Type: 32-bit Integer
276 ``mds bal merge size``
278 :Description: The minimum directory size before Ceph tries to merge
279 adjacent directory fragments.
281 :Type: 32-bit Integer
287 :Description: The frequency (in seconds) of workload exchanges between MDSs.
288 :Type: 32-bit Integer
292 ``mds bal fragment interval``
294 :Description: The delay (in seconds) between a fragment being elegible for split
295 or merge and executing the fragmentation change.
296 :Type: 32-bit Integer
300 ``mds bal fragment fast factor``
302 :Description: The ratio by which frags may exceed the split size before
303 a split is executed immediately (skipping the fragment interval)
307 ``mds bal fragment size max``
309 :Description: The maximum size of a fragment before any new entries
310 are rejected with ENOSPC.
311 :Type: 32-bit Integer
314 ``mds bal idle threshold``
316 :Description: The minimum temperature before Ceph migrates a subtree
325 :Description: The number of iterations to run balancer before Ceph stops.
326 (used for testing purposes only)
328 :Type: 32-bit Integer
332 ``mds bal max until``
334 :Description: The number of seconds to run balancer before Ceph stops.
335 (used for testing purposes only)
337 :Type: 32-bit Integer
343 :Description: The method for calculating MDS load.
346 - ``1`` = Request rate and latency.
349 :Type: 32-bit Integer
353 ``mds bal min rebalance``
355 :Description: The minimum subtree temperature before Ceph migrates.
360 ``mds bal min start``
362 :Description: The minimum subtree temperature before Ceph searches a subtree.
369 :Description: The minimum fraction of target subtree size to accept.
376 :Description: The maximum fraction of target subtree size to accept.
383 :Description: Ceph will migrate any subtree that is larger than this fraction
384 of the target subtree size.
392 :Description: Ceph will ignore any subtree that is smaller than this fraction
393 of the target subtree size.
399 ``mds bal target removal min``
401 :Description: The minimum number of balancer iterations before Ceph removes
402 an old MDS target from the MDS map.
404 :Type: 32-bit Integer
408 ``mds bal target removal max``
410 :Description: The maximum number of balancer iteration before Ceph removes
411 an old MDS target from the MDS map.
413 :Type: 32-bit Integer
417 ``mds replay interval``
419 :Description: The journal poll interval when in standby-replay mode.
426 ``mds shutdown check``
428 :Description: The interval for polling the cache during MDS shutdown.
429 :Type: 32-bit Integer
433 ``mds thrash exports``
435 :Description: Ceph will randomly export subtrees between nodes (testing only).
436 :Type: 32-bit Integer
440 ``mds thrash fragments``
442 :Description: Ceph will randomly fragment or merge directories.
443 :Type: 32-bit Integer
447 ``mds dump cache on map``
449 :Description: Ceph will dump the MDS cache contents to a file on each MDSMap.
454 ``mds dump cache after rejoin``
456 :Description: Ceph will dump MDS cache contents to a file after
457 rejoining the cache (during recovery).
463 ``mds verify scatter``
465 :Description: Ceph will assert that various scatter/gather invariants
466 are ``true`` (developers only).
472 ``mds debug scatterstat``
474 :Description: Ceph will assert that various recursive stat invariants
475 are ``true`` (for developers only).
483 :Description: Ceph will verify directory fragmentation invariants
484 when convenient (developers only).
490 ``mds debug auth pins``
492 :Description: The debug auth pin invariants (for developers only).
497 ``mds debug subtrees``
499 :Description: The debug subtree invariants (for developers only).
504 ``mds kill mdstable at``
506 :Description: Ceph will inject MDS failure in MDSTable code
507 (for developers only).
509 :Type: 32-bit Integer
513 ``mds kill export at``
515 :Description: Ceph will inject MDS failure in the subtree export code
516 (for developers only).
518 :Type: 32-bit Integer
522 ``mds kill import at``
524 :Description: Ceph will inject MDS failure in the subtree import code
525 (for developers only).
527 :Type: 32-bit Integer
533 :Description: Ceph will inject MDS failure in hard link code
534 (for developers only).
536 :Type: 32-bit Integer
540 ``mds kill rename at``
542 :Description: Ceph will inject MDS failure in the rename code
543 (for developers only).
545 :Type: 32-bit Integer
549 ``mds wipe sessions``
551 :Description: Ceph will delete all client sessions on startup
558 ``mds wipe ino prealloc``
560 :Description: Ceph will delete ino preallocation metadata on startup
569 :Description: The number of inode numbers to skip on startup
572 :Type: 32-bit Integer
576 ``mds standby for name``
578 :Description: An MDS daemon will standby for another MDS daemon of the name
579 specified in this setting.
585 ``mds standby for rank``
587 :Description: An MDS daemon will standby for an MDS daemon of this rank.
588 :Type: 32-bit Integer
592 ``mds standby replay``
594 :Description: Determines whether a ``ceph-mds`` daemon should poll and replay
595 the log of an active MDS (hot standby).