[KAFKA-17042] the migration docs should remind users to set "broker.id.generation.enable" when adding broker.id

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 3.9.0
• Assignee: TengYao Chi
• Reporter: Chia-Ping Tsai
• Created: 26/Jun/24 14:10
• Updated: 05/Jul/24 10:21
• Resolved: 05/Jul/24 10:21

Description

in the section: Enter Migration Mode on the Brokers

it requires users to add "broker.id", but it can produces error "broker.id must be greater than or equal to -1 and not greater than reserved.broker.max.id" too. That is caused by the zk broker is using a generated broker id.

As this phase is temporary, the simple solution is to remind users to add "broker.id.generation.enable=false" if the zk broker is using generated broker id.

Issue Links

• links to: GitHub Pull Request #16491