Ozone Configurations
Ozone Environment Directories
After consolidating the services under OZONE, use the following directories:
Directory | Path |
PID directory | /var/run/ozone |
Log directory | /var/log/ozone |
Configuration directory | /etc/ozone/conf |
Ozone Manager (OM) configuration directory | /etc/ozone/conf/ozone.om |
Library directory | /usr/odp/{stack_version}/ozone/share/ozone/lib |
Ozone home directory | /usr/odp/{stack_version}/ozone |
Replace {stack_version} with the installed ODP stack version.
Metadata Directories
Ozone Manager (OM)
Configuration Key | Default Value | Purpose |
|---|---|---|
ozone.om.db.dirs | /var/lib/ozone/om/ozone-metadata | Ozone Manager Metadata directories. This should be specified as a single directory |
ozone.om.ratis.storage.dir | /var/lib/ozone/om/ratis | Used for storing OM's Ratis metadata like logs. If undefined, OM ratis storage dir will fallback to ozone.metadata.dirs. |
ozone.om.ratis.snapshot.dir | /var/lib/ozone/om-snapshots | Directory to store OM's snapshot related files like the ratisSnapshotIndex and DB checkpoint from leader OM. |
Storage Container Manager (SCM)
Configuration Key | Default Value | Purpose |
|---|---|---|
ozone.scm.db.dirs | /var/lib/ozone/scm/data | Directory where the StorageContainerManager stores its metadata. This should be specified as a single directory. If the directory does not exist then the SCM will attempt to create it. |
ozone.scm.ha.ratis.storage.dir | /var/lib/ozone/scm/ratis | Storage directory used by SCM to write Ratis logs. |
hdds.metadata.dir | /var/lib/ozone/hdds-metadata | Absolute path to HDDS metadata dir. Part of SCM balancer properties. |
Datanode (DN)
Configuration Key | Default Value | Purpose |
|---|---|---|
hdds.datanode.dir | /data/hadoop-ozone/datanode/data | Determines where on the local filesystem HDDS data will be stored. Defaults to dfs.datanode.data.dir if not specified. |
ozone.metadata.dirs | /var/lib/ozone/services-metadata/dn-metadata | Fallback location for SCM, OM, Recon and DataNodes to store their metadata. In ODP ozone, used only for datanode metadata. |
dfs.container.ratis.datanode.storage.dir | /var/lib/ozone/datanode/ratis/data | Ozone Datanode Ratis Data Directory, to store metadata like logs |
ozone.scm.datanode.id.dir | /var/lib/ozone/datanode | The path that datanodes will use to store the datanode ID. |
Recon Service
Configuration Key | Default Value | Purpose |
|---|---|---|
ozone.recon.db.dir | /var/lib/ozone/recon/data | Ozone RECON UI data directory. This should be specified as a single directory. If the directory does not exist then the Recon will attempt to create it. |
ozone.recon.om.db.dir | /var/lib/ozone/recon/om/data | Directory where the Recon Server stores its OM snapshot DB. This should be specified as a single directory. If the directory does not exist then the Recon will attempt to create it. |
ozone.recon.scm.db.dirs | /var/lib/ozone/recon/scm/data | Directory where the Recon Server stores its SCM snapshot DB. This should be specified as a single directory. If the directory does not exist then the Recon will attempt to create it. |
Ozone Service Endpoints
To view the list of Ozone service endpoints, see Configuring Ports.
S3 Gateaway (S3G)
Default Port | Configuration key | Endpoint Protocol | Purpose |
|---|---|---|---|
9878 | ozone.s3g.http-port | HTTP | S3 API REST Endpoint |
9879 | ozone.s3g.https-port | HTTPS | S3 API REST Endpoint |
0.0.0.0:19878 | ozone.s3g.webadmin.http-address | HTTP | The address and port where Ozone S3Gateway serves web content (like admin and jmx endpoints) |
0.0.0.0:19879 | ozone.s3g.webadmin.https-address | HTTPS | The address and port where Ozone S3Gateway serves web content (like admin and jmx endpoints) |

Have a suggestion?