This is an automated email from the ASF dual-hosted git repository.
weichiu pushed a commit to branch HDDS-9225-website-v2
in repository https://gitbox.apache.org/repos/asf/ozone-site.git
The following commit(s) were added to refs/heads/HDDS-9225-website-v2 by this
push:
new e06e11691 HDDS-14390. [Website v2] [Docs] [Administrator Guide]
Starting and Stopping the Ozone Cluster (#261)
e06e11691 is described below
commit e06e1169138baedde012e75e8459159f0b1a4196
Author: Wei-Chiu Chuang <[email protected]>
AuthorDate: Tue Jan 20 09:04:39 2026 -0800
HDDS-14390. [Website v2] [Docs] [Administrator Guide] Starting and Stopping
the Ozone Cluster (#261)
Co-authored-by: copilot-swe-agent[bot]
<[email protected]>
---
.../03-operations/01-start-and-stop.md | 79 +++++++++++++++++++++-
1 file changed, 78 insertions(+), 1 deletion(-)
diff --git a/docs/05-administrator-guide/03-operations/01-start-and-stop.md
b/docs/05-administrator-guide/03-operations/01-start-and-stop.md
index 22ff70966..81ffd06d3 100644
--- a/docs/05-administrator-guide/03-operations/01-start-and-stop.md
+++ b/docs/05-administrator-guide/03-operations/01-start-and-stop.md
@@ -4,4 +4,81 @@ sidebar_label: Start and Stop
# Starting and Stopping the Ozone Cluster
-**TODO:** File a subtask under
[HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this
page or section.
+This guide describes how to start and stop an Ozone cluster, assuming it has
already been configured and initialized.
+
+## Startup the cluster
+
+Run the following command on each SCM host:
+
+```bash
+ozone --daemon start scm
+```
+
+Run the following command on each OM host:
+
+```bash
+ozone --daemon start om
+```
+
+At this point Ozone's name services, the Ozone Manager, and the block service
SCM are both running.
+
+Now we need to start the Datanodes. Please run the following command on each
Datanode.
+
+```bash
+ozone --daemon start datanode
+```
+
+Wait until SCM exits safe mode
+
+```bash
+ozone admin safemode wait -t 240
+```
+
+At this point SCM, Ozone Manager and Datanodes are up and running and are
ready to serve requests.
+
+### Starting Optional Services
+
+If you need to start optional services like the Recon server, S3 Gateway, or
HttpFS Gateway, you can start them separately:
+
+```bash
+ozone --daemon start recon
+ozone --daemon start s3g
+ozone --daemon start httpfs
+```
+
+## Shortcut
+
+If you want to make your life simpler, you can just run:
+
+```bash
+start-ozone.sh
+```
+
+This assumes that you have set up the `workers` file correctly and ssh
configuration that allows ssh-ing to all Datanodes.
+
+1. You are expected to list all hostnames or IP addresses in your
`${OZONE_CONF_DIR}/workers` file, one per line.
+2. You have passwordless SSH access configured from the control node to all
other nodes in the cluster.
+
+## Stopping the Cluster
+
+To stop all core services, you can use the `stop-ozone.sh` script from your
SCM or OM node:
+
+```bash
+stop-ozone.sh
+```
+
+To stop services individually, you can run the following commands on their
respective nodes:
+
+```bash
+ozone --daemon stop scm
+ozone --daemon stop om
+ozone --daemon stop datanode
+```
+
+To stop optional services, run the following commands on their respective
nodes:
+
+```bash
+ozone --daemon stop recon
+ozone --daemon stop s3g
+ozone --daemon stop httpfs
+```
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
