kafka-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mj...@apache.org
Subject [kafka] branch 1.1 updated: MINOR: fix upgrade docs for Streams (#5392)
Date Thu, 19 Jul 2018 15:17:07 GMT
This is an automated email from the ASF dual-hosted git repository.

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


The following commit(s) were added to refs/heads/1.1 by this push:
     new 343c47e  MINOR: fix upgrade docs for Streams (#5392)
343c47e is described below

commit 343c47ea7cc6723eee7d315d4f08c39bee453f10
Author: Matthias J. Sax <mjsax@apache.org>
AuthorDate: Thu Jul 19 08:17:02 2018 -0700

    MINOR: fix upgrade docs for Streams (#5392)
    
    Reviewers: Guozhang Wang <guozhang@confluent.io>, Dong Lin <dolin@linkedin.com>
---
 docs/upgrade.html | 23 ++++++++++++++++-------
 1 file changed, 16 insertions(+), 7 deletions(-)

diff --git a/docs/upgrade.html b/docs/upgrade.html
index f6194f5..e9e19a3 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -88,10 +88,10 @@
 <h5><a id="upgrade_110_new_protocols" href="#upgrade_110_new_protocols">New Protocol
Versions</a></h5>
 <ul></ul>
 
-<h5><a id="upgrade_110_streams" href="#upgrade_110_streams">Upgrading a 1.1.0
Kafka Streams Application</a></h5>
+<h5><a id="upgrade_110_streams_from_10" href="#upgrade_110_streams_from_10">Upgrading
a 1.0 Kafka Streams Application</a></h5>
 <ul>
-    <li> Upgrading your Streams application from 1.0.0 to 1.1.0 does not require a
broker upgrade.
-        A Kafka Streams 1.1.0 application can connect to 1.0, 0.11.0, 0.10.2 and 0.10.1 brokers
(it is not possible to connect to 0.10.0 brokers though). </li>
+    <li> Upgrading your Streams application from 1.0 to 1.1 does not require a broker
upgrade.
+        A Kafka Streams 1.1 application can connect to 1.0, 0.11.0, 0.10.2 and 0.10.1 brokers
(it is not possible to connect to 0.10.0 brokers though). </li>
     <li> See <a href="/{{version}}/documentation/streams/upgrade-guide#streams_api_changes_110">Streams
API changes in 1.1.0</a> for more details. </li>
 </ul>
 
@@ -211,7 +211,7 @@
          be used if the SaslHandshake request version is greater than 0. </li>
 </ul>
 
-<h5><a id="upgrade_100_streams" href="#upgrade_100_streams">Upgrading a 0.11.0
Kafka Streams Application</a></h5>
+<h5><a id="upgrade_100_streams_from_0110" href="#upgrade_100_streams_from_0110">Upgrading
a 0.11.0 Kafka Streams Application</a></h5>
 <ul>
     <li> Upgrading your Streams application from 0.11.0 to 1.0 does not require a broker
upgrade.
          A Kafka Streams 1.0 application can connect to 0.11.0, 0.10.2 and 0.10.1 brokers
(it is not possible to connect to 0.10.0 brokers though).
@@ -321,7 +321,7 @@
     before you switch to 0.11.0.</li>
 </ol>
 
-<h5><a id="upgrade_1100_streams" href="#upgrade_1100_streams">Upgrading a 0.10.2
Kafka Streams Application</a></h5>
+<h5><a id="upgrade_1100_streams_from_0102" href="#upgrade_1100_streams_from_0102">Upgrading
a 0.10.2 Kafka Streams Application</a></h5>
 <ul>
     <li> Upgrading your Streams application from 0.10.2 to 0.11.0 does not require
a broker upgrade.
          A Kafka Streams 0.11.0 application can connect to 0.11.0, 0.10.2 and 0.10.1 brokers
(it is not possible to connect to 0.10.0 brokers though). </li>
@@ -513,7 +513,7 @@ Kafka cluster before upgrading your clients. Version 0.10.2 brokers support
0.8.
 
 <p><b>Note:</b> Bumping the protocol version and restarting can be done
any time after the brokers were upgraded. It does not have to be immediately after.
 
-<h5><a id="upgrade_1020_streams" href="#upgrade_1020_streams">Upgrading a 0.10.1
Kafka Streams Application</a></h5>
+<h5><a id="upgrade_1020_streams_from_0101" href="#upgrade_1020_streams_from_0101">Upgrading
a 0.10.1 Kafka Streams Application</a></h5>
 <ul>
     <li> Upgrading your Streams application from 0.10.1 to 0.10.2 does not require
a broker upgrade.
          A Kafka Streams 0.10.2 application can connect to 0.10.2 and 0.10.1 brokers (it
is not possible to connect to 0.10.0 brokers though). </li>
@@ -616,6 +616,13 @@ only support 0.10.1.x or later brokers while 0.10.1.x brokers also support
older
 
 <p><b>Note:</b> Bumping the protocol version and restarting can be done
any time after the brokers were upgraded. It does not have to be immediately after.
 
+<!-- TODO: add when 0.10.1.2 is released
+<h5><a id="upgrade_1012_notable" href="#upgrade_1012_notable">Notable changes
in 0.10.1.2</a></h5>
+<ul>
+    <li> New configuration parameter <code>upgrade.from</code> added that
allows rolling bounce upgrade from version 0.10.0.x </li>
+</ul>
+-->
+
 <h5><a id="upgrade_10_1_breaking" href="#upgrade_10_1_breaking">Potential breaking
changes in 0.10.1.0</a></h5>
 <ul>
     <li> The log retention time is no longer based on last modified time of the log
segments. Instead it will be based on the largest timestamp of the messages in a log segment.</li>
@@ -625,11 +632,12 @@ only support 0.10.1.x or later brokers while 0.10.1.x brokers also support
older
     <li> Due to the increased number of index files, on some brokers with large amount
the log segments (e.g. >15K), the log loading process during the broker startup could be
longer. Based on our experiment, setting the num.recovery.threads.per.data.dir to one may
reduce the log loading time. </li>
 </ul>
 
-<h5><a id="upgrade_1010_streams" href="#upgrade_1010_streams">Upgrading a 0.10.0
Kafka Streams Application</a></h5>
+<h5><a id="upgrade_1010_streams_from_0100" href="#upgrade_1010_streams_from_0100">Upgrading
a 0.10.0 Kafka Streams Application</a></h5>
 <ul>
     <li> Upgrading your Streams application from 0.10.0 to 0.10.1 does require a <a
href="#upgrade_10_1">broker upgrade</a> because a Kafka Streams 0.10.1 application
can only connect to 0.10.1 brokers. </li>
     <li> There are couple of API changes, that are not backward compatible (cf. <a
href="/{{version}}/documentation/streams/upgrade-guide#streams_api_changes_0101">Streams
API changes in 0.10.1</a> for more details).
          Thus, you need to update and recompile your code. Just swapping the Kafka Streams
library jar file will not work and will break your application. </li>
+<!-- TODO: add if 0.10.1.2 is released
     <li> Upgrading from 0.10.0.x to 0.10.1.2 requires two rolling bounces with config
<code>upgrade.from="0.10.0"</code> set for first upgrade phase
          (cf. <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-268%3A+Simplify+Kafka+Streams+Rebalance+Metadata+Upgrade">KIP-268</a>).
          As an alternative, an offline upgrade is also possible.
@@ -640,6 +648,7 @@ only support 0.10.1.x or later brokers while 0.10.1.x brokers also support
older
             <li> bounce each instance of your application once more to complete the
upgrade </li>
         </ul>
     </li>
+-->
     <li> Upgrading from 0.10.0.x to 0.10.1.0 or 0.10.1.1 requires an offline upgrade
(rolling bounce upgrade is not supported)
         <ul>
             <li> stop all old (0.10.0.x) application instances </li>


Mime
View raw message