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 <[email protected]>
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 <[email protected]>
Reviewers: Ismael Juma <[email protected]>
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,
