cmccabe commented on code in PR #14682: URL: https://github.com/apache/kafka/pull/14682#discussion_r1379209724
########## docs/ops.html: ########## @@ -3613,23 +3613,22 @@ <h4 class="anchor-heading"><a id="kraft_zk_migration" class="anchor-link"></a><a <a href="https://issues.apache.org/jira/projects/KAFKA" target="_blank">project JIRA</a> and the "kraft" component. </p> - </p> - <h3>Terminology</h3> <ul> - <li>Brokers that are in <b>ZK mode</b> store their metadata in Apache ZooKeeper. This is the old mode of handling metadata.</li> + <li>Brokers that are in <b>ZK mode</b> store their metadata in Apache ZooKepeer. This is the old mode of handling metadata.</li> <li>Brokers that are in <b>KRaft mode</b> store their metadata in a KRaft quorum. This is the new and improved mode of handling metadata.</li> <li><b>Migration</b> is the process of moving cluster metadata from ZooKeeper into a KRaft quorum.</li> </ul> <h3>Migration Phases</h3> In general, the migration process passes through several phases. + + For <ul> - <li>In the <b>initial phase</b>, all the brokers are in ZK mode, and there is a ZK-based controller.</li> - <li>During the <b>initial metadata load</b>, a KRaft quorum loads the metadata from ZooKeeper,</li> - <li>In <b>hybrid phase</b>, some brokers are in ZK mode, but there is a KRaft controller.</li> - <li>In <b>dual-write phase</b>, all brokers are KRaft, but the KRaft controller is continuing to write to ZK.</li> - <li>When the migration has been <b>finalized</b>, we no longer write metadata to ZooKeeper.</li> + <li>In the <b>pre-migration phase</b>, all the brokers are in ZK mode, and there is a ZK-based controller. But a KRaft controller has been provisioned and has migration enabled</li> Review Comment: Change "controller" to "controller quorum" -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: jira-unsubscr...@kafka.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org