#DN组扩缩容

YashanDB支持通过yasboot工具对分布式部署中的DN组进行扩/缩容，如需为已有DN组内进行备库扩/缩容请查阅备库扩缩容。

建议在对DN组扩/缩容操作前先备份数据库，以防操作失败时无新的备份集用于恢复。

# 注意事项

扩/缩容不能与降备（Switchover）操作并发。

扩容期间数据库集群无法正常使用，请合理安排操作时间。扩/缩容期间会阻塞DDL以及拦截下列yasboot命令：

$ yasboot cluster restart
$ yasboot group restart
$ yasboot node restart
$ yasboot group add/remove
$ yasboot node add/remove
$ yasboot dataspace redistribute

在扩/缩容过程中请不要通过yasboot对当前数据库集群中的所有节点进行强制重启/停止，否则可能会造成扩/缩容失败后无法执行node remove --clean命令。如不可避免，可以尝试通过对扩容失败/缩容失败的DN组进行强制操作（例如yasboot node stop -f）后，再通过node remove --node-ids的方式删除失败的DN组。
如果待缩容DN组的备库异常且无法恢复，直接缩容可能会失败，可以通过组内删除节点功能删除该备库后再进行缩容。
如果出现扩/缩容失败，只能通过执行yasboot group remove --clean命令清理环境，无法通过yasboot对扩/缩容失败的DN组节点进行start/stop/restart操作。
需确保所有OUTLINE的依赖表均存在。可通过查询DBA_OUTLINES视图确认所有OUTLINE对应的SQL语句，然后进一步确认语句中涉及的表是否存在。若某个OUTLINE的依赖表不存在则需先删除该OUTLINE再执行扩容操作，否则会报错。
在扩/缩容DN组过程中，若MN组、CN组全部节点或不涉及扩/缩容的其他DN组出现异常，会导致扩/缩容任务挂起，此时需要先手动恢复相应组的正常运行再继续扩/缩容DN组的相关操作。

# 新增分布式DN组

以安装用户登录当前数据库集群中yasboot工具所在服务器。
结合实际场景执行相应命令，生成配置文件。
- 场景1：向集群新增服务器并增加DN组
```
$ yasboot config group gen -c yashandb -u yashan -p password --ip ip1,ip2...ipn --port 22  --install-path /data/yashan/yasdb_home --node 3 --group 2
```
  执行成功后，会生成hosts_add.toml和yashandb_add.toml两个配置文件。
- 场景2：在集群中现有服务器上增加DN组
```
$ yasboot config group gen -c yashandb --host-id host0001 --node 3 --group 2
```
  执行成功后，会生成yashandb_add.toml配置文件。
配置文件的详细示例请查阅yashandb_add.toml以及hosts_add.toml。

部署新服务器。

如果是在数据库集群中现有服务器上增加DN组，则跳过本步骤。

) 请先参照安装前准备检查并确保新服务器系统的各项环境已满足要求。

) 执行相应命令，部署新服务器。

$ yasboot host add -c yashandb -t hosts_add.toml

type | uuid             | name    | hostid | index    | status  | return_code | progress | cost 
-------------------------------------------------------------------------------------------------
task | b5328fe3dbf4a2be | HostAdd | -      | yashandb | SUCCESS | 0           | 100      | 9    
------+------------------+---------+--------+----------+---------+-------------+----------+------
task completed, status: SUCCESS

) （可选）若现有环境已开启monit，新服务器需开启monit功能，可参考守护进程完成相关配置。

执行如下命令，增加DN组。

$ yasboot group add -c yashandb -t yashandb_add.toml -p password
type | uuid             | name    | hostid | index    | status  | return_code | progress | cost 
-------------------------------------------------------------------------------------------------
task | 834a8c23c37ca1f4 | GroupAdd | -      | yashandb | SUCCESS | 0           | 100      | 3    
------+------------------+---------+--------+----------+---------+-------------+----------+------
task completed, status: SUCCESS

任务显示成功并不表示扩容任务已全部成功，可能仍有部分后台任务在完成数据的同步等操作。可以通过task list命令查看扩容相关的任务是否都成功。

（可选）若现有环境已开启资源管理功能，新增的服务器中需要创建cgroup目录，可参考yasboot相关命令。
```
$ yasboot host cgroup create -c yashan --sudo-username root --sudo-password ****** --host-id host005
```
（可选）备份数据库。

建议对数据库进行备份，确保扩容后有可用于恢复的基线备份集。

# 删除分布式DN组

以安装用户登录当前数据库集群中yasboot工具所在服务器。

执行如下命令，删除DN组。

$ yasboot group remove --group-ids 3,4 --purge --force -c yashandb
type | uuid             | name       | hostid | index    | status  | return_code | progress | cost 
----------------------------------------------------------------------------------------------------
task | 7c7d71db43810b33 | GroupRemove | -      | yashandb | SUCCESS | 0           | 100      | 5    
------+------------------+------------+--------+----------+---------+-------------+----------+------
task completed, status: SUCCESS

（可选）备份数据库。

建议对数据库进行备份，确保缩容后有可用于恢复的基线备份集。