You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kafka.apache.org by ma...@apache.org on 2019/11/09 09:01:39 UTC

[kafka] branch 2.4 updated: MINOR: Update docs about ZooKeeper upgrade issue from 3.4.X to 3.5.6

This is an automated email from the ASF dual-hosted git repository.

manikumar pushed a commit to branch 2.4
in repository https://gitbox.apache.org/repos/asf/kafka.git


The following commit(s) were added to refs/heads/2.4 by this push:
     new 5f91aa9  MINOR: Update docs about ZooKeeper upgrade issue from 3.4.X to 3.5.6
5f91aa9 is described below

commit 5f91aa99da6e8f5dd51a6ea573b547150163495e
Author: Manikumar Reddy <ma...@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 <ma...@gmail.com>
    
    Reviewers: Ismael Juma <is...@juma.me.uk>
    
    Closes #7625 from omkreddy/zk-upgrade
    
    (cherry picked from commit dbce4c12ba1b5056146ffa9fd5cb1d9f38b986c7)
    Signed-off-by: Manikumar Reddy <ma...@confluent.io>
---
 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 8bc0fb9..ce894d1 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -61,6 +61,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,