This is an automated email from the ASF dual-hosted git repository.
schofielaj pushed a commit to branch 4.2
in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/4.2 by this push:
new 334d4c56e72 MINOR: Share group config upgrade docs (#21589)
334d4c56e72 is described below
commit 334d4c56e72c4a356aaa5bc0199152bf88aba903
Author: Andrew Schofield <[email protected]>
AuthorDate: Thu Feb 26 17:21:42 2026 +0000
MINOR: Share group config upgrade docs (#21589)
Add a note to the upgrading docs for users with clusters of fewer than 3
brokers. Share groups introduce a new internal topic whose default
configuration assumes 3 or more brokers.
This will be cherry-picked back to the 4.2 branch for inclusion in
4.2.1.
Reviewers: Apoorv Mittal <[email protected]>
---
docs/getting-started/upgrade.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/docs/getting-started/upgrade.md b/docs/getting-started/upgrade.md
index 5538114c414..6cccbb361ad 100644
--- a/docs/getting-started/upgrade.md
+++ b/docs/getting-started/upgrade.md
@@ -30,6 +30,8 @@ type: docs
### Upgrading Servers to 4.2.0 from any version 3.3.x through 4.1.x
+ * If you wish to use share groups in a cluster with fewer than 3 brokers,
you must set the broker configurations
`share.coordinator.state.topic.replication.factor` and
`share.coordinator.state.topic.min.isr` to 1 before you start using share
groups. This is because share groups make use of a new internal topic called
`__share_group_state` which is automatically created when you first use share
groups. In common with the other internal topics, the default configuration
uses 3 replicas a [...]
+
### Notable changes in 4.2.0
* The `--max-partition-memory-bytes` option in `kafka-console-producer` is
deprecated and will be removed in Kafka 5.0. Please use `--batch-size` instead.
