Ozone Manager High Availability | 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:
2.1.1
Next
2.2.0
2.1.1
Overview
Quick Start
Core Concepts
Architecture
Replication
Namespace
Security
High Availability
SCM High Availability
Ozone Manager High Availability
Comparison with Other Storage Technologies
User Guide
Administrator Guide
System Internals
Developer Guide
This is documentation for Apache Ozone 2.1.1, which is no longer actively maintained.
For up-to-date documentation, see the latest version (2.2.0).
Core Concepts
High Availability
Ozone Manager High AvailabilityVersion: 2.1.1
On this page
Ozone Manager High Availability
Ozone has two metadata-manager nodes (Ozone Manager for key space management and Storage Container Manager for block space management) and multiple storage nodes (Datanode). Data is replicated between Datanodes with the help of RAFT consensus algorithm.
To avoid any single point of failure the metadata-manager nodes also should have a HA setup.
Both Ozone Manager and Storage Container Manager supports HA. In this mode the internal state is replicated via RAFT (with Apache Ratis).
This page explains the HA setup of Ozone Manager (OM). Please check the SCM High Availability page for SCM HA. While they can be setup for HA independently, a reliable, full HA setup requires enabling HA for both services.
How It Works​
A single Ozone Manager uses RocksDB to persist metadata (volumes, buckets, keys) locally. HA version of Ozone Manager does exactly the same but all the data is replicated with the help of the RAFT consensus algorithm to follower Ozone Manager instances.
Client connects to the Leader Ozone Manager which processes the request and schedules the replication with RAFT. When the request is replicated to all the followers the leader can return with the response.
Learn More​
Configuration: For detailed configuration instructions on setting up OM HA, see the OM HA Configuration documentation.
Implementation Details: For in-depth technical details about the OM HA implementation, including the double buffer approach and automatic snapshot installation
Edit this page
Previous
SCM High Availability
Next
Comparison with Other Storage Technologies
How It Works
Learn More
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.