From 83d5b1829f72619ecc4b07ec683dd6f7b8827d31 Mon Sep 17 00:00:00 2001 From: Tsz-Wo Nicholas Sze Date: Wed, 14 Jan 2026 11:49:12 -0800 Subject: [PATCH 1/3] HDDS-14433. [Website v2] [Docs] [Core Concepts] Ratis configurations. --- .../docs/content/feature/multi-raft-support.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/hadoop-hdds/docs/content/feature/multi-raft-support.md b/hadoop-hdds/docs/content/feature/multi-raft-support.md index c0cd1b4c0433..e099e7518197 100644 --- a/hadoop-hdds/docs/content/feature/multi-raft-support.md +++ b/hadoop-hdds/docs/content/feature/multi-raft-support.md @@ -105,6 +105,22 @@ Ratis handles concurrent logs per node. The Ratis pipelines will be distributed accordingly. - Be cautious with very high pipeline counts due to memory/CPU overhead. +## Advanced Ratis Configuration + +Any Ratis configuration properties can be set using a corresponding prefix. +The following table shows the prefixes in each Ozone component. + +| Ozone Components | Configuration Prefixes | +|---------------------------------|-------------------------| +| Ozone Manager (OM) | `ozone.om.ha` | +| Storage Container Manager (SCM) | `ozone.scm.ha` | +| Recon | `ozone.recon.scmconfig` | +| Datanode | `hdds.ratis` | +| Ozone Client | `hdds.ratis` | + +See also [Apache Ratis configuration +documentation](https://github.com/apache/ratis/blob/ratis-3.2.1/ratis-docs/src/site/markdown/configurations.md). + ## Limitations - Global configuration: cannot set per-node limits - Requires restart after changing storage dirs From 9ece4ee33735274e623312a666ab520ac7e7f70f Mon Sep 17 00:00:00 2001 From: Tsz-Wo Nicholas Sze Date: Thu, 15 Jan 2026 10:37:32 -0800 Subject: [PATCH 2/3] Remove Recon. --- hadoop-hdds/docs/content/feature/multi-raft-support.md | 1 - 1 file changed, 1 deletion(-) diff --git a/hadoop-hdds/docs/content/feature/multi-raft-support.md b/hadoop-hdds/docs/content/feature/multi-raft-support.md index e099e7518197..92b3ea1e6b0a 100644 --- a/hadoop-hdds/docs/content/feature/multi-raft-support.md +++ b/hadoop-hdds/docs/content/feature/multi-raft-support.md @@ -114,7 +114,6 @@ The following table shows the prefixes in each Ozone component. |---------------------------------|-------------------------| | Ozone Manager (OM) | `ozone.om.ha` | | Storage Container Manager (SCM) | `ozone.scm.ha` | -| Recon | `ozone.recon.scmconfig` | | Datanode | `hdds.ratis` | | Ozone Client | `hdds.ratis` | From 47743551c99f4912a5241af0388e7f9e1997ede8 Mon Sep 17 00:00:00 2001 From: Tsz-Wo Nicholas Sze Date: Fri, 16 Jan 2026 12:13:20 -0800 Subject: [PATCH 3/3] Added examples --- .../docs/content/feature/multi-raft-support.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/hadoop-hdds/docs/content/feature/multi-raft-support.md b/hadoop-hdds/docs/content/feature/multi-raft-support.md index 92b3ea1e6b0a..ba6116daeb8b 100644 --- a/hadoop-hdds/docs/content/feature/multi-raft-support.md +++ b/hadoop-hdds/docs/content/feature/multi-raft-support.md @@ -107,15 +107,15 @@ Ratis handles concurrent logs per node. ## Advanced Ratis Configuration -Any Ratis configuration properties can be set using a corresponding prefix. +Any Ratis configuration properties can be set by prepending a corresponding prefix. The following table shows the prefixes in each Ozone component. -| Ozone Components | Configuration Prefixes | -|---------------------------------|-------------------------| -| Ozone Manager (OM) | `ozone.om.ha` | -| Storage Container Manager (SCM) | `ozone.scm.ha` | -| Datanode | `hdds.ratis` | -| Ozone Client | `hdds.ratis` | +| Ozone Components | Configuration Prefixes | Examples: To set `raft.server.write.byte-limit` | +|---------------------------------|------------------------|-------------------------------------------------| +| Ozone Manager (OM) | `ozone.om.ha.` | Use `ozone.om.ha.raft.server.write.byte-limit` | +| Storage Container Manager (SCM) | `ozone.scm.ha.` | Use `ozone.scm.ha.raft.server.write.byte-limit` | +| Datanode | `hdds.ratis.` | Use `hdds.ratis.raft.server.write.byte-limit` | +| Ozone Client | `hdds.ratis.` | Use `hdds.ratis.raft.server.write.byte-limit` | See also [Apache Ratis configuration documentation](https://github.com/apache/ratis/blob/ratis-3.2.1/ratis-docs/src/site/markdown/configurations.md).