You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ozone.apache.org by um...@apache.org on 2026/02/03 08:43:53 UTC
(ozone-site) branch HDDS-9225-website-v2 updated: HDDS-14471. HBase integration user guide. (#316)
This is an automated email from the ASF dual-hosted git repository.
umamahesh pushed a commit to branch HDDS-9225-website-v2
in repository https://gitbox.apache.org/repos/asf/ozone-site.git
The following commit(s) were added to refs/heads/HDDS-9225-website-v2 by this push:
new d9e6a11e2 HDDS-14471. HBase integration user guide. (#316)
d9e6a11e2 is described below
commit d9e6a11e25de2ba99ab4e46db13d1f5a6179e776
Author: Uma Maheswara Rao G <um...@apache.org>
AuthorDate: Tue Feb 3 00:43:46 2026 -0800
HDDS-14471. HBase integration user guide. (#316)
---
docs/04-user-guide/03-integrations/09-hbase.md | 60 ++++++++++++++++++++++++++
1 file changed, 60 insertions(+)
diff --git a/docs/04-user-guide/03-integrations/09-hbase.md b/docs/04-user-guide/03-integrations/09-hbase.md
new file mode 100644
index 000000000..2087d0d57
--- /dev/null
+++ b/docs/04-user-guide/03-integrations/09-hbase.md
@@ -0,0 +1,60 @@
+---
+sidebar_label: HBase
+---
+
+# HBase
+
+Apache Ozone supports integration with Apache HBase, allowing you to use Ozone as the underlying storage layer for HBase tables. This integration leverages the `ofs://` scheme to provide a scalable and robust filesystem for HBase Region Servers.
+
+## Prerequisites
+
+- An active Apache Ozone cluster.
+- Ozone must be configured to use **Ratis replication**. HBase does not currently support Erasure Coded (EC) buckets.
+
+## Configuration Steps
+
+### 1. Ozone Setup
+
+Before configuring HBase, you must prepare the Ozone filesystem:
+
+- **Create Volume and Bucket:** Create a dedicated volume and bucket for HBase. Ensure the bucket is **File System Optimized (FSO)**.
+- **Permissions:** If using Apache Ranger, grant the `hbase` user `READ/WRITE` permissions for the specific Ozone volume and bucket.
+
+### 2. Ozone Service Configurations
+
+Update your `ozone-site.xml` (or via your cluster management tool) with the following properties to enable HBase compatibility:
+
+| Property | Value | Description |
+| :--- | :--- | :--- |
+| `ozone.fs.hsync.enabled` | `true` | Required for HBase WAL (Write Ahead Log) durability. |
+| `ozone.hbase.enhancements.allowed` | `true` | Enables Ozone-side optimizations for HBase. |
+| `ozone.client.hbase.enhancements.allowed` | `true` | Enables client-side optimizations. |
+| `ozone.client.stream.putblock.piggybacking` | `true` | Improves performance for small writes. |
+| `ozone.client.incremental.chunk.list` | `true` | Optimizes metadata handling for HBase. |
+
+### 3. HBase Service Configurations
+
+Configure HBase to point to the Ozone filesystem. Update `hbase-site.xml` with the following:
+
+- **Root Directory:** Set `hbase.rootdir` to your Ozone path using the `ofs://` scheme.
+
+ ```xml
+ <property>
+ <name>hbase.rootdir</name>
+ <value>ofs://[service-id]/[volume]/[bucket]/hbase</value>
+ </property>
+ ```
+
+- **Scheme Support:** Note that only `ofs://` is supported. The older `o3fs://` scheme is not supported for HBase integration.
+
+Now you are ready to start your HBase cluster with Ozone.
+
+## Support Matrix and Restrictions
+
+### Unsupported Features
+
+The following features are currently **not supported** when running HBase on Ozone:
+
+- **HBase Features:** Medium Object Storage (MOB), Favored Nodes, Hedged Read, Storage Policy, and Short Circuit Read.
+- **Ozone Features:** Snapshots, Erasure Coded (EC) buckets, and Object Store (OBS) buckets.
+- **Phoenix:** Phoenix User Defined Functions (UDF) are not supported on Ozone.
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@ozone.apache.org
For additional commands, e-mail: commits-help@ozone.apache.org