This is an automated email from the ASF dual-hosted git repository.
petersomogyi pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/hbase.git
The following commit(s) were added to refs/heads/master by this push:
new 80764576c3f HBASE-30289 Website build fails (#8473)
80764576c3f is described below
commit 80764576c3fcb2a3e3ca4d163990763bc827c63e
Author: Yurii Palamarchuk <[email protected]>
AuthorDate: Wed Jul 15 12:27:59 2026 +0200
HBASE-30289 Website build fails (#8473)
Signed-off-by: Peter Somogyi <[email protected]>
---
.../_mdx/(multi-page)/read-replica-cluster.mdx | 28 +++++++++++-----------
1 file changed, 14 insertions(+), 14 deletions(-)
diff --git
a/hbase-website/app/pages/_docs/docs/_mdx/(multi-page)/read-replica-cluster.mdx
b/hbase-website/app/pages/_docs/docs/_mdx/(multi-page)/read-replica-cluster.mdx
index fa93aa31b40..956b221a359 100644
---
a/hbase-website/app/pages/_docs/docs/_mdx/(multi-page)/read-replica-cluster.mdx
+++
b/hbase-website/app/pages/_docs/docs/_mdx/(multi-page)/read-replica-cluster.mdx
@@ -17,15 +17,15 @@ Typical use cases:
- Stand up an isolated cluster for read-mostly experiments without copying
data.
<Callout type="info">
- **Eventual consistency.** A replica only sees data once (a) the active
cluster has flushed the data to
- HFiles in shared storage, and (b) the replica has been told to re-read
shared storage via the
- `refresh_meta` and `refresh_hfiles` commands. MemStore data on the active
cluster is invisible to the
- replica until flushed.
+ **Eventual consistency.** A replica only sees data once (a) the active
cluster has flushed the
+ data to HFiles in shared storage, and (b) the replica has been told to
re-read shared storage via
+ the `refresh_meta` and `refresh_hfiles` commands. MemStore data on the
active cluster is invisible
+ to the replica until flushed.
</Callout>
The parent design lives on
[HBASE-29081](https://issues.apache.org/jira/browse/HBASE-29081).
-## Design
+## Design [#read-replica-cluster-design]
The feature has three parts.
@@ -77,7 +77,7 @@ its cluster ID and meta suffix.
`MasterFileSystem.negotiateActiveClusterSuffixFi
`AbstractReadOnlyController.manageActiveClusterIdFile` handles the dynamic
toggle: switching to read-only
deletes the file if this cluster owns it, and switching back to read-write
creates the file if absent.
-## Configuration
+## Configuration [#read-replica-cluster-configuration]
On every node of the **read replica cluster**, add the following to
`hbase-site.xml`:
@@ -111,7 +111,7 @@ every replica's suffix), and leaves
`hbase.global.readonly.enabled` unset or `fa
coprocessors without restarting the process. All nodes must agree on the
value; operators are responsible for
keeping every `hbase-site.xml` in sync before issuing `update_all_config`.
-## Operation and maintenance
+## Operation and maintenance [#read-replica-cluster-operation-and-maintenance]
### Case 1. Bring up a new read replica cluster
@@ -190,16 +190,16 @@ mutations.
## Configurations and Commands
-### New configs
+### New configs [#read-replica-cluster-new-configs]
-| Config | Default | Description
|
-| ------------------------------- | ------- |
----------------------------------------------------------------------------------------------
|
+| Config | Default | Description
|
+| ------------------------------- | ------- |
-----------------------------------------------------------------------------------------------
|
| `hbase.meta.table.suffix` | `""` | Adds a suffix to the meta table
name. `value='test'` produces the table name `hbase:meta_test`. |
| `hbase.global.readonly.enabled` | `false` | Puts the entire cluster into
read-only mode. |
### New commands
-| Command | Usage
|
Description |
-| ---------------- |
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
|
------------------------------------------------------------------------------ |
-| `refresh_hfiles` | `refresh_hfiles`<br />`refresh_hfiles 'TABLE_NAME' =>
'tablename'`<br />`refresh_hfiles 'TABLE_NAME' => 'namespace:test_table'`<br
/>`refresh_hfiles 'NAMESPACE' => 'namespace'` | Refreshes HFiles from disk.
Used to pick up new edits on the read replica. |
-| `refresh_meta` | `refresh_meta`
|
Syncs the meta table with the backing storage. Used to pick up new tables and
regions. |
+| Command | Usage
| Description
|
+| ---------------- |
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------------
|
+| `refresh_hfiles` | `refresh_hfiles`<br />`refresh_hfiles 'TABLE_NAME' =>
'tablename'`<br />`refresh_hfiles 'TABLE_NAME' => 'namespace:test_table'`<br
/>`refresh_hfiles 'NAMESPACE' => 'namespace'` | Refreshes HFiles from disk.
Used to pick up new edits on the read replica. |
+| `refresh_meta` | `refresh_meta`
| Syncs the meta table with the backing
storage. Used to pick up new tables and regions. |
