Cluster expansion | Apache Ozone
Skip to main content
Apache Ozone
Docs
Latest Docs
Docs 2.0.0 (Archived)
Docs 1.4.1 (Archived)DownloadRoadmapBlog
Community
Communication Channels
Who Uses Ozone?
Report An Issue
Ask a Question
How to Contribute
Events and Media
Search
Version:
Next
Next
2.2.0
2.1.1
Overview
Quick Start
Core Concepts
User Guide
Administrator Guide
Installation
Configuration
Operations
Start and Stop
Upgrade and Downgrade
Decommissioning and Maintenance
Disk Replacement
Container Replication Report
Data Balancing
S3 Multi-Tenancy
Snapshots
Observability
Leader Transfer
Quota in Ozone
Tools
Trash
Dynamic Property Reload
Cluster expansion
System Internals
Developer Guide
This is unreleased documentation for Apache Ozone Next version.
For up-to-date documentation, see the latest version (2.2.0).
Administrator Guide
Operations
Cluster expansionVersion: Next
On this page
Cluster expansion
This guide covers common ways to grow capacity: new Datanodes, extra disks on existing Datanodes, and more memory (heap) for a Datanode. These operations are supported; Ozone picks up new nodes and storage through normal Datanode registration and heartbeat metadata—no separate “sync” step is required beyond correct configuration and restart where noted.
Adding capacity does not immediately redistribute existing data. New writes use the expanded cluster; to spread load or disk usage, use the balancers linked below.
Add a new Datanode​
Prepare the host (OS, Java, network, users/permissions) and install Ozone binaries—same as any new node. See the bare-metal installation guide and Installing Ozone binaries.
Copy or generate ozone-site.xml (and related config) so this node matches the cluster’s OM/SCM addresses, security settings, and storage layout conventions.
Start the Datanode on the new host:
ozone --daemon start datanode
For a full startup order and optional scripts, see Starting and Stopping the Ozone Cluster.
After the Datanode registers with SCM, its capacity is available for new containers and replicas.
Balance load across Datanodes​
To move existing closed containers toward an even utilization of the cluster, run the Container Balancer after expansion.
Add a disk to an existing Datanode​
Install the disk, format it, and mount it on the host.
Ensure the Ozone process user can read/write the mount (ownership and permissions).
Append the new mount path to hdds.datanode.dir in ozone-site.xml (comma-separated list). See the configuration appendix for property details.
Restart the Datanode so it picks up the new volume.
SCM learns the added capacity through the Datanode’s storage reports.
Balance traffic across disks​
To shift work between disks on the same Datanode, use the Disk Balancer.
Increase Datanode memory (heap)​
You do not need Ozone configuration keys to use additional RAM on the host; the process can use what the OS provides.
To raise the Datanode Java heap explicitly, set the environment (for example in the service environment file or before launch), then restart the Datanode:
OZONE_HEAPSIZE_MAX — sets the maximum heap (-Xmx).
OZONE_DATANODE_OPTS — additional JVM options for Datanodes.
See Environment variables for descriptions and examples.
CPU: Extra vCPUs or sockets do not require Ozone-specific settings; the running Datanode benefits after restart if you also change JVM or service limits at the OS level.
Edit this page
Previous
Dynamic Property Reload
Next
System Internals
Add a new Datanode
Balance load across Datanodes
Add a disk to an existing Datanode
Balance traffic across disks
Increase Datanode memory (heap)
Apache Software Foundation
Foundation
License
Events
Sponsorship
Privacy
Security
Thanks
Community
GitHub Discussions
Jira Issues
Slack
Mailing List
YouTube
Twitter
Repositories
Ozone
Website
Docker Image
Docker Runner Image
Copyright © 2026 The Apache Software Foundation. Licensed under the Apache License, Version 2.0.
The Apache Software Foundation, Apache Ozone, Ozone, Apache, the Apache Feather, and the Apache Ozone project logo are either registered trademarks or trademarks of the Apache Software Foundation.