This is an automated email from the ASF dual-hosted git repository. manikumar 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 dbce4c1 MINOR: Update docs about ZooKeeper upgrade issue from 3.4.X to 3.5.6 dbce4c1 is described below commit dbce4c12ba1b5056146ffa9fd5cb1d9f38b986c7 Author: Manikumar Reddy <manikumar.re...@gmail.com> AuthorDate: Sat Nov 9 14:30:37 2019 +0530 MINOR: Update docs about ZooKeeper upgrade issue from 3.4.X to 3.5.6 ZK upgrade from 3.4.X to 3.5.6 fails with "java.io.IOException: No snapshot found" if there are no snapshot files. This was discussed in https://issues.apache.org/jira/browse/ZOOKEEPER-3056 Author: Manikumar Reddy <manikumar.re...@gmail.com> Reviewers: Ismael Juma <ism...@juma.me.uk> Closes #7625 from omkreddy/zk-upgrade --- config/zookeeper.properties | 5 +++++ docs/upgrade.html | 9 +++++++++ 2 files changed, 14 insertions(+) diff --git a/config/zookeeper.properties b/config/zookeeper.properties index 90f4332..8c186a3 100644 --- a/config/zookeeper.properties +++ b/config/zookeeper.properties @@ -22,3 +22,8 @@ maxClientCnxns=0 # Set the port to something non-conflicting if choosing to enable this admin.enableServer=false # admin.serverPort=8080 + +# Enable snapshot.trust.empty config if the ZK upgrade from 3.4.X to 3.5.6 is failing +# with "java.io.IOException: No snapshot found, but there are log entries" error. +# Check upgrade docs for more details. +# snapshot.trust.empty=true diff --git a/docs/upgrade.html b/docs/upgrade.html index a3920ce..2d7fa33 100644 --- a/docs/upgrade.html +++ b/docs/upgrade.html @@ -68,6 +68,15 @@ </li> </ol> +<p><b>Additional Upgrade Notes:</b></p> + +<ol> + <li>ZooKeeper has been upgraded to 3.5.6. Set <code>snapshot.trust.empty=true</code> in <code>zookeeper.properties</code> before the upgrade + to avoid <a href="https://issues.apache.org/jira/browse/ZOOKEEPER-3056">ZOOKEEPER-3056</a>. After the new version starts successfully, it is safe to remove this config. + See <a href="https://zookeeper.apache.org/doc/r3.5.6/zookeeperAdmin.html#sc_advancedConfiguration">ZooKeeper advanced configuration</a> for more details. + </li> +</ol> + <h5><a id="upgrade_240_notable" href="#upgrade_240_notable">Notable changes in 2.4.0</a></h5> <ul> <li>A new Admin API has been added for partition reassignments. Due to changing the way Kafka propagates reassignment information,