kafka-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From guozh...@apache.org
Subject [kafka-site] branch asf-site updated: Add UPGRADE_FROM to config docs (#245)
Date Fri, 13 Dec 2019 21:43:00 GMT
This is an automated email from the ASF dual-hosted git repository.

guozhang pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/kafka-site.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new 7790f37  Add UPGRADE_FROM to config docs (#245)
7790f37 is described below

commit 7790f37c86dac993f6e6d82588b406b2f4a2f73d
Author: A. Sophie Blee-Goldman <sophie@confluent.io>
AuthorDate: Fri Dec 13 13:42:52 2019 -0800

    Add UPGRADE_FROM to config docs (#245)
    
    Reviewers: Guozhang Wang <wangguoz@gmail.com>
---
 20/streams/developer-guide/config-streams.html | 20 ++++++++++++++++++--
 21/streams/developer-guide/config-streams.html | 20 ++++++++++++++++++--
 22/streams/developer-guide/config-streams.html | 20 ++++++++++++++++++--
 23/streams/developer-guide/config-streams.html | 20 ++++++++++++++++++--
 24/streams/developer-guide/config-streams.html | 20 ++++++++++++++++++--
 5 files changed, 90 insertions(+), 10 deletions(-)

diff --git a/20/streams/developer-guide/config-streams.html b/20/streams/developer-guide/config-streams.html
index 48f5bcd..86d4fb3 100644
--- a/20/streams/developer-guide/config-streams.html
+++ b/20/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>
interface.</td>
             <td>See <a class="reference internal" href="#streams-developer-guide-timestamp-extractor"><span
class="std std-ref">Timestamp Extractor</span></a></td>
           </tr>
-          <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>Medium</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>
-          <tr class="row-odd"><td>windowstore.changelog.additional.retention.ms</td>
+          <tr class="row-even"><td>windowstore.changelog.additional.retention.ms</td>
             <td>Low</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>
             </div></blockquote>
         </div>
+        <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>
       <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>
diff --git a/21/streams/developer-guide/config-streams.html b/21/streams/developer-guide/config-streams.html
index c8604c6..f85df60 100644
--- a/21/streams/developer-guide/config-streams.html
+++ b/21/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>
interface.</td>
             <td>See <a class="reference internal" href="#streams-developer-guide-timestamp-extractor"><span
class="std std-ref">Timestamp Extractor</span></a></td>
           </tr>
-          <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>Medium</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>
-          <tr class="row-odd"><td>windowstore.changelog.additional.retention.ms</td>
+          <tr class="row-even"><td>windowstore.changelog.additional.retention.ms</td>
             <td>Low</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>
@@ -565,6 +570,17 @@
               </div>
             </div></blockquote>
         </div>
+        <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>
       <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>
diff --git a/22/streams/developer-guide/config-streams.html b/22/streams/developer-guide/config-streams.html
index c8604c6..f85df60 100644
--- a/22/streams/developer-guide/config-streams.html
+++ b/22/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>
interface.</td>
             <td>See <a class="reference internal" href="#streams-developer-guide-timestamp-extractor"><span
class="std std-ref">Timestamp Extractor</span></a></td>
           </tr>
-          <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>Medium</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>
-          <tr class="row-odd"><td>windowstore.changelog.additional.retention.ms</td>
+          <tr class="row-even"><td>windowstore.changelog.additional.retention.ms</td>
             <td>Low</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>
@@ -565,6 +570,17 @@
               </div>
             </div></blockquote>
         </div>
+        <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>
       <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>
diff --git a/23/streams/developer-guide/config-streams.html b/23/streams/developer-guide/config-streams.html
index 922c6c9..c569ab3 100644
--- a/23/streams/developer-guide/config-streams.html
+++ b/23/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>
interface.</td>
             <td>See <a class="reference internal" href="#streams-developer-guide-timestamp-extractor"><span
class="std std-ref">Timestamp Extractor</span></a></td>
           </tr>
-          <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>Medium</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>
-          <tr class="row-odd"><td>windowstore.changelog.additional.retention.ms</td>
+          <tr class="row-even"><td>windowstore.changelog.additional.retention.ms</td>
             <td>Low</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>
@@ -565,6 +570,17 @@
               </div>
             </div></blockquote>
         </div>
+        <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>
       <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>
diff --git a/24/streams/developer-guide/config-streams.html b/24/streams/developer-guide/config-streams.html
index 221e3c0..5084bc2 100644
--- a/24/streams/developer-guide/config-streams.html
+++ b/24/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>
interface.</td>
             <td>See <a class="reference internal" href="#streams-developer-guide-timestamp-extractor"><span
class="std std-ref">Timestamp Extractor</span></a></td>
           </tr>
-          <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>Medium</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>
-          <tr class="row-odd"><td>windowstore.changelog.additional.retention.ms</td>
+          <tr class="row-even"><td>windowstore.changelog.additional.retention.ms</td>
             <td>Low</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>
@@ -567,6 +572,17 @@
               </div>
             </div></blockquote>
         </div>
+        <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, or when upgrading to 2.4+ from any version
lower than 2.4.
+            </div>
+          </blockquote>
+        </div>
       </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>


Mime
View raw message