[docs] Add warning about unsafe-change-config

Adding an explicit warning about unsafe-change-config being unsafe to
avoid users skimming through the docs and deciding this is the command
they need.

Also pointed out that this shouldn't be done if the missing replicas are
a consequence of downed tablet servers and there's a chance of
recovering the tablet servers themselves.

Change-Id: I266c050c237a5c2fa286208a154c2a80f906769c
Reviewed-on: http://gerrit.cloudera.org:8080/9906
Reviewed-by: Will Berkeley <wdberke...@gmail.com>
Tested-by: Will Berkeley <wdberke...@gmail.com>


Project: http://git-wip-us.apache.org/repos/asf/kudu/repo
Commit: http://git-wip-us.apache.org/repos/asf/kudu/commit/c260a325
Tree: http://git-wip-us.apache.org/repos/asf/kudu/tree/c260a325
Diff: http://git-wip-us.apache.org/repos/asf/kudu/diff/c260a325

Branch: refs/heads/master
Commit: c260a32504e15a196665e6cf087774434fb5bc56
Parents: e0e6d5a
Author: Attila Bukor <abu...@cloudera.com>
Authored: Thu Apr 5 17:45:15 2018 +0200
Committer: Todd Lipcon <t...@apache.org>
Committed: Sat Apr 14 00:31:12 2018 +0000

----------------------------------------------------------------------
 docs/administration.adoc | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/kudu/blob/c260a325/docs/administration.adoc
----------------------------------------------------------------------
diff --git a/docs/administration.adoc b/docs/administration.adoc
index c46a775..dc8bb98 100644
--- a/docs/administration.adoc
+++ b/docs/administration.adoc
@@ -817,10 +817,13 @@ directory configuration>> to exclude the failed disk.
 === Bringing a tablet that has lost a majority of replicas back online
 
 If a tablet has permanently lost a majority of its replicas, it cannot recover
-automatically and operator intervention is required. The steps below may cause
-recent edits to the tablet to be lost, potentially resulting in permanent data
-loss. Only attempt the procedure below if it is impossible to bring
-a majority back online.
+automatically and operator intervention is required. If the tablet servers
+hosting a majority of the replicas are down (i.e. ones reported as "TS
+unavailable" by ksck), they should be recovered instead if possible.
+
+WARNING: The steps below may cause recent edits to the tablet to be lost,
+potentially resulting in permanent data loss. Only attempt the procedure below
+if it is impossible to bring a majority back online.
 
 Suppose a tablet has lost a majority of its replicas. The first step in
 diagnosing and fixing the problem is to examine the tablet's state using ksck:

Reply via email to