This is an automated email from the ASF dual-hosted git repository.
weichiu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/ozone.git
The following commit(s) were added to refs/heads/master by this push:
new 80178230d8 HDDS-9181. Provide documentation for Decommissioning in
Ozone in Mandarin (#6047)
80178230d8 is described below
commit 80178230d897f5bf8744929f10508b22fdbb5e3a
Author: david1859168 <[email protected]>
AuthorDate: Tue Jan 23 16:36:01 2024 +1100
HDDS-9181. Provide documentation for Decommissioning in Ozone in Mandarin
(#6047)
Co-authored-by: David Wang <[email protected]>
---
.../docs/content/feature/Decommission.zh.md | 96 ++++++++++++++++++++++
1 file changed, 96 insertions(+)
diff --git a/hadoop-hdds/docs/content/feature/Decommission.zh.md
b/hadoop-hdds/docs/content/feature/Decommission.zh.md
new file mode 100644
index 0000000000..ad959469b9
--- /dev/null
+++ b/hadoop-hdds/docs/content/feature/Decommission.zh.md
@@ -0,0 +1,96 @@
+---
+title: "Decommissioning"
+weight: 1
+menu:
+ main:
+ parent: 特性
+summary: Decommissioning of SCM, OM and Datanode.
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+# DataNode Decommission
+
+DataNode
Decommission是从Ozone集群中删除现有DataNode的过程中，同时确保新数据不会被写入正在Decommission的DataNode。当你启动DataNode
Decommission的操作时候，Ozone会自动确保在Decommission完成之前，该数据节点上的所有Storage
containers都在另一个DataNode上创建了额外的副本。因此，DataNode在Decommission完成后可以继续运行，并可用于读取，但不能用于写入，直到手动停止DataNode的服务。
+
+当我们启动Decommission时，这个操作首先要检查节点的当前状态，理想情况下应该是 "IN_SERVICE"，然后将其状态更改为
"DECOMMISSIONING"，并启动Decommission的流程：
+
+1. 首先它会触发一个事件，关闭节点上的所有Pipelines，同时关闭所有Containers。
+
+2. 然后获取节点上的Container信息，并检查是否需要新的副本。如果需要，创建新的副本的任务就会被调度起来。
+
+3. 复制任务被调度后，节点仍处于待处理状态，直到复制任务完成。
+
+4. 在此阶段，节点将完成Decommission的过程，然后节点状态将更改为 "DECOMMISSIONED"。
+
+要检查DataNode的当前状态，可以执行以下命令,
+```shell
+ozone admin datanode list
+```
+
+要decommission某台datanode的时候，可以执行下面的命令,
+
+```shell
+ozone admin datanode decommission [-hV] [-id=<scmServiceId>]
+ [--scm=<scm>] [<hosts>...]
+```
+您可以输入多个主机，以便一起Decommission多个DataNode。
+
+**Note:** 要Recommission某台DataNode的时候，可在命令行执行以下命令,
+```shell
+ozone admin datanode recommission [-hV] [-id=<scmServiceId>]
+ [--scm=<scm>] [<hosts>...]
+```
+
+# OM Decommission
+
+Ozone Manager（OM）Decommissioning是指从 OM HA Ring 中从容地(gracefully)移除一个 OM 的过程。
+
+要Decommission OM 并将这个节点从 OM HA ring中移除，需要执行以下步骤。
+1. 将要被Decommission的 OM 节点的 _OM NodeId_ 添加到所有其他 OM 的 _ozone-site.xml_ 中的
_ozone.om.decommissioned.nodes.<omServiceId>_ 属性中。
+2. 运行以下命令Decommission这台 OM 节点.
+```shell
+ozone admin om decommission -id=<om-service-id>
-nodeid=<decommissioning-om-node-id>
-hostname=<decommissioning-om-node-address> [optional --force]
+```
+ _force选项将跳过检查 _ozone-site.xml_ 中的 OM 配置是否已更新，并将Decommission节点添加至
_**ozone.om.decommissioned.nodes**_ 配置中. <p>**Note -** 建议在Decommissioning一个 OM
节点之前bootstrap另一个 OM 节点，以保持OM的高可用性（HA）.</p>
+
+# SCM Decommission
+
+存储容器管理器 (SCM) Decommissioning 是允许您从容地(gracefully)将一个 SCM 从 SCM HA Ring 中移除的过程。
+
+在Decommission一台SCM，并将其从SCM HA ring中移除时，需要执行以下步骤。
+```shell
+ozone admin scm decommission [-hV] [--service-id=<scmServiceId>]
-nodeid=<nodeId>
+```
+执行以下命令可获得 "nodeId"： **"ozone admin scm roles "**
+
+### Leader SCM
+如果需要decommission **leader** SCM, 您必须先将leader的角色转移到另一个 scm，然后再Decommission这个节点。
+
+您可以使用以下的命令来转移leader的角色，
+```shell
+ozone admin scm transfer [--service-id=<scmServiceId>] -n=<nodeId>
+```
+在Leader的角色成功地转移之后，您可以继续decommission的操作。
+
+### Primordial SCM
+如果要decommission **primordial** scm，必须更改 _ozone.scm.primordial.node.id_
的属性，使其指向不同的 SCM，然后再继续decommissioning。
+
+### 注意
+在运行SCM decommissioning的操作期间，应手动删除decommissioned SCM的私钥。私钥可在
_hdds.metadata.dir_ 中找到。
+
+在支持证书吊销之前（HDDS-8399），需要手动删除decommissioned SCM上的证书。
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
