You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ozone.apache.org by we...@apache.org on 2025/12/31 18:36:23 UTC

(ozone-site) branch HDDS-9225-website-v2 updated: HDDS-14257. [Website v2][Docs][Administrator Guide]Decommissioning a Storage Container Manager (#180)

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 95a880a47 HDDS-14257. [Website v2][Docs][Administrator Guide]Decommissioning a Storage Container Manager (#180)
95a880a47 is described below

commit 95a880a47d05160d19d6b8e915cacf4738f5804d
Author: Sarveksha Yeshavantha Raju <79...@users.noreply.github.com>
AuthorDate: Thu Jan 1 00:06:19 2026 +0530

    HDDS-14257. [Website v2][Docs][Administrator Guide]Decommissioning a Storage Container Manager (#180)
---
 .../02-storage-container-manager.md                | 32 +++++++++++++++++++++-
 1 file changed, 31 insertions(+), 1 deletion(-)

diff --git a/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/02-storage-container-manager.md b/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/02-storage-container-manager.md
index 01b074786..da84875fb 100644
--- a/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/02-storage-container-manager.md
+++ b/docs/05-administrator-guide/03-operations/03-node-decommissioning-and-maintenance/02-storage-container-manager.md
@@ -4,4 +4,34 @@ sidebar_label: Storage Container Manager
 
 # Decommissioning a Storage Container Manager
 
-**TODO:** File a subtask under [HDDS-9859](https://issues.apache.org/jira/browse/HDDS-9859) and complete this page or section.
+Storage Container Manager (SCM) decommissioning is the process in which you can gracefully remove one of the SCM from the SCM HA Ring.
+
+To decommission an SCM and remove the node from the SCM HA ring, the following steps need to be executed.
+
+```shell
+ozone admin scm decommission [-hV] [--service-id=<scmServiceId>] -nodeid=<nodeId>
+```
+
+You can obtain the `nodeId` by executing this command, `ozone admin scm roles`
+
+## Leader SCM
+
+If you want to decommission the **leader** SCM, you must first transfer the leadership to a different SCM and then decommission the node.
+
+To transfer the leader, we can execute below command,
+
+```shell
+ozone admin scm transfer [--service-id=<scmServiceId>] -n=<nodeId>
+```
+
+After successful leadership change you can proceed with decommissioning.
+
+## Primordial SCM
+
+If you want to decommission the **primordial** SCM, you have to change the `ozone.scm.primordial.node.id` property to point to a different SCM and then proceed with decommissioning.
+
+### Note
+
+During SCM decommissioning the private key of the decommissioned SCM should be manually deleted. The private keys can be found inside `hdds.metadata.dir`.
+
+Manual deletion is needed until we have certificate revocation support (HDDS-8399)


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@ozone.apache.org
For additional commands, e-mail: commits-help@ozone.apache.org