YashanDB支持通过yasboot工具对共享集群部署中的实例节点（包括YCS实例和数据库实例）进行在线扩容或缩容，且扩缩容期间不影响整个集群的使用。

Note:

• 执行扩/缩容操作前，请仔细阅读扩缩容注意事项。

• 如果扩/缩容失败，请参考扩缩容异常处理进行处理。

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

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

2. 以安装用户登录数据库现有实例所在服务器，若为主备集群需登录主集群任一实例所在服务器。

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. 执行yasboot config node gen命令，生成增加实例的配置文件。

   $ yasboot config node gen -c yashandb \
   -u yashan -p 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 \
   --vips vip1,vip2        # 原集群未配置VIP时，不需要指定--vips选项
   

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

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

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

6. 按需在新服务器上完成以下配置。

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

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

   • 若扩容前其他服务器均已配置开机自启动，新服务器也必须配置开机自启动。

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

   • 若扩容前其他服务器均已配置开机自启动，新服务器也必须配置开机自启动。

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

   # 若扩容前数据库已开启密钥管理，则必须指定--wallet-password Your_keystore_password
   
   $ yasboot node add -c yashandb -t yashandb_add.toml
   

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

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

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

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

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

11. 若为顺利执行扩容而临时调整过某些配置（例如关闭yasom仲裁选主），在扩容完成后应按需还原配置（例如重新开启yasom仲裁选主）。