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 8455924f8 HDDS-14499. [Website v2] [Docs] [Administrator Guide]
Advanced Ratis configuration. (#284)
8455924f8 is described below
commit 8455924f831af7259f8cbb5ba696b97b12aa6240
Author: Russole <[email protected]>
AuthorDate: Mon Jan 26 05:41:18 2026 +0800
HDDS-14499. [Website v2] [Docs] [Administrator Guide] Advanced Ratis
configuration. (#284)
---
.../04-performance/03-multi-raft.md | 25 +++++++++++++++++-----
1 file changed, 20 insertions(+), 5 deletions(-)
diff --git
a/docs/05-administrator-guide/02-configuration/04-performance/03-multi-raft.md
b/docs/05-administrator-guide/02-configuration/04-performance/03-multi-raft.md
index 7a84e60c4..28221e35f 100644
---
a/docs/05-administrator-guide/02-configuration/04-performance/03-multi-raft.md
+++
b/docs/05-administrator-guide/02-configuration/04-performance/03-multi-raft.md
@@ -45,13 +45,13 @@ Ratis handles concurrent logs per node.
- `ozone.scm.datanode.pipeline.limit` (default: 2)
- The maximum number of pipelines per Datanode can be engaged in.
The value 0 means that the pipeline limit per Datanode will be determined
- by the number of metadata disks reported per Datanode;
- see the next property.
+ by the number of metadata disks reported per Datanode;
+ see the next property.
- `ozone.scm.pipeline.per.metadata.disk` (default: 2)
- The maximum number of pipelines for a Datanode is determined
- by the number of disks in that Datanode.
- This property is effective only when the previous property is set to 0.
- The value of this property must be greater than 0.
+ by the number of disks in that Datanode.
+ This property is effective only when the previous property is set to 0.
+ The value of this property must be greater than 0.
## How to Use
@@ -95,6 +95,21 @@ 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 by prepending a corresponding
prefix.
+The following table shows the prefixes in each Ozone component.
+
+| 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).
+
## Limitations
- Global configuration: cannot set per-node limits
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
