Ultra_Sync版本升级

下述版本升级步骤仅作参考，具体升级步骤需要根据现场实际需求进行方案设计。

主中心版本升级

步骤一：上传 tar 包，配置升级文件

• 将 tar 包上传到 AntDB 数据库所在的主机上，解压缩。（以 X86 为例）

tar -zxvf antdb-t-ce-release-*.generic.x86_64.tar.gz

• 找到安装包中的升级配置文件模版，修改升级配置：

cd antdb-t-ce-release-*.generic.x86_64/setup/common
vim upgrade_conf-c.ini

其中，upgrade_type = all，表示升级所有节点。

例如：

## upgrade_info 配置项说明：
## upgrade_type 分类：
##     primary 表示只更新主节点，即当前机器节点
##     all     表示更新所有节点
[upgrade_info]
upgrade_type = all
## primary_info 配置项说明:
## 
## antdb_apppath：主节点数据库程序目录
[primary_info]
antdb_apppath = /home/antdb/app
## standbyinfo 配置项说明:
##
## standby_node 格式：user,standby_ip,standby_sshport,antdb_apppath
##     user：备节点上安装了AntDB的操作系统用户
##     standby_ip：备节点 IP 地址
##     standby_sshport：备节点 SSH 服务端口号
##     antdb_apppath：备节点存放数据库应用程序的目录
[standby_info]
standby_node = antdb,10.20.16.228,22,/home/antdb/app
standby_node = antdb,10.20.16.214,22022,/home/antdb/app

步骤二：停止数据库

• 集群进入维护模式：

adbhamgrctl -c /etc/adbhamgr/adbhamgr_antdbcluster.yaml pause

• 停止每一个节点

adb_ctl stop -D /home/antdb/data

这里确保每个节点 stop 成功。

[antdb@host227 ~]$ adbhamgrctl -c /etc/adbhamgr/adbhamgr_antdbcluster.yaml  list

+ Cluster: antdbcluster (7236559176694986096) ----+----+-----------+
  | Member | Host               | Role    | State   | TL | Lag in MB |
  +--------+--------------------+---------+---------+----+-----------+
  | node1  | 10.20.16.227:40065 | Replica | stopped |    |   unknown |
  | node2  | 10.20.16.228:40065 | Replica | stopped |    |   unknown |
  | node3  | 10.20.16.214:40065 | Replica | stopped |    |   unknown |
  +--------+--------------------+---------+---------+----+-----------+

• 停止 adbdcs 和 adbhamgr；

sudo systemctl stop adbhamgr
sudo systemctl stop adbdcs

步骤三：备份数据

• 备份旧版本二进制文件：

cp -r /home/antdb/app  /home/antdb/app.bak

• 备份主备所有节点的数据目录（可选）：

cp -r /home/antdb/data /home/antdb/data.bak

步骤四：开始交互式升级

使用如下命令，开始交互式升级，-c 指定第一步修改的升级配置文件：

sh antdb_upgrade.sh -c setup/common/upgrade_conf-c.ini

注：也可以指定 -b 参数，备份二进制文件，这里手动备份过，可以不指定此参数。

-b参数会将升级前AntDB二进制文件进行备份，并以时间日期结尾，例如：~/app/antdb-20230331-6264

步骤五：启动数据库：

• 启动 adbdcs 和 adbhamgr，此时 adbhamgr 还处于维护模式。

先启动所有节点的 adbdcs，在启动所有节点的 adbhamgr。

sudo systemctl start adbdcs
sudo systemctl start adbhamgr

• 手动启动每一个节点：

adb_ctl start -D /home/antdb/data

• 恢复 adbhamgr 管理功能：

adbhamgrctl -c /etc/adbhamgr/adbhamgr_antdbcluster.yaml resume

• 查看集群状态是否正确；

adbhamgrctl -c /etc/adbhamgr/adbhamgr_antdbcluster.yaml  list

升级完成后，登录到数据库上，检查版本号是否正确：

SELECT adb_version();

备中心版本升级

备中心的版本升级与主中心类似，且不需要启停 adbhamgr 和 adbdcs。

步骤如下，具体每一个步骤的详细操作请参考【主中心版本升级】章节：

步骤一：上传 tar 包，配置升级文件；

步骤二：停止数据库；

在每一个节点上执行如下命令：

adb_ctl stop -D /home/antdb/data

步骤三：备份数据（可选）；

步骤四：开始交互式升级；

步骤五：启动数据库；

adb_ctl start -D /home/antdb/data