YashanDB支持通过yasboot工具滚动升级已经部署的数据库，在数据库不停机的情况下，将数据库二进制文件升级到新版本。

本文将以23.2.9.100版本升级到23.2.9.101版本为例介绍数据库的滚动升级方式。

注意事项

• 滚动升级适用范围：
  • 单机（主备）部署：主备形态部署的数据库从23.2.0.0及以上版本向版本号前三位相同但第四位不同的新版本进行升级。
  • 分布式部署：MN和DN均为主备部署的数据库从23.2.3.0及以上版本向23.2.3.100及以上且版本号前三位相同但第四位不同的版本进行升级。
• 请完成升级前准备要求的各项工作后再进行升级。
• 升级时会校验新旧数据库的dbcr目录是否相同，如果不相同则无法滚动升级。此时滚动升级不会执行，无需回退。
• 升级过程需使用YashanDB内置的yasboot工具，该工具的命令选项含义及说明请查阅yasboot。
• 若升级未成功，请执行滚动升级回退恢复环境。如果回退仍不成功，请联系YashanDB技术支持解决。
• 升级后，需根据运行日志告警判断是否使用过时参数，告警内容请查阅参数配置中参数初始化章节示例。若使用了过时参数，需根据配置参数中对应参数的介绍判断该参数是否因改名而过时，并且是否需要将该过时参数调整为对应的新参数。若新参数未配置，则过时参数的配置值将自动转换为新参数值。

操作步骤

除特殊说明，以下步骤均在yasboot工具所在的服务器（已存在hosts.toml文件）上操作，且命令中的路径、用户、密码等需更换为实际值。

步骤1：上传新版本安装包

1. 创建一个空目录，该目录将作为升级安装包的临时存放路径。

   $ mkdir ~/tmp_upgrade
   

2. 将新版安装包上传至该目录中。

3. 进入升级安装包的存放目录并解压安装包。

   $ cd ~/tmp_upgrade
   $ tar zxf yashandb-23.2.9.101-linux-x86_64.tar.gz
   

步骤2：升级yasom与yasagent

以下操作均在升级安装包的存放目录中执行。

1. 查看当前yasom与yasagent版本。

   $ ps -ef | grep -E "yasom|yasagent" | grep -v grep
   yashan 102280      1  0 16:24 ?        00:00:00 /data/yashan/yasdb_home/yashandb/23.2.9.100/bin/yasagent --init -c yashandb -l 192.168.1.2:1676 --host-id host0001 -k                  -d
   yashan 102323      1  0 16:24 ?        00:00:00 /data/yashan/yasdb_home/yashandb/23.2.9.100/bin/yasom --init -c yashandb -l 192.168.1.2:1675 -k                  -d
   # 当前版本为23.2.9.100
   

2. 升级yasom与yasagent。

   $ ./bin/yasboot package upgrade -t /home/yashan/install/hosts.toml
   upgrade package...
   install version: yashandb 23.2.9.101
   host0001 100% [====================================================================]    3s
   upgrade host to yasom...
   

   参数介绍：

   -t, --toml  需要服务器配置文件hosts.toml，此处指部署旧版本时生成的hosts.toml文件
   

3. 检查yasom与yasagent升级后的版本。

   $ ps -ef | grep -E "yasom|yasagent" | grep -v grep
   yashan 103607      1  0 16:32 ?        00:00:00 /data/yashan/yasdb_home/yashandb/23.2.9.101/bin/yasagent -c yashandb -d
   yashan 103650      1  0 16:32 ?        00:00:00 /data/yashan/yasdb_home/yashandb/23.2.9.101/bin/yasom -c yashandb -d
   # 版本已升级为23.2.9.101
   

步骤3：升级数据库

以下操作均在升级安装包的存放目录中执行。

Caution:

数据库升级过程中出现任何错误，请执行滚动升级回退恢复环境，升级成功后无法回退。

1. 查看当前数据库版本。

   $ ./bin/yasboot sql -d sys/password@192.168.1.2:1688 -s 'select version from v$instance;'
   
   VERSION                                                          
   ---------------------------------------------------------------- 
   Release 23.2.9.100 x86_64    
   # 当前版本为23.2.9.100                                    
   

2. 升级数据库。

   $ ./bin/yasboot cluster upgrade --cluster yashandb --rolling
   type | uuid             | name                | hostid | index    | status  | return_code | progress | cost 
   -------------------------------------------------------------------------------------------------------------
   task | 9d0041edd55f7d4f | UpgradeYasdbCluster | -      | yashandb | SUCCESS | 0           | 100      | 23   
   ------+------------------+---------------------+--------+----------+---------+-------------+----------+------
   task completed, status: SUCCESS
   

   Note：

   使用--keep-primary参数可以确保滚动升级后集群的主库仍为升级前的主库。

3. 检查数据库升级后的版本。

   $ ./bin/yasboot sql -d sys/password@192.168.1.2:1688 -s 'select version from v$instance;'
   
   VERSION                                                          
   ---------------------------------------------------------------- 
   Release 23.2.9.101 x86_64   
   # 版本已升级为23.2.9.101                                     
   

步骤4（可选）：升级后操作

• 检查环境变量

  升级操作不会修改服务器的YASDB_HOME、YASDB_DATA、LD_LIBRARY_PATH以及PATH等环境变量。

  若手动修改过YASDB_HOME（例如取消软链接改为直接指向目标路径），升级后需再次手动更新为新版本数据库相应的环境变量，若不更新直接使用yasdb/yasql等命令会继续指向旧版本数据库。

• 开启或关闭某些配置

  若为顺利执行升级操作而临时调整过某些配置（例如关闭仲裁），在升级完成后应按需还原配置（例如重新开启仲裁）。