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-by: Alex Rodoni <>
Tested-by: Kudu Jenkins
Reviewed-by: Todd Lipcon <>


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

 docs/administration.adoc | 5 +++++
 1 file changed, 5 insertions(+)
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