Skip to content

Commit 750523f

Browse files
lucasbruCopilot
andauthored
MINOR: Make feature upgrade instructions more precise (#20816)
In some frameworks such as Strimzi, the metadata version seems to be hardcoded. In this case, or if we have a pre-existing cluster, users need to enable the feature explicitly. Reviewers: Matthias J. Sax <[email protected]> --------- Co-authored-by: Copilot <[email protected]>
1 parent c293afc commit 750523f

File tree

1 file changed

+13
-3
lines changed

1 file changed

+13
-3
lines changed

docs/streams/upgrade-guide.html

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -184,9 +184,19 @@ <h4>Early Access of the Streams Rebalance Protocol</h4>
184184
Set <code>unstable.feature.versions.enable=true</code> for controllers and brokers, and
185185
set <code>unstable.api.versions.enable=true</code> on the brokers as well. In your Kafka Streams application
186186
configuration, set <code>group.protocol=streams</code>.
187-
After the new feature is configured, check
188-
<code>kafka-features.sh --bootstrap-server localhost:9092 describe</code>
189-
and `streams.version` should now have FinalizedVersionLevel 1.
187+
</p>
188+
189+
<p>
190+
When <code>unstable.api.versions.enable=true</code> is set when the kafka storage is first created,
191+
and no explicit metadata version is set, the feature will be enabled by default. In other configurations
192+
(e.g. if the cluster already existed, or a metadata version was hardcoded), you may have to enable it explicitly.
193+
First, check the current feature level by running
194+
<code>kafka-features.sh --bootstrap-server localhost:9092 describe</code>.
195+
If <code>streams.version</code> shows <code>FinalizedVersionLevel</code> is 1, no action is needed.
196+
Otherwise, upgrade by running
197+
<code>kafka-features.sh --bootstrap-server localhost:9092 upgrade --feature streams.version=1</code>.
198+
After the upgrade, verify the change by running
199+
<code>kafka-features.sh --bootstrap-server localhost:9092 describe</code>.
190200
</p>
191201

192202
<p>

0 commit comments

Comments
 (0)