[jira] [Commented] (KAFKA-15223) Need more clarity in documentation for upgrade/downgrade procedures and limitations across releases.

["kaushik srinivas (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/KAFKA-15223?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17745419#comment-17745419 ] 

kaushik srinivas commented on KAFKA-15223:
------------------------------------------

[~ijuma] , Can you please help us with this ?

> Need more clarity in documentation for upgrade/downgrade procedures and limitations across releases.
> ----------------------------------------------------------------------------------------------------
>
>                 Key: KAFKA-15223
>                 URL: https://issues.apache.org/jira/browse/KAFKA-15223
>             Project: Kafka
>          Issue Type: Improvement
>    Affects Versions: 3.4.0, 3.3.1, 3.3.2, 3.5.0, 3.4.1
>            Reporter: kaushik srinivas
>            Priority: Critical
>
> Referring to the upgrade documentation for apache kafka.
> [https://kafka.apache.org/34/documentation.html#upgrade_3_4_0]
> There is confusion with respect to below statements from the above sectioned link of apache docs.
> "If you are upgrading from a version prior to 2.1.x, please see the note below about the change to the schema used to store consumer offsets. *Once you have changed the inter.broker.protocol.version to the latest version, it will not be possible to downgrade to a version prior to 2.1."*
> The above statement mentions that the downgrade would not be possible to version prior to "2.1" in case of "upgrading the inter.broker.protocol.version to the latest version".
> But, there is another statement made in the documentation in *point 4* as below
> "Restart the brokers one by one for the new protocol version to take effect. {*}Once the brokers begin using the latest protocol version, it will no longer be possible to downgrade the cluster to an older version.{*}"
>  
> These two statements are repeated across a lot of prior releases of kafka and is confusing.
> Below are the questions:
>  # Is downgrade not at all possible to *"any"* older version of kafka once the inter.broker.protocol.version is updated to latest version *OR* downgrades are not possible only to versions *"<2.1"* ?
>  # Suppose one takes an approach similar to upgrade even for the downgrade path. i.e. downgrade the inter.broker.protocol.version first to the previous version, next downgrade the software/code of kafka to previous release revision. Does downgrade work with this approach ?
> Can these two questions be documented if the results are already known ?
> Maybe a downgrade guide can be created too similar to the existing upgrade guide ?



--
This message was sent by Atlassian Jira
(v8.20.10#820010)