This is an automated email from the ASF dual-hosted git repository.
sarvekshayr 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 3ff7b9a6b HDDS-10451. Transfer leadership documentation (#168)
3ff7b9a6b is described below
commit 3ff7b9a6b936de6674b7cc594804cecc37d20e72
Author: Sarveksha Yeshavantha Raju
<[email protected]>
AuthorDate: Fri Dec 19 12:42:51 2025 +0530
HDDS-10451. Transfer leadership documentation (#168)
---
.../10-leader-transfer/01-ozone-manager.md | 32 ++++++++++++++++++++
.../02-storage-container-manager.md | 34 ++++++++++++++++++++++
.../03-operations/10-leader-transfer/README.mdx | 7 +++++
3 files changed, 73 insertions(+)
diff --git
a/docs/05-administrator-guide/03-operations/10-leader-transfer/01-ozone-manager.md
b/docs/05-administrator-guide/03-operations/10-leader-transfer/01-ozone-manager.md
new file mode 100644
index 000000000..ceaec61c4
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/10-leader-transfer/01-ozone-manager.md
@@ -0,0 +1,32 @@
+---
+sidebar_label: Ozone Manager
+---
+
+# Ozone Manager Leader Transfer
+
+The `ozone admin om transfer` command allows you to manually transfer the
leadership of the Ozone Manager (OM) Raft group to a specific OM node or to a
randomly chosen follower.
+
+## Usage
+
+```bash
+ozone admin om transfer -id <OM_SERVICE_ID> -n <NEW_LEADER_ID>
+ozone admin om transfer -id <OM_SERVICE_ID> -r
+```
+
+- `-id, --service-id`: Specifies the Ozone Manager Service ID.
+- `-n, --newLeaderId, --new-leader-id`: The node ID of the OM to which
leadership will be transferred (e.g., `om1`).
+- `-r, --random`: Randomly chooses a follower to transfer leadership to.
+
+## Example
+
+To transfer leadership to `om2` in a cluster with service ID `cluster1`:
+
+```bash
+ozone admin om transfer -id cluster1 -n om2
+```
+
+To transfer leadership to a random follower:
+
+```bash
+ozone admin om transfer -id cluster1 -r
+```
diff --git
a/docs/05-administrator-guide/03-operations/10-leader-transfer/02-storage-container-manager.md
b/docs/05-administrator-guide/03-operations/10-leader-transfer/02-storage-container-manager.md
new file mode 100644
index 000000000..0fcd188b2
--- /dev/null
+++
b/docs/05-administrator-guide/03-operations/10-leader-transfer/02-storage-container-manager.md
@@ -0,0 +1,34 @@
+---
+sidebar_label: Storage Container Manager
+---
+
+# Storage Container Manager Leader Transfer
+
+The `ozone admin scm transfer` command allows you to manually transfer the
leadership of the Storage Container Manager (SCM) Raft group to a specific SCM
node or to a randomly chosen follower.
+
+Be aware of the node's status(eg. Safemode, Operational status), Ozone
currently has no ability to check the target node's status before transferring
the leadership.
+
+## Usage
+
+```bash
+ozone admin scm transfer -id <SCM_SERVICE_ID> -n <NEW_LEADER_ID>
+ozone admin scm transfer -id <SCM_SERVICE_ID> -r
+```
+
+- `-id, --service-id`: Specifies the SCM Service ID.
+- `-n, --newLeaderId, --new-leader-id`: The SCM UUID (Raft peer ID) of the SCM
to which leadership will be transferred (e.g.,
`e6877ce5-56cd-4f0b-ad60-4c8ef9000882`).
+- `-r, --random`: Randomly chooses a follower to transfer leadership to.
+
+## Example
+
+To transfer leadership to a specific SCM in a cluster with service ID
`cluster1`:
+
+```bash
+ozone admin scm transfer -id cluster1 -n e6877ce5-56cd-4f0b-ad60-4c8ef9000882
+```
+
+To transfer leadership to a random follower:
+
+```bash
+ozone admin scm transfer -id cluster1 -r
+```
diff --git
a/docs/05-administrator-guide/03-operations/10-leader-transfer/README.mdx
b/docs/05-administrator-guide/03-operations/10-leader-transfer/README.mdx
new file mode 100644
index 000000000..a46b8bc97
--- /dev/null
+++ b/docs/05-administrator-guide/03-operations/10-leader-transfer/README.mdx
@@ -0,0 +1,7 @@
+# Leader Transfer
+
+import DocCardList from '@theme/DocCardList';
+
+This section contains instructions to manually transfer the leadership to a
specific node or to a randomly chosen follower.
+
+<DocCardList/>
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
