(kafka) branch trunk 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 trunk
in repository https://gitbox.apache.org/repos/asf/kafka.git


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

commit b4cc88f6c45ff703f86fef47f52362870effaaf6
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 104e8c02849..1e3a4501d91 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -37,9 +37,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.