升级指南 | OceanBase 文档中心

升级指南

更新时间：2026-04-13 16:30:38

适用版本

OAT V3.2.0 及更高版本升级至 V4.3.0。

注意事项

OAT V3.2.0 以下的版本不支持升级，仅支持接管。
仅新安装高版本 OAT 并接管旧版本管理的产品、组件的方式进行间接升级。
OAT V3.2.0 及以上版本可以直接原地升级。
若存在正在执行或执行失败但未放弃的任务，请勿进行升级操作。

操作步骤

OAT 升级前版本为 V3.2.0 至 V4.1.0

因为 OAT V3.2/4.0 中的 MariaDB 版本小于 OAT V4.1/4.2 中的 MariaDB 版本，且 OAT V4.1 之前的容器未对 sigterm 信号做捕捉，需要先手动 kill 旧版 OAT 容器内的 mysqld 进程，再停止旧 OAT 容器进行升级，否则可能会遇到报错。

以 OAT V3.2.0 为例，请按照以下步骤进行升级操作：

加载新版本镜像。
```
docker load -i oat_xxx_xxxxxxxx_xxx.tgz 
```
其中 oat_xxx_xxxxxxxx_xxx.tgz 为新版本安装包的名称。

示例如下：
```
docker load -i oat_4.3.0_20241025_arm.tgz
```
返回结果如下：
```
Loaded image: xxx/oceanbase/oat:4.3.0_20241025_arm
```
在步骤 5 启动 OAT 容器时，会用到这个镜像。

关闭容器内的 MariaDB。

查看容器信息。

docker ps -a

示例如下：

docker ps -a

返回结果如下：

CONTAINER ID        IMAGE                                                         COMMAND                  CREATED             STATUS              PORTS               NAMES
56204b8e2f55        xxx/oceanbase/oat:3.2.0_20220819_arm   "/oat/distribution/p…"   About an hour ago   Up About an hour                        oat

进入 oat 容器。

docker exec -it <容器名> bash

示例如下：

docker exec -it oat bash

返回结果如下：

[root@xxx oat]#

终止运行中的 MariaDB 服务进程 (根据不同的 MariaDB 版本，实际的进程名可能为 mariadbd 或 mysqld)。
```
pkill mariadbd;
```
```
pkill mysqld;
```
检查 MariaDB 服务是否正在运行，确保没有运行中的 MariaDB 进程。
```
pgrep 'mariadbd|mysqld'
```
无回显，说明没有运行中的 MariaDB 进程。
返回宿主机。

输入 exit 后回车，或者按快捷键 Ctrl + D 返回宿主机。

示例如下：
```
[root@xxx oat]# exit
```

查看 OAT V3.2 容器启动时指定的宿主机上的数据挂载目录。
```
docker inspect <容器名> -f '{{.Mounts}}'
```
示例如下：
```
docker inspect oat -f '{{.Mounts}}'
```
返回以下结果：
```
[{bind  /data_dir /data   true rprivate}]
```
宿主机上的 /data_dir 对应容器内的 /data 目录。在步骤 5 启动 OAT V4.3.0 时，/data_dir 务必保持一致。

停止并删除 OAT V3.2 容器。

docker stop <容器名> && docker rm <容器名>

示例如下：

docker stop oat && docker rm oat

返回以下结果：

oat
oat

使用数据挂载目录启动 OAT 目标版本容器。

docker run -d --name oat --net host -v <data_dir>:/data --restart on-failure:5 <新版本镜像>

其中 <data_dir> 为 OAT 数据挂载目录。

示例如下：

使用数据挂载目录启动 OAT V4.3.0 容器。

docker run -d --name oat --net host -v /data_dir:/data --restart on-failure:5 xxx/oceanbase/oat:4.3.0_20241025_arm

返回结果如下：

12c9d898449e542718934f74a401724f6c5359206738956c7350168759a7338a

查看启动日志。
```
docker logs -f oat
```
启动日志停止刷新后，登录 OAT 验证升级是否成功。

OAT 升级前版本为 V4.1.1 及更高版本

直接原地升级即可，以 OAT V4.1.1 为例，请按照以下步骤进行升级操作：

加载新版本镜像。
```
docker load -i oat_xxx_xxxxxxxx_xxx.tgz 
```
其中 oat_xxx_xxxxxxxx_xxx.tgz 为新版本安装包的名称。

示例如下：
```
docker load -i oat_4.3.0_20241025_arm.tgz
```
返回结果如下：
```
Loaded image: xxx/oceanbase/oat:4.3.0_20241025_arm
```
在步骤 5 启动 OAT 容器时，会用到这个镜像。

查看容器信息。

docker ps -a

示例如下：

docker ps -a

返回结果如下：

CONTAINER ID        IMAGE                                                         COMMAND                  CREATED             STATUS              PORTS               NAMES
09534958453a        xxx/oceanbase/oat:4.1.1_20230519_arm   "/oat/distribution/p…"   3 minutes ago       Up 3 minutes                            oat

查看 OAT V4.1.1 容器启动时指定的宿主机上的数据挂载目录。
```
docker inspect <容器名> -f '{{.Mounts}}'
```
示例如下：
```
docker inspect oat -f '{{.Mounts}}'
```
返回以下结果：
```
[{bind  /data_dir /data   true rprivate}]
```
宿主机上的 /data_dir 对应容器内的 /data 目录。在步骤 5 启动 OAT 新版本时，/data_dir 务必保持一致。

停止并删除 OAT V4.1.1 容器。

docker stop <容器名> && docker rm <容器名>

示例如下：

docker stop oat && docker rm oat

返回以下结果：

oat
oat

使用数据挂载目录启动 OAT 目标版本容器。

docker run -d --name oat --net host -v <data_dir>:/data --restart on-failure:5 <新版本镜像>

其中 <data_dir> 为 OAT 数据挂载目录。

示例如下：

使用数据挂载目录启动 OAT V4.3.0 容器。

docker run -d --name oat --net host -v /data_dir:/data --restart on-failure:5 xxx/oceanbase/oat:4.3.0_20241025_arm

返回结果如下：

12d0bb1685f066a83742e754c4f01a83063b6a5b14d3d5d401cb3a278cd20d3b

查看启动日志。
```
docker logs -f oat
```
启动日志停止刷新后，登录 OAT 验证升级是否成功。