#单节点部署离线升级

除特殊说明,以下步骤均在yasadm工具所在的环境上操作,命令中的路径、用户、密码、端口等需更换为实际值。

本文以从23.2.6.100升级到23.2.7.100为例。

# SSH升级方式(推荐)

# 步骤一:上传新版本安装包

  1. 在部署管理平台的服务器上,创建一个空目录,该目录将作为升级安装包的临时存放路径。
$ mkdir ~/upgrade
  1. 将新版安装包上传至该目录中。

  2. 执行如下命令,解压安装包。

$ cd ~/upgrade
$ tar -zxf yashandb-cloud-manager-23.2.7.100-linux-x86_64.tar.gz

# 步骤二:生成配置文件

本步骤须在升级安装包的临时存放目录中执行。

  1. 执行如下命令,进入升级安装包的临时存放目录:
$ cd ~/upgrade/ycm
  1. 执行如下命令,生成主机信息的配置文件。
# 在当前目录下,生成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端口
  1. 根据实际需求修改配置文件信息。
$ 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

升级失败后不支持再次升级,只能回退

本步骤须在升级安装包的临时存放目录中执行。

  1. 执行如下命令,进入升级安装包的临时存放目录:
$ cd ~/upgrade/ycm
  1. 执行升级命令。
# 通过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升级方式

# 步骤一:上传新版本安装包

  1. 在部署管理平台的服务器上,创建一个空目录,该目录将作为升级安装包的临时存放路径。
$ mkdir ~/upgrade
  1. 将新版安装包上传至该目录中。

  2. 执行如下命令,解压安装包。

$ cd ~/upgrade
$ tar -zxf yashandb-cloud-manager-23.2.7.100-linux-x86_64.tar.gz

# 步骤二:生成配置文件

本步骤须在升级安装包的临时存放目录中执行。

  1. 执行如下命令,进入升级安装包的临时存放目录:
$ cd ~/upgrade/ycm
  1. 执行如下命令,生成被托管服务器的配置文件。
# 在当前目录下,生成ycm_host.toml
$ sudo ./scripts/yasadm host gen -i /data/install --rpc-port 9072

简单参数介绍:

-i, --install-dir 管理平台的安装路径
--rpc-port        管理平台服务器的升级RPC端口,用于RPC升级方式,默认为9072
  1. 根据实际需求修改配置文件信息。
$ vim ycm_host.toml
...
[[hosts]]
host_id = "host-5e99117d"
...
upgrade_rpc_port = 9072
[[hosts]]
...

# 步骤三:执行离线升级

Caution

升级失败后不支持再次升级,只能回退

本步骤须在升级安装包的临时存放目录中执行。

  1. 执行如下命令,进入升级安装包的临时存放目录:
$ cd ~/upgrade/ycm
  1. 执行升级命令。
# 通过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

升级成功后不支持回退,只有升级失败才允许回退。

管理平台升级过程中可能因为命令错误、配置文件错误及版本错误等原因导致升级失败,此时请运行升级回退恢复升级前环境。

  1. 执行如下命令,进入升级安装包的临时存放目录:
$ cd ~/upgrade/ycm
  1. 执行升级回退命令。
# 后端数据库为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

  • 允许升级回退失败后再次回退。
  • 若多次回退均失败,请联系管理平台技术支持解决。