This is an automated email from the ASF dual-hosted git repository. showuon pushed a commit to branch trunk in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/trunk by this push: new 9118ad653fa Additional fix on the rollback migration documentation (#15317) 9118ad653fa is described below commit 9118ad653fa4a076bf1b774c22aa015dfc2c2aab Author: Paolo Patierno <ppatie...@live.com> AuthorDate: Wed Feb 21 10:43:05 2024 +0100 Additional fix on the rollback migration documentation (#15317) This is an additional PR to fix rollback migration documentation related to #15287 Reviewers: Luke Chen <show...@gmail.com> --- docs/ops.html | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/docs/ops.html b/docs/ops.html index cf039c75220..7e9d9630e25 100644 --- a/docs/ops.html +++ b/docs/ops.html @@ -4063,8 +4063,10 @@ listeners=CONTROLLER://:9093 </ul> </td> <td> - It is important to perform the <code>zookeeper-shell.sh</code> step quickly, to minimize the amount of - time that the cluster lacks a controller. + It is important to perform the <code>zookeeper-shell.sh</code> step <b>quickly</b>, to minimize the amount of + time that the cluster lacks a controller. Until the <code> /controller</code> znode is deleted, + you can also ignore any errors in the broker log about failing to connect to the Kraft controller. + Those error logs should disappear after second roll to pure zookeeper mode. </td> </tr> <tr> @@ -4072,7 +4074,8 @@ listeners=CONTROLLER://:9093 <td> <ul> <li> - On each broker, remove the <code>process.roles</code> configuration, and + On each broker, remove the <code>process.roles</code> configuration, + replace the <code>node.id</code> with <code>broker.id</code> and restore the <code>zookeeper.connect</code> configuration to its previous value. If your cluster requires other ZooKeeper configurations for brokers, such as <code>zookeeper.ssl.protocol</code>, re-add those configurations as well. @@ -4088,7 +4091,7 @@ listeners=CONTROLLER://:9093 <li> On each broker, remove the <code>zookeeper.metadata.migration.enable</code>, <code>controller.listener.names</code>, and <code>controller.quorum.voters</code> - configurations. Replace <code>node.id</code> with <code>broker.id</code>. + configurations. Then perform a second rolling restart of all brokers. </li> <li> @@ -4100,7 +4103,9 @@ listeners=CONTROLLER://:9093 <ul> <li> It is important to perform the <code>zookeeper-shell.sh</code> step <b>quickly</b>, to minimize the amount of - time that the cluster lacks a controller. + time that the cluster lacks a controller. Until the <code> /controller</code> znode is deleted, + you can also ignore any errors in the broker log about failing to connect to the Kraft controller. + Those error logs should disappear after second roll to pure zookeeper mode. </li> <li> Make sure that on the first cluster roll, <code>zookeeper.metadata.migration.enable</code> remains set to