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 2026/07/07 17:23:40 UTC
(ozone-site) branch master updated: HDDS-15017. [Website v2] [Docs] [Administrator Guide] Directory Configurations for Datanode. (#392)
This is an automated email from the ASF dual-hosted git repository.
jojochuang pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/ozone-site.git
The following commit(s) were added to refs/heads/master by this push:
new ca94e350f7 HDDS-15017. [Website v2] [Docs] [Administrator Guide] Directory Configurations for Datanode. (#392)
ca94e350f7 is described below
commit ca94e350f79cf138e1704d79ed5df246987b9b54
Author: Wei-Chiu Chuang <we...@apache.org>
AuthorDate: Tue Jul 7 10:23:35 2026 -0700
HDDS-15017. [Website v2] [Docs] [Administrator Guide] Directory Configurations for Datanode. (#392)
---
.../01-basic/03-directories/03-datanode.md | 16 ++++++++++++----
1 file changed, 12 insertions(+), 4 deletions(-)
diff --git a/docs/05-administrator-guide/02-configuration/01-basic/03-directories/03-datanode.md b/docs/05-administrator-guide/02-configuration/01-basic/03-directories/03-datanode.md
index 7cc4a1799f..50030d9bca 100644
--- a/docs/05-administrator-guide/02-configuration/01-basic/03-directories/03-datanode.md
+++ b/docs/05-administrator-guide/02-configuration/01-basic/03-directories/03-datanode.md
@@ -1,8 +1,16 @@
---
-draft: true
-sidebar_label: Datanodes
+sidebar_label: Datanode
---
-# Directory Configurations for Datanodes
+# Directory Configurations for Datanode
-**TODO:** File a subtask under [HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this page or section.
+This section describes directory-related configuration properties used by Datanodes.
+
+| Property Name | Description | Tags | Default/Example Value | Sample Value |
+| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ---------------------------------------------- | ------------------------------- |
+| `hdds.datanode.dir` | Local filesystem directories where HDDS stores data (container block files). Use comma-separated paths; tag each with a storage type (`[DISK]`, `[SSD]`, `[ARCHIVE]`, or `[RAM_DISK]`) for storage policies. | OZONE, CONTAINER, STORAGE, MANAGEMENT | Empty | `/data/hdds/disk1` |
+| `hdds.datanode.data.dir.permissions` | Permissions for Datanode **data** directories (octal or symbolic). | | `700` | `700` |
+| `hdds.datanode.container.db.dir` | Base location for per-disk RocksDB instances that hold container metadata. If unset, RocksDB is placed on the same disk as the matching HDDS data. Prefer fast storage (for example SSD). | OZONE, CONTAINER, STORAGE, MANAGEMENT | Empty | `/data/hdds/rocksdb` |
+| `hdds.container.ratis.datanode.storage.dir` | Directory for Datanode Ratis metadata (for example closed-container replication logs). If unset, falls back to default metadata dirs and a warning is logged. Use fast, durable storage. | OZONE, CONTAINER, STORAGE, MANAGEMENT, RATIS | Empty (uses default metadata dirs) | `/var/data/ozone/dn/ratis` |
+| `ozone.scm.datanode.id.dir` | Filesystem path where the Datanode stores its persistent **Datanode ID** file. If unset, the ID is created under the metadata directory. | OZONE, MANAGEMENT | Empty | `/var/lib/ozone/datanode-id` |
+| `ozone.metadata.dirs` | Fallback metadata root for Datanodes (and SCM, OM, Recon) when component-specific directories are not set. Fine for test/PoC; production should set explicit paths such as `hdds.container.ratis.datanode.storage.dir`. | OZONE, OM, SCM, CONTAINER, STORAGE, REQUIRED | Empty | `/data/ozone/metadata` |
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@ozone.apache.org
For additional commands, e-mail: commits-help@ozone.apache.org