Skip to content

[doc] Recommend 3 FOLLOWER FEs in metadata best practices - #4167

Open
ixzc wants to merge 1 commit into
apache:masterfrom
ixzc:docs/fe-metadata-3-followers
Open

ixzc wants to merge 1 commit into
apache:masterfrom
ixzc:docs/fe-metadata-3-followers

Conversation

@ixzc

@ixzc ixzc commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Versions

  • dev
  • 4.x
  • 3.x
  • 2.1 or older (not covered by version/language sync gate)

Languages

  • Chinese
  • English

Docs Checklist

  • Checked by AI
  • Test Cases Built
  • Updated required version and language counterparts, or explained why not
  • If only one language changed, confirmed whether source/translation counterparts need sync

Summary

  • The metadata operation page still recommended deploying only one FOLLOWER-type FE as MASTER and making the rest OBSERVERs. That advice is outdated and conflicts with current deployment docs, which recommend 3 FOLLOWERs for production HA.
  • Update Best Practices and the "FOLLOWER FE hangs up one after another" FAQ for current/dev, 4.x, and 3.x (English and Chinese). Majority-write behavior is kept; the conclusion is now to deploy 3 FOLLOWERs and avoid stopping a majority of them.
  • 2.1 and older docs are unchanged.

Test plan

  • Review the Best Practices and FAQ fix typo:'一下' -> '以下' #5 wording in current, 4.x, and 3.x English/Chinese pages
  • Confirm the rendered docs after merge: /docs/dev/admin-manual/trouble-shooting/metadata-operation#best-practices

The metadata page still advised a single FOLLOWER plus OBSERVERs, which
contradicted current deployment docs. Production HA should use 3 FOLLOWERs.
@ixzc
ixzc force-pushed the docs/fe-metadata-3-followers branch from dae0c71 to 92a5e15 Compare September 21, 2026 17:44

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant