#单节点部署离线升级
除特殊说明,以下步骤均在yasadm工具所在的环境上操作,命令中的路径、用户、密码、端口等需更换为实际值。
本文以从23.2.6.100升级到23.2.7.100为例。
# SSH升级方式(推荐)
# 步骤一:上传新版本安装包
- 在部署管理平台的服务器上,创建一个空目录,该目录将作为升级安装包的临时存放路径。
$ mkdir ~/upgrade
将新版安装包上传至该目录中。
执行如下命令,解压安装包。
$ cd ~/upgrade
$ tar -zxf yashandb-cloud-manager-23.2.7.100-linux-x86_64.tar.gz
# 步骤二:生成配置文件
本步骤须在升级安装包的临时存放目录中执行。
- 执行如下命令,进入升级安装包的临时存放目录:
$ cd ~/upgrade/ycm
- 执行如下命令,生成主机信息的配置文件。
# 在当前目录下,生成ycm_host.toml
$ sudo ./scripts/yasadm host gen -u yasmanager -p password -i /data/install --port 22
简单参数介绍:
-u, --username 平台服务器的SSH用户
-p, --password 平台服务器用户的SSH密码
-i, --install-dir 平台的安装路径
--port 平台服务器的SSH端口
- 根据实际需求修改配置文件信息。
$ vim ycm_host.toml
...
[[hosts]]
host_id = "host-5e99117d"
manage_ip = "192.168.1.2"
agent_user = "yasmanager"
port = 22
ssh_user = "yasmanager"
ssh_pwd = "123456"
...
[[hosts]]
...
# 步骤三:执行离线升级
Caution:
升级失败后不支持再次升级,只能回退。
本步骤须在升级安装包的临时存放目录中执行。
- 执行如下命令,进入升级安装包的临时存放目录:
$ cd ~/upgrade/ycm
- 执行升级命令。
# 通过ssh方式升级
# 后端数据库为SQLite
$ sudo ./scripts/yasadm upgrade -i /data/install -t ycm_host.toml
# 后端数据库为YashanDB
$ sudo ./scripts/yasadm upgrade -i /data/install -t ycm_host.toml --imp-exp-install-dir /home/yasmanager/yashandb-client
简单参数介绍:
-i, --install-dir 管理平台的安装路径
-t, --toml 被托管服务器信息的配置文件
--imp-exp-install-dir 安装有imp和exp的yashandb客户端路径,用于备份平台后端yashandb的数据,默认为{平台安装路径}/ycm/tool/yashandb-client
# 步骤四:查看升级后版本
打开浏览器访问并登录管理平台,单击右上角用户头像,单击【关于】,查看升级后的版本。
# rpc升级方式
# 步骤一:上传新版本安装包
- 在部署管理平台的服务器上,创建一个空目录,该目录将作为升级安装包的临时存放路径。
$ mkdir ~/upgrade
将新版安装包上传至该目录中。
执行如下命令,解压安装包。
$ cd ~/upgrade
$ tar -zxf yashandb-cloud-manager-23.2.7.100-linux-x86_64.tar.gz
# 步骤二:生成配置文件
本步骤须在升级安装包的临时存放目录中执行。
- 执行如下命令,进入升级安装包的临时存放目录:
$ cd ~/upgrade/ycm
- 执行如下命令,生成被托管服务器的配置文件。
# 在当前目录下,生成ycm_host.toml
$ sudo ./scripts/yasadm host gen -i /data/install --rpc-port 9072
简单参数介绍:
-i, --install-dir 管理平台的安装路径
--rpc-port 管理平台服务器的升级RPC端口,用于RPC升级方式,默认为9072
- 根据实际需求修改配置文件信息。
$ vim ycm_host.toml
...
[[hosts]]
host_id = "host-5e99117d"
...
upgrade_rpc_port = 9072
[[hosts]]
...
# 步骤三:执行离线升级
Caution:
升级失败后不支持再次升级,只能回退。
本步骤须在升级安装包的临时存放目录中执行。
- 执行如下命令,进入升级安装包的临时存放目录:
$ cd ~/upgrade/ycm
- 执行升级命令。
# 通过rpc方式升级
# 后端数据库为 SQLite
$ sudo ./scripts/yasadm upgrade -i /data/install -t ycm_host.toml --rpc
# 后端数据库为YashanDB
$ sudo ./scripts/yasadm upgrade -i /data/install -t ycm_host.toml --imp-exp-install-dir /home/yasmanager/yashandb-client --rpc
简单参数介绍:
-i, --install-dir 管理平台的安装路径
-t, --toml 被托管服务器信息的配置文件
--rpc 通过rpc方式进行升级,默认为ssh方式
--imp-exp-install-dir 安装有imp和exp的yashandb客户端路径,用于备份平台后端yashandb的数据,默认为{平台安装路径}/ycm/tool/yashandb-client
# 步骤四:查看升级后版本
打开浏览器访问并登录管理平台,单击右上角用户头像,单击【关于】,查看升级后的版本。
# 升级回退
Note:
升级成功后不支持回退,只有升级失败才允许回退。
管理平台升级过程中可能因为命令错误、配置文件错误及版本错误等原因导致升级失败,此时请运行升级回退恢复升级前环境。
- 执行如下命令,进入升级安装包的临时存放目录:
$ cd ~/upgrade/ycm
- 执行升级回退命令。
# 后端数据库为SQLite
$ sudo ./scripts/yasadm rollback -i /data/install -t ycm_host.toml
# 后端数据库为YashanDB
$ sudo ./scripts/yasadm rollback -i /data/install -t ycm_host.toml --imp-exp-install-dir /home/yasmanager/yashandb-client
简单参数介绍:
-i, --install-dir 管理平台的安装路径
-t, --toml 被托管服务器信息的SSH配置文件
--imp-exp-install-dir 安装有imp和exp的yashandb客户端路径,用于恢复平台后端yashandb数据,默认为{平台安装路径}/ycm/tool/yashandb-client
Note:
- 允许升级回退失败后再次回退。
- 若多次回退均失败,请联系管理平台技术支持解决。