Skip to content

HBASE-30167: Document the Read Replica feature#8459

Merged
taklwu merged 1 commit into
apache:masterfrom
Kota-SH:HBASE-30167
Jul 10, 2026
Merged

HBASE-30167: Document the Read Replica feature#8459
taklwu merged 1 commit into
apache:masterfrom
Kota-SH:HBASE-30167

Conversation

@Kota-SH

@Kota-SH Kota-SH commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

### Custom `hbase:meta` per cluster

Every cluster sharing a `hbase.rootdir` needs its own `hbase:meta`, because region assignments are
node-scoped and cannot be shared. Other system tables (`hbase:namespace`, `hbase:acl`, `hbase:replication`)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hbase:namespace has been deprecated since 3.0.0 and will be removed in 4.0.0. https://github.com/apache/hbase/blob/master/hbase-common/src/main/java/org/apache/hadoop/hbase/TableName.java#L110-L118

We don't need to mention it here for master branch.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the review @guluo2016, updated it.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds new user-facing documentation to the HBase website describing the “Read Replica Cluster” feature (running a secondary read-only HBase cluster against shared storage) and links it into the multi-page docs navigation.

Changes:

  • Add a new MDX doc page detailing design, configuration, and operational procedures for read replica clusters.
  • Add the new page to the multi-page docs meta.json so it shows up in the sidebar.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File Description
hbase-website/app/pages/_docs/docs/_mdx/(multi-page)/read-replica-cluster.mdx New documentation page for read replica clusters (design/config/ops).
hbase-website/app/pages/_docs/docs/_mdx/(multi-page)/meta.json Adds read-replica-cluster to the docs navigation.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread hbase-website/app/pages/_docs/docs/_mdx/(multi-page)/read-replica-cluster.mdx Outdated
Comment thread hbase-website/app/pages/_docs/docs/_mdx/(multi-page)/read-replica-cluster.mdx Outdated
Comment thread hbase-website/app/pages/_docs/docs/_mdx/(multi-page)/read-replica-cluster.mdx Outdated
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

@anmolnar anmolnar left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm.

@guluo2016 guluo2016 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks a lot

@taklwu taklwu left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@taklwu taklwu merged commit f9a41c7 into apache:master Jul 10, 2026
8 checks passed
@guluo2016

Copy link
Copy Markdown
Member

Please also raise a PR for branch-2.
Just a small reminder that hbase:namespace is still used in 2.x. @Kota-SH

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.

5 participants