Ozone Admin | 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
User Guide
Administrator Guide
Installation
Configuration
Operations
Start and Stop
Upgrade and Downgrade
Decommissioning and Maintenance
Disk Replacement
Container Replication Report
Data Balancing
Certificate Rotation
S3 Multi-Tenancy
Snapshots
Observability
Leader Transfer
Quota in Ozone
Tools
Ozone Repair
Ozone Admin
Ozone Debug
Trash
Dynamic Property Reload
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).
Administrator Guide
Operations
Tools
Ozone AdminVersion: 2.1.1
Ozone Admin
ozone admin command is a collection of tools intended to be used only by admins.
A quick overview of the available functionalities:
ozone admin safemode
Check the safe mode status and force entering or leaving safe mode.
The --verbose option prints the validation status of all rules that evaluate safe mode status.
ozone admin container
Containers are the unit of replication.
Subcommands help debug the current container state (list / get / create / …).
ozone admin pipeline
Helps check available pipelines (Datanodes sets).
ozone admin datanode
Provides information about Datanodes.
ozone admin printTopology
Displays rack-awareness related information.
ozone admin replicationmanager
Checks replication status and can start or stop replication in emergencies.
ozone admin om
Ozone Manager HA related tools to retrieve cluster information.
For more detailed usage, see the output of --help.
$ ozone admin --help
Usage: ozone admin [-hV] [--verbose] [-conf=<configurationPath>]
[-D=<String=String>]... [COMMAND]
Developer tools for Ozone Admin operations
Options:
-conf=<configurationPath>
-D, --set=<String=String>
-h, --help      Show this help message and exit.
-V, --version   Print version information and exit.
--verbose   More verbose output. Show the stack trace of the errors.
Commands:
containerbalancer   ContainerBalancer specific operations
replicationmanager  ReplicationManager specific operations
safemode            Safe mode specific operations
printTopology       Print a tree of the network topology as reported by SCM
cert                Certificate related operations
container           Container specific operations
datanode            Datanode specific operations
pipeline            Pipeline specific operations
namespace           Namespace Summary specific admin operations
om                  Ozone Manager specific admin operations
reconfig            Dynamically reconfigure server without restarting it
scm                 Ozone Storage Container Manager specific admin operations
Edit this page
Previous
Ozone Repair
Next
Ozone Debug
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.