YashanDB 知识库|YCP 单机部署如何离线升级?一文详解 -rpc 升级流程

当 Yashan Control Platform(YCP)运行在单机环境中，也可以使用 -rpc 模式实现离线升级，过程稳定、可控，适合标准场景快速演进。

一、前提准备

端口要求

每台被纳管主机需开放 9072 端口，用于远程调用升级服务。

二、升级前备份

在升级前务必执行 YCP 组件完整备份：

cd /opt/ycm/ycm/scripts
sudo ./backup.sh -n ycm -i /opt/ycm/ycm \
-c yashandb \
-y /home/yashan/yasdb_home/yashandb/22.2.11.105 \
--cata-log /home/yashan/ycm_upgrade/catalog \
--addr 192.168.1.43:1675 \
-k 授权码 \
-u sys -p 密码

执行后将自动：

备份 YashanDB 数据;

归档关键配置文件(证书、Prometheus、Loki、YCM 设置等);

输出 .tar.gz 归档包至 /opt/ycm/ycm/bak 目录。

三、解压安装包

tar -zxvf yashandb-cloud-platform-23.2.1.104-linux-aarch64.tar.gz

四、生成升级配置文件

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

该命令将生成 ycm_host.toml 文件，其中定义了主机信息、端口等，供后续升级任务识别。

五、执行升级命令（-rpc 模式）

./scripts/yasadm upgrade -i /opt/ycm \
-t ycm_host.toml \
--imp-exp-install-dir /home/yashan/yasdb_home/yashandb/22.2.11.105 \
--rpc \
--plugin-package /path/to/yashandb-cloud-platform-*.tar.gz

升级过程自动完成：

Agent 远程部署;

服务停止与备份;

安装升级包;

启动验证;

状态更新。

若一切正常，将返回 upgrade success。

六、回滚操作（如升级失败）

./scripts/yasadm rollback -i /opt/ycm \
-t ycm_host.toml \
--imp-exp-install-dir /home/yashan/yasdb_home/yashandb/22.2.11.105

此命令将恢复：

所有服务原路径文件;

原版本配置;

监控系统状态。

提示 rollback success 表示恢复成功。

七、建议检查项

八、常见问题建议