From b9a63e49ea7fb1f7ed7ab2064aaaa21dd38d9a3f Mon Sep 17 00:00:00 2001
From: Patrick Donnelly <pdonnell@redhat.com>
Date: Sun, 13 Nov 2016 21:51:35 -0500
Subject: [PATCH] doc: clarify mds deactivate purpose

Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
---
 doc/cephfs/administration.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/cephfs/administration.rst b/doc/cephfs/administration.rst
index 1e45bb3c199..3569165fa0b 100644
--- a/doc/cephfs/administration.rst
+++ b/doc/cephfs/administration.rst
@@ -51,6 +51,11 @@ These commands act on specific mds daemons or ranks.
 
     mds fail <gid/name/role
 
+This command deactivates an MDS causing it to flush its entire journal to
+backing RADOS objects and close all open client sessions. Deactivating an MDS
+is primarily intended for bringing down a rank after reducing the number of
+active MDS (max_mds).
+
 ::
 
     mds deactivate <role>
-- 
2.39.5