From 8bb9f75ea21fae47506916a2b179e179edbc86a3 Mon Sep 17 00:00:00 2001
From: David Arthur <mumrah@gmail.com>
Date: Thu, 1 Aug 2024 12:52:33 -0400
Subject: [PATCH 1/2] include step to remove zk migration znode

---
 37/ops.html | 5 ++++-
 38/ops.html | 5 ++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/37/ops.html b/37/ops.html
index b1da472d1..58018634c 100644
--- a/37/ops.html
+++ b/37/ops.html
@@ -4098,7 +4098,10 @@ <h3>Reverting to ZooKeeper mode During the Migration</h3>
             </li>
             <li>
               Using <code>zookeeper-shell.sh</code>, run <code>rmr /controller</code> so that one
-              of the brokers can become the new old-style controller.
+              of the brokers can become the new old-style controller. Additionally, run
+              <code>get /migration</code> followed by <code>rmr /migration</code> to clear the
+              migration state from ZooKeeper. This will allow you to re-attempt the migration
+              in the future. The data read from "/migration" can be useful for debugging.
             </li>
             <li>
               On each broker, remove the <code>zookeeper.metadata.migration.enable</code>,
diff --git a/38/ops.html b/38/ops.html
index e1b3a7bcd..34a518e21 100644
--- a/38/ops.html
+++ b/38/ops.html
@@ -4105,7 +4105,10 @@ <h3>Reverting to ZooKeeper mode During the Migration</h3>
             </li>
             <li>
               Using <code>zookeeper-shell.sh</code>, run <code>rmr /controller</code> so that one
-              of the brokers can become the new old-style controller.
+              of the brokers can become the new old-style controller. Additionally, run
+              <code>get /migration</code> followed by <code>rmr /migration</code> to clear the
+              migration state from ZooKeeper. This will allow you to re-attempt the migration
+              in the future. The data read from "/migration" can be useful for debugging.
             </li>
             <li>
               On each broker, remove the <code>zookeeper.metadata.migration.enable</code>,

From 1012a4a5a4da0441bcb0da8837dbfdea1d746875 Mon Sep 17 00:00:00 2001
From: David Arthur <mumrah@gmail.com>
Date: Tue, 6 Aug 2024 09:33:43 -0400
Subject: [PATCH 2/2] add second mention of rmr /migration

---
 37/ops.html | 5 ++++-
 38/ops.html | 5 ++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/37/ops.html b/37/ops.html
index 58018634c..cf7c95d13 100644
--- a/37/ops.html
+++ b/37/ops.html
@@ -4135,7 +4135,10 @@ <h3>Reverting to ZooKeeper mode During the Migration</h3>
             </li>
             <li>
               Using <code>zookeeper-shell.sh</code>, run <code>rmr /controller</code> so that one
-              of the brokers can become the new old-style controller.
+              of the brokers can become the new old-style controller. Additionally, run
+              <code>get /migration</code> followed by <code>rmr /migration</code> to clear the
+              migration state from ZooKeeper. This will allow you to re-attempt the migration
+              in the future. The data read from "/migration" can be useful for debugging.
             </li>
             <li>
               On each broker, remove the <code>zookeeper.metadata.migration.enable</code>,
diff --git a/38/ops.html b/38/ops.html
index 34a518e21..882f4854d 100644
--- a/38/ops.html
+++ b/38/ops.html
@@ -4145,7 +4145,10 @@ <h3>Reverting to ZooKeeper mode During the Migration</h3>
             </li>
             <li>
               Using <code>zookeeper-shell.sh</code>, run <code>rmr /controller</code> so that one
-              of the brokers can become the new old-style controller.
+              of the brokers can become the new old-style controller. Additionally, run
+              <code>get /migration</code> followed by <code>rmr /migration</code> to clear the
+              migration state from ZooKeeper. This will allow you to re-attempt the migration
+              in the future. The data read from "/migration" can be useful for debugging.
             </li>
             <li>
               On each broker, remove the <code>zookeeper.metadata.migration.enable</code>,