kafka-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mj...@apache.org
Subject [kafka] branch 2.0 updated: MINOR: add UPGRADE_FROM to 2.0-2.3 config docs (#7831)
Date Wed, 01 Jan 2020 23:27:57 GMT
This is an automated email from the ASF dual-hosted git repository.

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

The following commit(s) were added to refs/heads/2.0 by this push:
     new 9482bfe  MINOR: add UPGRADE_FROM to 2.0-2.3 config docs (#7831)
9482bfe is described below

commit 9482bfe2ceeba0ff0b801eed9ba75bab0257a07c
Author: A. Sophie Blee-Goldman <sophie@confluent.io>
AuthorDate: Wed Jan 1 18:24:59 2020 -0500

    MINOR: add UPGRADE_FROM to 2.0-2.3 config docs (#7831)
    Reviewers: Guozhang Wang <guozhang@confluent.io>, Matthias J. Sax <matthias@confluent.io>
 docs/streams/developer-guide/config-streams.html | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/docs/streams/developer-guide/config-streams.html b/docs/streams/developer-guide/config-streams.html
index 47b9082..9ae00d4 100644
--- a/docs/streams/developer-guide/config-streams.html
+++ b/docs/streams/developer-guide/config-streams.html
@@ -284,12 +284,17 @@
             <td colspan="2">Timestamp extractor class that implements the <code
class="docutils literal"><span class="pre">TimestampExtractor</span></code>
             <td>See <a class="reference internal" href="#streams-developer-guide-timestamp-extractor"><span
class="std std-ref">Timestamp Extractor</span></a></td>
-          <tr class="row-even"><td>value.serde</td>
+          <tr class="row-even"><td>upgrade.from</td>
+            <td>Medium</td>
+            <td colspan="2">The version you are upgrading from during a rolling upgrade.</td>
+            <td>See <a class="reference internal" href="#streams-developer-guide-upgrade-from"><span
class="std std-ref">Upgrade From</span></a></td>
+          </tr>
+          <tr class="row-odd"><td>value.serde</td>
             <td colspan="2">Default serializer/deserializer class for record values,
implements the <code class="docutils literal"><span class="pre">Serde</span></code>
interface (see also key.serde).</td>
             <td><code class="docutils literal"><span class="pre">Serdes.ByteArray().getClass().getName()</span></code></td>
-          <tr class="row-odd"><td>windowstore.changelog.additional.retention.ms</td>
+          <tr class="row-even"><td>windowstore.changelog.additional.retention.ms</td>
             <td colspan="2">Added to a windows maintainMs to ensure data is not deleted
from the log prematurely. Allows for clock drift.</td>
             <td>86400000 milliseconds = 1 day</td>
@@ -560,6 +565,17 @@
+        <div class="section" id="upgrade-from">
+          <h4><a class="toc-backref" href="#id14">upgrade.from</a><a
class="headerlink" href="#upgrade-from" title="Permalink to this headline"></a></h4>
+          <blockquote>
+            <div>
+              The version you are upgrading from. It is important to set this config when
performing a rolling upgrade to certain versions, as described in the upgrade guide.
+              You should set this config to the appropriate version before bouncing your
instances and upgrading them to the newer version. Once everyone is on the
+              newer version, you should remove this config and do a second rolling bounce.
It is only necessary to set this config and follow the two-bounce upgrade path
+              when upgrading from below version 2.0.
+            </div>
+          </blockquote>
+        </div>
       <div class="section" id="kafka-consumers-and-producer-configuration-parameters">
         <h3><a class="toc-backref" href="#id16">Kafka consumers, producer and
admin client configuration parameters</a><a class="headerlink" href="#kafka-consumers-and-producer-configuration-parameters"
title="Permalink to this headline"></a></h3>

View raw message