docs: add warning to wait between FS rebuilds

Customers who are rebuilding multiple Kudu nodes may permanently delete
all healthy replicas for a tablet. This won't prevent data loss in the
event that a only single copy remains and is deleted, but waiting should
help prevent such situations.

Change-Id: I5659c2ba05a0a6b9905213c5df6ba0dcb371f312
Reviewed-on: http://gerrit.cloudera.org:8080/9279
Reviewed-by: Alex Rodoni <arod...@cloudera.com>
Tested-by: Kudu Jenkins
Reviewed-by: Todd Lipcon <t...@apache.org>


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

Branch: refs/heads/master
Commit: 9f93e97a676a93db33b8dc57e0f9d2be8147a189
Parents: 13fc066
Author: Andrew Wong <aw...@cloudera.com>
Authored: Fri Feb 9 13:19:40 2018 -0800
Committer: Todd Lipcon <t...@apache.org>
Committed: Tue Mar 6 22:44:08 2018 +0000

----------------------------------------------------------------------
 docs/administration.adoc | 5 +++++
 1 file changed, 5 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/kudu/blob/9f93e97a/docs/administration.adoc
----------------------------------------------------------------------
diff --git a/docs/administration.adoc b/docs/administration.adoc
index 4d1afe8..ab78aa1 100644
--- a/docs/administration.adoc
+++ b/docs/administration.adoc
@@ -777,6 +777,11 @@ factor is at least three and all other servers are online 
and healthy.
 NOTE: These steps use a tablet server as an example, but the steps are the same
 for Kudu master servers.
 
+WARNING: If multiple nodes need their FS layouts rebuilt, wait until all
+replicas previously hosted on each node have finished automatically
+re-replicating elsewhere before continuing. Failure to do so can result in
+permanent data loss.
+
 WARNING: Before proceeding, ensure the contents of the directories are backed
 up, either as a copy or in the form of other tablet replicas.
 

Reply via email to