You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ozone.apache.org by we...@apache.org on 2025/12/30 22:18:07 UTC

(ozone-site) branch HDDS-9225-website-v2 updated: HDDS-14272. [Website v2] [Docs] [Core Concepts] Ratis (#174)

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 5a622bc4d HDDS-14272. [Website v2] [Docs] [Core Concepts] Ratis (#174)
5a622bc4d is described below

commit 5a622bc4d4a194bfcc6304df1208875b293fd92a
Author: Wei-Chiu Chuang <we...@apache.org>
AuthorDate: Tue Dec 30 14:18:03 2025 -0800

    HDDS-14272. [Website v2] [Docs] [Core Concepts] Ratis (#174)
---
 docs/03-core-concepts/02-replication/03-ratis.md | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/docs/03-core-concepts/02-replication/03-ratis.md b/docs/03-core-concepts/02-replication/03-ratis.md
index 850d78b99..547389207 100644
--- a/docs/03-core-concepts/02-replication/03-ratis.md
+++ b/docs/03-core-concepts/02-replication/03-ratis.md
@@ -1,3 +1,22 @@
+---
+sidebar_label: Ratis
+---
+
 # Ratis
 
-**TODO:** File a subtask under [HDDS-9857](https://issues.apache.org/jira/browse/HDDS-9857) and complete this page or section.
+[Apache Ratis](https://ratis.apache.org/) is a highly customizable open-source Java implementation
+of the [Raft consensus protocol](https://raft.github.io/). Raft is an easily understandable consensus
+algorithm designed to manage replicated state. Unlike ZooKeeper or other Raft implementations such as etcd,
+Ratis is designed as a library rather than a standalone consensus server, which simplifies its management
+and integration.
+
+Ozone leverages Ratis to replicate system states across multiple nodes, ensuring high availability and
+redundancy. When using Ratis for replication, each piece of data written by clients is replicated to 3 Datanodes.
+Within Ozone, Ratis is employed in critical components such as the [Ozone Manager](../03-namespace/01-overview.md),
+[Storage Container Manager](../01-architecture.md), and Datanodes. It forms the central pillar for the
+High Availability (HA) mechanisms of both the Ozone Manager (OM-HA) and Storage Container Manager (SCM-HA).
+
+For more detailed information, please visit the [Apache Ratis website](https://ratis.apache.org/).
+
+For troubleshooting Ratis problems encountered in production, please refer to
+[Troubleshooting Ratis](/06-troubleshooting/13-ratis.md).


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@ozone.apache.org
For additional commands, e-mail: commits-help@ozone.apache.org