docs: refine dnode management page

docs-cn/10-cluster/02-cluster-mgmt.md

@@ -2,7 +2,7 @@
 title: 数据节点管理
 ---
 
-上面已经介绍如何从零开始搭建集群。集群组建完后，还可以随时添加新的数据节点进行扩容，或删除数据节点，并检查集群当前状态。
+上面已经介绍如何从零开始搭建集群。集群组建完后，可以随时查看集群中当前的数据节点的状态、还可以添加新的数据节点进行扩容，或删除数据节点。
 
 :::note
 
@@ -10,6 +10,63 @@ title: 数据节点管理
 
 :::
 
+## 查看数据节点
+
+启动 TDengine CLI 程序 taos，然后执行：
+
+```sql
+SHOW DNODES;
+```
+
+它将列出集群中所有的 dnode，每个 dnode 的 ID，end_point（fqdn:port），状态（ready，offline 等），vnode 数目，还未使用的 vnode 数目等信息。在添加或删除一个数据节点后，可以使用该命令查看。
+
+输出如下（具体内容仅供参考，取决于实际的集群配置）
+
+```bash
+taos> show dnodes;
+   id   |           end_point            | vnodes | cores  |   status   | role  |       create_time       |      offline reason      |
+======================================================================================================================================
+      1 | localhost:6030                 |      9 |      8 | ready      | any   | 2022-04-15 08:27:09.359 |                          |
+Query OK, 1 row(s) in set (0.008298s)
+```
+
+## 查看虚拟节点组
+
+为充分利用多核技术，并提供 scalability，数据需要分片处理。因此 TDengine 会将一个 DB 的数据切分成多份，存放在多个 vnode 里。这些 vnode 可能分布在多个数据节点 dnode 里，这样就实现了水平扩展。一个 vnode 仅仅属于一个 DB，但一个 DB 可以有多个 vnode。vnode 所在的数据节点是 mnode 根据当前系统资源的情况，自动进行分配的，无需任何人工干预。
+
+启动 CLI 程序 taos，然后执行：
+
+```sql
+USE SOME_DATABASE;
+SHOW VGROUPS;
+```
+
+输出如下（具体内容仅供参考，取决于实际的集群配置）
+
+```bash
+taos> show dnodes;
+   id   |           end_point            | vnodes | cores  |   status   | role  |       create_time       |      offline reason      |
+======================================================================================================================================
+      1 | localhost:6030                 |      9 |      8 | ready      | any   | 2022-04-15 08:27:09.359 |                          |
+Query OK, 1 row(s) in set (0.008298s)
+
+taos> use db;
+Database changed.
+
+taos> show vgroups;
+    vgId     |   tables    |  status  |   onlines   | v1_dnode | v1_status | compacting  |
+==========================================================================================
+          14 |       38000 | ready    |           1 |        1 | master    |           0 |
+          15 |       38000 | ready    |           1 |        1 | master    |           0 |
+          16 |       38000 | ready    |           1 |        1 | master    |           0 |
+          17 |       38000 | ready    |           1 |        1 | master    |           0 |
+          18 |       37001 | ready    |           1 |        1 | master    |           0 |
+          19 |       37000 | ready    |           1 |        1 | master    |           0 |
+          20 |       37000 | ready    |           1 |        1 | master    |           0 |
+          21 |       37000 | ready    |           1 |        1 | master    |           0 |
+Query OK, 8 row(s) in set (0.001154s)
+```
+
 ## 添加数据节点
 
 启动 CLI 程序 taos，然后执行：
@@ -20,15 +77,66 @@ CREATE DNODE "fqdn:port";
 
 将新数据节点的 End Point 添加进集群的 EP 列表。“fqdn:port“需要用双引号引起来，否则出错。一个数据节点对外服务的 fqdn 和 port 可以通过配置文件 taos.cfg 进行配置，缺省是自动获取。【强烈不建议用自动获取方式来配置 FQDN，可能导致生成的数据节点的 End Point 不是所期望的】
 
+示例如下：
+```bash
+taos> create dnode "localhost:7030";
+Query OK, 0 of 0 row(s) in database (0.008203s)
+
+taos> show dnodes;
+   id   |           end_point            | vnodes | cores  |   status   | role  |       create_time       |      offline reason      |
+======================================================================================================================================
+      1 | localhost:6030                 |      9 |      8 | ready      | any   | 2022-04-15 08:27:09.359 |                          |
+      2 | localhost:7030                 |      0 |      0 | offline    | any   | 2022-04-19 08:11:42.158 | status not received      |
+Query OK, 2 row(s) in set (0.001017s)
+```
+
+在上面的示例中可以看到新创建的 dnode 的状态为 offline，待该 dnode 被启动并连接上配置文件中指定的 firstEp后再次查看，得到如下结果（示例）
+
+```bash
+taos> show dnodes;
+   id   |           end_point            | vnodes | cores  |   status   | role  |       create_time       |      offline reason      |
+======================================================================================================================================
+      1 | localhost:6030                 |      3 |      8 | ready      | any   | 2022-04-15 08:27:09.359 |                          |
+      2 | localhost:7030                 |      6 |      8 | ready      | any   | 2022-04-19 08:14:59.165 |                          |
+Query OK, 2 row(s) in set (0.001316s)
+```
+从中可以看到两个 dnode 状态都为 ready
+
+
 ## 删除数据节点
 
 启动 CLI 程序 taos，然后执行：
 
 ```sql
-DROP DNODE "fqdn:port | dnodeID";
+DROP DNODE "fqdn:port";
+```
+或者
+```sql
+DROP DNODE dnodeId;
+```
+
+通过 “fqdn:port” 或 dnodeID 来指定一个具体的节点都是可以的。其中 fqdn 是被删除的节点的 FQDN，port 是其对外服务器的端口号；dnodeID 可以通过 SHOW DNODES 获得。
+
+示例如下：
+```bash
+taos> show dnodes;
+   id   |           end_point            | vnodes | cores  |   status   | role  |       create_time       |      offline reason      |
+======================================================================================================================================
+      1 | localhost:6030                 |      9 |      8 | ready      | any   | 2022-04-15 08:27:09.359 |                          |
+      2 | localhost:7030                 |      0 |      0 | offline    | any   | 2022-04-19 08:11:42.158 | status not received      |
+Query OK, 2 row(s) in set (0.001017s)
+
+taos> drop dnode 2;
+Query OK, 0 of 0 row(s) in database (0.000518s)
+
+taos> show dnodes;
+   id   |           end_point            | vnodes | cores  |   status   | role  |       create_time       |      offline reason      |
+======================================================================================================================================
+      1 | localhost:6030                 |      9 |      8 | ready      | any   | 2022-04-15 08:27:09.359 |                          |
+Query OK, 1 row(s) in set (0.001137s)
 ```
 
-通过 “fqdn:port” 或 “dnodeID” 来指定一个具体的节点都是可以的。其中 fqdn 是被删除的节点的 FQDN，port 是其对外服务器的端口号；dnodeID 可以通过 SHOW DNODES 获得。
+上面的示例中，初次执行 show dnodes 列出了两个 dnode, 执行 drop dnode 2 删除其中 ID 为 2 的 dnode 之后再次执行 show dnode，可以看到只剩下 ID 为 1 的dnode.
 
 :::warning
 
@@ -51,31 +159,58 @@ ALTER DNODE <source-dnodeId> BALANCE "VNODE:<vgId>-DNODE:<dest-dnodeId>";
 
 其中：source-dnodeId 是源 dnodeId，也就是待迁移的 vnode 所在的 dnodeID；vgId 可以通过 SHOW VGROUPS 获得，列表的第一列；dest-dnodeId 是目标 dnodeId。
 
-:::warning
-
-只有在集群的自动负载均衡选项关闭时（balance 设置为 0），才允许手动迁移。
-只有处于正常工作状态的 vnode 才能被迁移：master/slave；当处于 offline/unsynced/syncing 状态时，是不能迁移的。
-迁移前，务必核实目标 dnode 的资源足够：CPU、内存、硬盘。
+首先执行 `show vgroups` 查看 vgroup 的分布情况 
+```
+taos> show vgroups;
+    vgId     |   tables    |  status  |   onlines   | v1_dnode | v1_status | compacting  |
+==========================================================================================
+          14 |       38000 | ready    |           1 |        3 | master    |           0 |
+          15 |       38000 | ready    |           1 |        3 | master    |           0 |
+          16 |       38000 | ready    |           1 |        3 | master    |           0 |
+          17 |       38000 | ready    |           1 |        3 | master    |           0 |
+          18 |       37001 | ready    |           1 |        3 | master    |           0 |
+          19 |       37000 | ready    |           1 |        1 | master    |           0 |
+          20 |       37000 | ready    |           1 |        1 | master    |           0 |
+          21 |       37000 | ready    |           1 |        1 | master    |           0 |
+Query OK, 8 row(s) in set (0.001314s)
+```
 
-:::
+从中可以看到在 dnode 3 中有5个 vgroup，而 dnode 1 有 3 个 vgroup，假定我们想将其中 vgId 为18 的 vgroup 从 dnode 3 迁移到 dnode 1
 
-## 查看数据节点
+```
+taos> alter dnode 3 balance "vnode:18-dnode:1";
 
-启动 CLI 程序 taos，然后执行：
+DB error: Balance already enabled (0.00755
+```
 
-```sql
-SHOW DNODES;
+上面的结果表明目前所在数据库已经启动了 balance 选项，所以无法进行手动迁移。
+
+停止整个集群，将两个 dnode 的配置文件中的 balance 都设置为 0 （默认为1）之后，重新启动集群，再次执行 ` alter dnode` 和 `show vgroups` 命令如下
+```bash
+taos> alter dnode 3 balance "vnode:18-dnode:1";
+Query OK, 0 row(s) in set (0.000575s)
+
+taos> show vgroups;
+    vgId     |   tables    |  status  |   onlines   | v1_dnode | v1_status | v2_dnode | v2_status | compacting  |
+=================================================================================================================
+          14 |       38000 | ready    |           1 |        3 | master    |        0 | NULL      |           0 |
+          15 |       38000 | ready    |           1 |        3 | master    |        0 | NULL      |           0 |
+          16 |       38000 | ready    |           1 |        3 | master    |        0 | NULL      |           0 |
+          17 |       38000 | ready    |           1 |        3 | master    |        0 | NULL      |           0 |
+          18 |       37001 | ready    |           2 |        1 | slave     |        3 | master    |           0 |
+          19 |       37000 | ready    |           1 |        1 | master    |        0 | NULL      |           0 |
+          20 |       37000 | ready    |           1 |        1 | master    |        0 | NULL      |           0 |
+          21 |       37000 | ready    |           1 |        1 | master    |        0 | NULL      |           0 |
+Query OK, 8 row(s) in set (0.001242s)
 ```
 
-它将列出集群中所有的 dnode，每个 dnode 的 ID，end_point（fqdn:port），状态（ready，offline 等），vnode 数目，还未使用的 vnode 数目等信息。在添加或删除一个数据节点后，可以使用该命令查看。
+从上面的输出可以看到 vgId 为 18 的 vnode 被从 dnode 3 迁移到了 dnode 1。
 
-## 查看虚拟节点组
+:::warning
 
-为充分利用多核技术，并提供 scalability，数据需要分片处理。因此 TDengine 会将一个 DB 的数据切分成多份，存放在多个 vnode 里。这些 vnode 可能分布在多个数据节点 dnode 里，这样就实现了水平扩展。一个 vnode 仅仅属于一个 DB，但一个 DB 可以有多个 vnode。vnode 所在的数据节点是 mnode 根据当前系统资源的情况，自动进行分配的，无需任何人工干预。
+只有在集群的自动负载均衡选项关闭时（balance 设置为 0），才允许手动迁移。
+只有处于正常工作状态的 vnode 才能被迁移：master/slave；当处于 offline/unsynced/syncing 状态时，是不能迁移的。
+迁移前，务必核实目标 dnode 的资源足够：CPU、内存、硬盘。
 
-启动 CLI 程序 taos，然后执行：
+:::
 
-```sql
-USE SOME_DATABASE;
-SHOW VGROUPS;
-```