You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kafka.apache.org by gu...@apache.org on 2019/12/13 21:43:00 UTC
[kafka-site] branch asf-site updated: Add UPGRADE_FROM to config
docs (#245)
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 <so...@confluent.io>
AuthorDate: Fri Dec 13 13:42:52 2019 -0800
Add UPGRADE_FROM to config docs (#245)
Reviewers: Guozhang Wang <wa...@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>