YashanDB离线升级

YashanDB支持通过yasboot工具离线升级已部署的数据库，将数据库二进制文件升级到新版本。

Note:

本文中所有路径、版本号、用户、密码与回显信息等仅为示例，请以实际为准。

注意事项

---

• 离线升级要求当前数据库无新业务数据产生，请通过应用手段停止用户业务。
• 请完成升级前准备要求的各项工作后再进行升级。
• 升级过程需使用YashanDB内置的yasboot工具，该工具的命令选项含义及说明请查阅yasboot。
• 若升级未成功，请执行离线升级回退。如果回退仍不成功，请联系YashanDB技术支持解决。
• 升级成功后，需根据运行日志告警判断是否使用过时参数，告警内容请查阅参数配置中参数初始化章节示例。若使用了过时参数，需根据配置参数中对应参数的介绍判断该参数是否因改名而过时，并且是否需要将该过时参数调整为对应的新参数。若新参数未配置，则过时参数的配置值将自动转换为新参数值。
• 从23.2.0.0版本开始，yasom仲裁选主功能需依赖于已开启操作系统认证。若23.2.0.0以下版本中已开启yasom仲裁选主（升级前准备中会临时关闭该功能），升级至23.2.0.0或以上版本后仍需开启，需先检查并开启操作系统认证，才能保证仲裁选主功能正常使用。
• 升级成功后，请先确认数据库运行正常再开放用户业务。

操作步骤

---

步骤1：执行全量备份

YashanDB提供两种备份的方式，分别是通过SQL语句和使用yasrman工具，如需了解更多有关备份的语法及说明请查阅​​备份恢复​​。

• SQL语句方式：
  SQL语句执行备份需登录数据库实例进行操作，可通过执行如下语句执行全量备份：

BACKUP DATABASE FULL FORMAT '/home/yashan/full_20221123' TAG 'full' PARALLELISM 3;

• yasrman工具方式：
  使用yasrman工具进行全量备份须确保在yasrman工具所在服务器上操作，可通过执行如下命令执行全量备份：

$ yasrman sys/password@IP:port -c "backup cluster tag 'full_1' format 'full_bak_1'" -D /home/yashan/cat