YashanDB 知识库|YCP 高可用离线升级指南(以 23.2.4.100 升级至 23.2.11.100 为例)

一、升级前准备

环境要求

已部署 YCP 高可用(含主节点 + 多个备节点);

保证所有节点磁盘、权限、目录结构正常;

确保当前为 23.2.4.100 版本，目标为 23.2.11.100。

升级前备份（强烈建议）

在所有节点依次执行 backup.sh 脚本，进行完整备份。

/opt/ycm/ycm/scripts/backup.sh -n ycm \
-i /opt/ycm/ycm \
-c yashandb \
-y /data1/dugg/yasdb_home/yashandb/23.2.2.100 \
--cata-log /data1/dugg/yasdb_home/yashandb/23.2.2.100/catalog \
--addr 192.168.3.102:3675 \
-k <授权码> -u sys -p <密码>

每个节点执行一次，注意替换 --addr 为 YCP 实际管理地址。

二、主节点升级操作

1. 解压安装包

tar -zxvf yashandb-cloud-platform-23.2.11.100-linux-x86_64.tar.gz

2. 生成托管配置文件（主节点）

sudo ./scripts/yasadm host gen -i /opt/ycm --rpc-port 9072

执行完毕后，会生成 ycm_host.toml 配置文件。

3. 执行升级命令

sudo ./scripts/yasadm upgrade \
-i /opt/ycm \
-t ycm_host.toml \
--imp-exp-install-dir /data1/dugg/yasdb_home/yashandb/23.2.2.100 \
--rpc \
--role primary \
--plugin-package <aarch64.tar.gz>  # 如有异构架构部署必填

升级过程中将：

自动停用 ycm/ycm-agent;

完成备份、替换文件、执行升级 SQL;

启动新版服务并验证状态;

输出 upgrade success 提示。

三、备节点升级操作

每个备节点需单独执行如下命令(无 RPC 模式)：

sudo ./scripts/yasadm upgrade \
-i /opt/ycm \
--lib-dir /data1/dugg/yasdb_home/yashandb/23.2.2.100/lib \
--role standby

确认提示 upgrade success 即完成升级。

四、验证升级版本

升级完成后可通过以下方式查看版本：

cat /opt/ycm/ycm/etc/upgrade/version.toml

如返回：

version = "23.2.11.100"
说明当前平台版本已升级成功。

五、其他说明

六、升级成功后建议操作

确认各节点服务状态正常;

检查配置文件是否有残留或异常;

建议手动清理旧版本备份包(如空间不足);

记录版本升级信息、时间、操作人。