YashanDB支持对备库进行在线扩展/删减，执行具体操作前请仔细阅读相关注意事项。

Note:

如果扩缩容过程中现有节点出现故障、扩缩容失败等异常，请参考扩缩容异常处理进行处理。

在线增加备库

每个备库将由单独的1台服务器承载（后文将称之为“新服务器”），新服务器的操作系统版本建议与现有服务器保持一致。

1. 准备扩容所需的新服务器，并参照安装前准备检查并确保新服务器系统的各项环境已满足要求。

2. 以安装用户登录数据库的现有节点所在服务器。

3. 执行yasboot config node gen命令，生成增加备库的配置文件。

   $ yasboot config node gen -c yashandb \
   -u yashan -p yashan_password --ip ip1,ip2 --port 22 \
   --install-path /data/yashan/yasdb_home \
   --data-path /data/yashan/yasdb_data \
   --log-path /data/yashan/log \
   --node 2
   

   执行成功后，会生成yashandb_add.toml和hosts_add.toml两个配置文件。

4. 执行如下命令，远程连接新服务器并为其安装YashanDB。

5. 在新服务器上安装YashanDB软件并完成其他要求各主备库配置一致的操作。

   1. ) 执行如下命令，安装YashanDB。

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

   2. ) 若扩容前数据库已开启资源管理功能，新服务器上也需执行yasboot host cgroup命令创建cgroup目录。

      $ yasboot host cgroup create -c yashandb --sudo-username root --sudo-password ****** --host-id host004
      

6. 在上述生成配置文件的服务器上执行如下命令，增加备库。

   $ yasboot node add -c yashandb -t yashandb_add.toml
   

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

   $ yasboot task list -c yashandb --search type=NodeAdd
   

7. （可选）备份数据库。

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

8. 将hosts_add.toml中的[[host]]内容复制粘贴到hosts.toml的末尾，以免升级时仍用旧的hosts信息。

9. 若扩容前其他服务器均已配置开机自启动，还需登录所有新服务器配置开机自启动。

10. 可按需开启自动选主功能，保障业务连续性：

    • 一主一备环境：可按需手动开启yasom仲裁选主。

    • 一主多备（非级联备）环境：yasboot会自动开启自动选主。

在线删除备库

1. 以安装用户登录数据库安装服务器。

2. 执行如下命令，查看待删除的目标备库ID。

   $ yasboot cluster status -c yashandb -d
   # nodeid中冒号前的部分即为节点ID，例如1-1:1对应的节点ID为1-1
   

3. 请先检查并关闭yasom仲裁选主：

   若为一主一备环境需要执行当前操作检查并关闭yasom仲裁选主，若为一主多备环境，不论是否开启自动选主均不影响通过yasboot执行的在线缩容。

   $ yasboot election config show -c yashandb
   group 1
   Protection Mode: MAXIMUM PROTECTION
   Members:
       [1-1:1] - Primary database
       [1-2:2] - Physical standby database
   
   ……
   
   Automatic Failover: Enabled in Zero Data Loss Mode 
   
   # Enabled表示已开启yasom仲裁选主，需将其关闭再进行后续操作
   $ yasboot election enable off -c yashandb
   

4. 执行如下命令，删除备库。

   • 场景1：删除正常备库

     # 单次缩容1个备库
     $ yasboot node remove -c yashandb -n 1-1 --purge
     +----------------------------------------------------------------------------------------------------+
     | type | uuid             | name       | hostid | index    | status  | return_code | progress | cost |
     +----------------------------------------------------------------------------------------------------+
     | task | 7c7d71db43810b33 | NodeRemove | -      | yashandb | SUCCESS | 0           | 100      | 5    |
     +------+------------------+------------+--------+----------+---------+-------------+----------+------+
     task completed, status: SUCCESS
     
     # 单次删除多个备库，ID间使用逗号隔开
     $ yasboot node remove -c yashandb --node-ids 1-1,1-2 --purge
     +----------------------------------------------------------------------------------------------------+
     | type | uuid             | name       | hostid | index    | status  | return_code | progress | cost |
     +----------------------------------------------------------------------------------------------------+
     | task | 7c7d71db43810b33 | NodeRemove | -      | yashandb | SUCCESS | 0           | 100      | 5    |
     +------+------------------+------------+--------+----------+---------+-------------+----------+------+
     +----------------------------------------------------------------------------------------------------+
     | task | 7c7d71db43810b34 | NodeRemove | -      | yashandb | SUCCESS | 0           | 100      | 5    |
     +------+------------------+------------+--------+----------+---------+-------------+----------+------+
     task completed, status: SUCCESS
     
     # 单次删除多个备库，ID间使用逗号隔开
     $ yasboot node remove -c yashandb --node-ids 1-1,1-2 --purge
     +----------------------------------------------------------------------------------------------------+
     | type | uuid             | name       | hostid | index    | status  | return_code | progress | cost |
     +----------------------------------------------------------------------------------------------------+
     | task | 7c7d71db43810b33 | NodeRemove | -      | yashandb | SUCCESS | 0           | 100      | 5    |
     +------+------------------+------------+--------+----------+---------+-------------+----------+------+
     +----------------------------------------------------------------------------------------------------+
     | task | 7c7d71db43810b34 | NodeRemove | -      | yashandb | SUCCESS | 0           | 100      | 5    |
     +------+------------------+------------+--------+----------+---------+-------------+----------+------+
     task completed, status: SUCCESS
     

     删除备库后，会将该备库停止。

   • 场景2：删除断连备库

     若待删除的备库所在服务器已无法连接，须指定--with-unconnected-host参数进行缩容。

     # 删除服务器使用强制删除方式，仅删除服务器在yasom的数据，yasagent进程和安装包都将保留
     
     $ yasboot node remove --node-ids 1-3 --purge --force -c yashandb --with-unconnected-host
     +----------------------------------------------------------------------------------------------------+
     | type | uuid             | name       | hostid | index    | status  | return_code | progress | cost |
     +----------------------------------------------------------------------------------------------------+
     | task | 7c7d71db43810b33 | NodeRemove | -      | yashandb | SUCCESS | 0           | 100      | 5    |
     +------+------------------+------------+--------+----------+---------+-------------+----------+------+
     task completed, status: SUCCESS
     

     删除备库后，不会停止该备库，如果该备库被monit监控，也不会关闭对该备库的进程监控。

     Note:

     在该场景中，缩容完成后需手动对移除的服务器进行环境清理：

     • 清理可能残留的路径，例如$YASDB_DATA路径、$YASDB_HOME路径、日志路径、本地表空间路径。

     • 清理可能残留的进程，例如yasdb，yascs。

     • 清理可能残留的脚本，例如开机自启动脚本。

     • 清理可能残留的YashanDB相关的环境变量。

5. （可选）备份数据库。

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

6. 若缩容时指定了--with-host参数（即移除了空服务器），缩容完成后需要更新hosts.toml文件的[[host]]内容，删除对应服务器相关信息，以免升级时仍用旧的hosts信息。

7. 删除备库后，可根据数据库高可用配置情况，可按需还原自动选主功能相关配置：

   • 一主一备环境：可以开启yasom仲裁选主。

   • 一主多备（非级联备）环境：可以开启自动选主。

8. （可选）若缩容时指定了--with-host参数（即移除了空服务器），缩容完成后可对移除的服务器进行环境清理：

   1. ）清理可能残留的路径，例如$YASDB_DATA路径、$YASDB_HOME路径、日志路径、本地表空间路径。

   2. ）清理可能残留的进程，例如yasdb。

   3. ）清理可能残留的脚本，例如开机自启动脚本。

   4. ）清理可能残留的YashanDB相关的环境变量。