[
https://issues.apache.org/jira/browse/KAFKA-19509?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
TengYao Chi resolved KAFKA-19509.
---------------------------------
Resolution: Fixed
> Improve error message when release version is wrong
> ---------------------------------------------------
>
> Key: KAFKA-19509
> URL: https://issues.apache.org/jira/browse/KAFKA-19509
> Project: Kafka
> Issue Type: Improvement
> Affects Versions: 4.1.0
> Reporter: Luke Chen
> Assignee: Lan Ding
> Priority: Major
>
> When running kafka-storage.sh, if the release-version is wrongly set, we'll
> get the error messages including un-released metadata version:
>
> {code:java}
> > bin/kafka-storage.sh format --standalone -t kEzc4vk3TIKhCQKsh40klQ -c
> > config/server.properties --release-version 4.0-IV4
> Exception in thread "main" java.lang.IllegalArgumentException: Version
> 4.0-IV4 is not a valid version. The minimum version is 3.3-IV3 and the
> maximum version is 4.2-IV1
> at
> org.apache.kafka.server.common.MetadataVersion.lambda$fromVersionString$0(MetadataVersion.java:356)
> at java.base/java.util.Optional.orElseThrow(Optional.java:403)
> at
> org.apache.kafka.server.common.MetadataVersion.fromVersionString(MetadataVersion.java:354)
> at
> kafka.tools.StorageTool$.$anonfun$runFormatCommand$1(StorageTool.scala:133)
> at scala.Option.foreach(Option.scala:437)
> at kafka.tools.StorageTool$.runFormatCommand(StorageTool.scala:132)
> at kafka.tools.StorageTool$.execute(StorageTool.scala:86)
> at kafka.tools.StorageTool$.main(StorageTool.scala:46)
> at kafka.tools.StorageTool.main(StorageTool.scala)
> {code}
> One idea is to improve this by relying on the internal config:
> `unstable.feature.versions.enable` to decide if we want to log the unstable
> feature versions.
> The other thought is we can mimic what Kafka-feature.sh did:
> {code:java}
> > bin/kafka-features.sh --bootstrap-server localhost:9092 upgrade
> --release-version 4.0-IV4
> [2025-07-15 16:31:53,280] WARN [AdminClient clientId=adminclient-1]
> Unknown metadata.version 4.1-IV4. Supported metadata.version are 3.3-IV3,
> 3.4-IV0, 3.5-IV0, 3.5-IV1, 3.5-IV2, 3.6-IV0, 3.6-IV1, 3.6-IV2, 3.7-IV0,
> 3.7-IV1, 3.7-IV2, 3.7-IV3, 3.7-IV4, 3.8-IV0, 3.9-IV0, 4.0-IV0, 4.0-IV1,
> 4.0-IV2, 4.0-IV3 {code}
> It didn't output the supported versions to users.
>
>
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
