[
https://issues.apache.org/jira/browse/KAFKA-15223?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
kaushik srinivas updated KAFKA-15223:
-------------------------------------
Issue Type: Bug (was: Improvement)
> 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: Bug
> 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)
