--- title: "升级指南 | OceanBase 文档中心" description: 升级指南 适用版本 OAT V3.2.0 及更高版本升级至 V4.3.1。 注意事项 OAT V3.2.0 以下的版本不支持升级，仅支持接管。 仅新安装高版本 OAT 并接管旧版本管理的产品、组件的方式进行间接升级。 OAT V3.2.0 及以上版本可以直接原地升级。 若存在正在执行或执行失败但未放弃的任务，请勿进行… image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*jLd4SamEcM0AAAAAAAAAAAAADiGDAQ/original) 管理者工具 OATV 4.3.1 企业版 # 升级指南 更新时间：2026-04-13 16:30:39 ## 适用版本 OAT V3.2.0 及更高版本升级至 V4.3.1。 ## 注意事项 - 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 为例，请按照以下步骤进行升级操作： 1. 加载新版本镜像。 ```shell docker load -i oat_xxx_xxxxxxxx_xxx.tgz ``` 其中 `oat_xxx_xxxxxxxx_xxx.tgz` 为新版本安装包的名称。 **示例如下：** ```shell docker load -i oat_4.3.1_20250303_arm.tgz ``` 返回结果如下： ```shell Loaded image: xxx/oceanbase/oat:4.3.1_20250303_arm ``` 在步骤 5 启动 OAT 容器时，会用到这个镜像。 2. 关闭容器内的 MariaDB。 1. 查看容器信息。 ```shell docker ps -a ``` **示例如下：** ``` 返回结果如下： ```shell 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 ``` 2. 进入 oat 容器。 ```shell docker exec -it <容器名> bash ``` **示例如下：** ```shell docker exec -it oat bash ``` 返回结果如下： ```shell [root@xxx oat]# ``` 3. 终止运行中的 MariaDB 服务进程 (根据不同的 MariaDB 版本，实际的进程名可能为 mariadbd 或 mysqld)。 ```shell pkill mariadbd; ``` ```shell pkill mysqld; ``` 4. 检查 MariaDB 服务是否正在运行，确保没有运行中的 MariaDB 进程。 ```shell pgrep 'mariadbd|mysqld' ``` 无回显，说明没有运行中的 MariaDB 进程。 5. 返回宿主机。 输入 `exit` 后回车，或者按快捷键 Ctrl + D 返回宿主机。 **示例如下：** ```shell [root@xxx oat]# exit ``` 3. 查看 OAT V3.2 容器启动时指定的宿主机上的数据挂载目录。 ```shell docker inspect <容器名> -f '{{.Mounts}}' ``` **示例如下：** ```shell docker inspect oat -f '{{.Mounts}}' ``` 返回以下结果： ```shell [{bind /data_dir /data true rprivate}] ``` 宿主机上的 `/data_dir` 对应容器内的 `/data` 目录。在步骤 5 启动 OAT V4.3.1 时，`/data_dir` 务必保持一致。 4. 停止并删除 OAT V3.2 容器。 ```shell docker stop <容器名> && docker rm <容器名> ``` **示例如下：** ```shell docker stop oat && docker rm oat ``` 返回以下结果： ```shell oat oat ``` 5. 使用数据挂载目录启动 OAT 目标版本容器。 ```shell docker run -d --name oat --net host -v :/data --restart on-failure:5 <新版本镜像> ``` 其中 `` 为 OAT 数据挂载目录。 **示例如下：** 使用数据挂载目录启动 OAT V4.3.1 容器。 ```shell docker run -d --name oat --net host -v /data_dir:/data --restart on-failure:5 xxx/oceanbase/oat:4.3.1_20250303_arm ``` 返回结果如下： ```shell 12c9d898449e542718934f74a401724f6c5359206738956c7350168759a7338a ``` 6. 查看启动日志。 ```shell docker logs -f oat ``` 启动日志停止刷新后，登录 OAT 验证升级是否成功。 ### OAT 升级前版本为 V4.1.1 及更高版本 直接原地升级即可，以 OAT V4.1.1 为例，请按照以下步骤进行升级操作： ``` **示例如下：** ``` 返回结果如下： ``` 在步骤 5 启动 OAT 容器时，会用到这个镜像。 2. 查看容器信息。 ``` **示例如下：** ``` 返回结果如下： ```shell 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 ``` 3. 查看 OAT V4.1.1 容器启动时指定的宿主机上的数据挂载目录。 ``` **示例如下：** ``` 返回以下结果： ``` 宿主机上的 `/data_dir` 对应容器内的 `/data` 目录。在步骤 5 启动 OAT 新版本时，`/data_dir` 务必保持一致。 4. 停止并删除 OAT V4.1.1 容器。 ``` **示例如下：** ``` 返回以下结果： ``` **示例如下：** ``` 返回结果如下： ```shell 12d0bb1685f066a83742e754c4f01a83063b6a5b14d3d5d401cb3a278cd20d3b ``` 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线