@@ -17,15 +17,15 @@ Typical use cases:
1717- Stand up an isolated cluster for read-mostly experiments without copying data.
1818
1919<Callout type = " info" >
20- ** Eventual consistency.** A replica only sees data once (a) the active cluster has flushed the data to
21- HFiles in shared storage, and (b) the replica has been told to re-read shared storage via the
22- ` refresh_meta ` and ` refresh_hfiles ` commands. MemStore data on the active cluster is invisible to the
23- replica until flushed.
20+ ** Eventual consistency.** A replica only sees data once (a) the active cluster has flushed the
21+ data to HFiles in shared storage, and (b) the replica has been told to re-read shared storage via
22+ the ` refresh_meta ` and ` refresh_hfiles ` commands. MemStore data on the active cluster is invisible
23+ to the replica until flushed.
2424</Callout >
2525
2626The parent design lives on [ HBASE-29081] ( https://issues.apache.org/jira/browse/HBASE-29081 ) .
2727
28- ## Design
28+ ## Design [ #read-replica-cluster-design ]
2929
3030The feature has three parts.
3131
@@ -77,7 +77,7 @@ its cluster ID and meta suffix. `MasterFileSystem.negotiateActiveClusterSuffixFi
7777` AbstractReadOnlyController.manageActiveClusterIdFile ` handles the dynamic toggle: switching to read-only
7878deletes the file if this cluster owns it, and switching back to read-write creates the file if absent.
7979
80- ## Configuration
80+ ## Configuration [ #read-replica-cluster-configuration ]
8181
8282On every node of the ** read replica cluster** , add the following to ` hbase-site.xml ` :
8383
@@ -111,7 +111,7 @@ every replica's suffix), and leaves `hbase.global.readonly.enabled` unset or `fa
111111coprocessors without restarting the process. All nodes must agree on the value; operators are responsible for
112112keeping every ` hbase-site.xml ` in sync before issuing ` update_all_config ` .
113113
114- ## Operation and maintenance
114+ ## Operation and maintenance [ #read-replica-cluster-operation-and-maintenance ]
115115
116116### Case 1. Bring up a new read replica cluster
117117
@@ -190,16 +190,16 @@ mutations.
190190
191191## Configurations and Commands
192192
193- ### New configs
193+ ### New configs [ #read-replica-cluster-new-configs ]
194194
195- | Config | Default | Description |
196- | ------------------------------- | ------- | ---------------------------------------------------------------------------------------------- |
195+ | Config | Default | Description |
196+ | ------------------------------- | ------- | ----------------------------------------------------------------------------------------------- |
197197| ` hbase.meta.table.suffix ` | ` "" ` | Adds a suffix to the meta table name. ` value='test' ` produces the table name ` hbase:meta_test ` . |
198198| ` hbase.global.readonly.enabled ` | ` false ` | Puts the entire cluster into read-only mode. |
199199
200200### New commands
201201
202- | Command | Usage | Description |
203- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
204- | ` 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. |
205- | ` refresh_meta ` | ` refresh_meta ` | Syncs the meta table with the backing storage. Used to pick up new tables and regions. |
202+ | Command | Usage | Description |
203+ | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
204+ | ` 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. |
205+ | ` refresh_meta ` | ` refresh_meta ` | Syncs the meta table with the backing storage. Used to pick up new tables and regions. |
0 commit comments