(kafka) branch 4.0 updated: MINOR: Update upgrade steps (#19132)

[da...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

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


The following commit(s) were added to refs/heads/4.0 by this push:
     new 43897f84acc MINOR: Update upgrade steps (#19132)
43897f84acc is described below

commit 43897f84acc5b30bd9dc03b1f9d0fa8b377c50ab
Author: David Jacot <da...@gmail.com>
AuthorDate: Thu Mar 6 11:22:03 2025 +0100

    MINOR: Update upgrade steps (#19132)
    
    Using `bin/kafka-features.sh upgrade --metadata 4.0` to finalize the
    upgrade is deprecated and furthermore it does not bump all the other
    feature flags. Hence we should recommend to use `bin/kafka-features.sh
    upgrade --release-version 4.0` in the documentation. This change was
    introduced in [KIP-1022: Formatting and Updating
    Features](https://cwiki.apache.org/confluence/display/KAFKA/KIP-1022%3A+Formatting+and+Updating+Features).
    
    Reviewers: Chia-Ping Tsai <ch...@gmail.com>, Ismael Juma <is...@juma.me.uk>
---
 docs/upgrade.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/upgrade.html b/docs/upgrade.html
index 8b90d8f827a..50e43ca6dc4 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -27,9 +27,9 @@
     <li>Upgrade the brokers one at a time: shut down the broker, update the code, and restart it. Once you have done so, the
         brokers will be running the latest version and you can verify that the cluster's behavior and performance meets expectations.
     </li>
-    <li>Once the cluster's behavior and performance has been verified, bump the metadata.version by running
+    <li>Once the cluster's behavior and performance has been verified, finalize the upgrade by running
         <code>
-            bin/kafka-features.sh upgrade --metadata 4.0
+            bin/kafka-features.sh upgrade --release-version 4.0
         </code>
     </li>
     <li>Note that cluster metadata downgrade is not supported in this version since it has metadata changes.