Skip to main content
Version: Next

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.

HA OM

Client connects to the Leader Ozone Manager which processes the request and schedules the replication with RAFT. When the request is persisted to the Raft logs of a majority of voting OMs, the leader can return with the response.

Fault tolerance​

OM HA group can have more than three voting members. Raft requires a majority of voting members to elect a leader and commit requests:

Voting membersMajority requiredFailures tolerated
220
321
431
532
642

An even number of voting members works, but adds no failure tolerance compared with the preceding odd number. Three voting members tolerate one failure; five tolerate two, allowing one node to fail while another is down for maintenance. Deploy voting members on independent hosts. Listener OMs do not count toward the voting majority or increase failure tolerance.

Learn More​

  • Configuration: For detailed configuration instructions on setting up OM HA, see the OM HA Configuration documentation.

  • Read scaling: To add read-only, non-voting OM replicas (Listener OMs), see Listener OM.

  • Migrating OM hosts: For configuration-based and DNS-based host replacement procedures, see OM migration approaches.

  • Implementation Details: For in-depth technical details about the OM HA implementation, including the double buffer approach and automatic snapshot installation, see the OM HA Implementation Details documentation.