This is an automated email from the ASF dual-hosted git repository.
weichiu 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 03c7f886c HDDS-14289. [Website v2] [Docs] [Core Concepts] Ozone
Manager High Availability (#250)
03c7f886c is described below
commit 03c7f886c5e6d73ecee0be0454c226f5839dc351
Author: Bolin Lin <[email protected]>
AuthorDate: Fri Jan 16 02:02:08 2026 -0500
HDDS-14289. [Website v2] [Docs] [Core Concepts] Ozone Manager High
Availability (#250)
---
.../05-high-availability/02-om-ha.md | 26 +++++++++++++++++++++
.../05-high-availability/HA-OM.png | Bin 0 -> 60888 bytes
.../06-high-availability/02-om-ha.md | 5 ++--
3 files changed, 29 insertions(+), 2 deletions(-)
diff --git a/docs/03-core-concepts/05-high-availability/02-om-ha.md
b/docs/03-core-concepts/05-high-availability/02-om-ha.md
new file mode 100644
index 000000000..8fad77eb6
--- /dev/null
+++ b/docs/03-core-concepts/05-high-availability/02-om-ha.md
@@ -0,0 +1,26 @@
+---
+sidebar_label: Ozone Manager High Availability
+---
+
+# Ozone Manager High Availability
+
+Ozone has two metadata-manager nodes (*Ozone Manager* for key space management
and *Storage Container Manager* for block space management) and multiple
storage nodes (Datanode). Data is replicated between Datanodes with the help of
RAFT consensus algorithm.
+
+To avoid any single point of failure the metadata-manager nodes also should
have a HA setup.
+
+Both Ozone Manager and Storage Container Manager supports HA. In this mode the
internal state is replicated via RAFT (with Apache Ratis).
+
+This page explains the HA setup of Ozone Manager (OM). Please check the [SCM
High Availability](./scm-ha) page for SCM HA. While they can be setup for HA
independently, a reliable, full HA setup requires enabling HA for both services.
+
+## How It Works
+
+A single Ozone Manager uses [RocksDB](https://github.com/facebook/rocksdb/) to
persist metadata (volumes, buckets, keys) locally. HA version of Ozone Manager
does exactly the same but all the data is replicated with the help of the RAFT
consensus algorithm to follower Ozone Manager instances.
+
+
+
+Client connects to the Leader Ozone Manager which processes the request and
schedules the replication with RAFT. When the request is replicated to all the
followers the leader can return with the response.
+
+## Learn More
+
+- **Configuration**: For detailed configuration instructions on setting up OM
HA, see the [OM HA
Configuration](/docs/administrator-guide/configuration/high-availability/om-ha)
documentation.
+- **Implementation Details**: For in-depth technical details about the OM HA
implementation, including the double buffer approach and automatic snapshot
installation, see the [OM HA Implementation
Details](/docs/system-internals/components/ozone-manager/high-availability)
documentation.
diff --git a/docs/03-core-concepts/05-high-availability/HA-OM.png
b/docs/03-core-concepts/05-high-availability/HA-OM.png
new file mode 100644
index 000000000..b1ff506f7
Binary files /dev/null and
b/docs/03-core-concepts/05-high-availability/HA-OM.png differ
diff --git
a/docs/05-administrator-guide/02-configuration/06-high-availability/02-om-ha.md
b/docs/05-administrator-guide/02-configuration/06-high-availability/02-om-ha.md
index 93b5674cd..d0560dcda 100644
---
a/docs/05-administrator-guide/02-configuration/06-high-availability/02-om-ha.md
+++
b/docs/05-administrator-guide/02-configuration/06-high-availability/02-om-ha.md
@@ -7,7 +7,7 @@ sidebar_label: OM HA Configuration
Ozone Manager (OM) High Availability ensures that there is no single point of
failure for the metadata-manager node responsible for key space management. In
HA mode, the internal state is replicated via RAFT (with Apache Ratis) across
multiple Ozone Manager instances.
:::info
-For conceptual information about OM HA, see the OM HA documentation. <!--
TODO: Link to OM HA conceptual documentation when created -->
+For conceptual information about OM HA, see the [OM HA
documentation](/docs/core-concepts/high-availability/om-ha).
:::
## Configuration
@@ -163,5 +163,6 @@ host3 | om3 | FOLLOWER
## References
-- OM HA - Conceptual overview and implementation details <!-- TODO: Link to OM
HA conceptual documentation when created -->
+- [Ozone Manager High
Availability](/docs/core-concepts/high-availability/om-ha) - Conceptual overview
+- [OM HA Implementation
Details](/docs/system-internals/components/ozone-manager/high-availability) -
Technical implementation details including double buffer and automatic snapshot
installation
- [SCM HA Configuration](./scm-ha) - Storage Container Manager High
Availability configuration
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
