---
title: "OMS 社区版热升级 | OceanBase 文档中心"
description: OMS 社区版热升级 本文为您介绍如何在不影响数据迁移、数据同步任务运行的情况下对 OceanBase 迁移服务（OceanBase Migration Service，OMS）社区版进行热升级。 使用限制 OMS 社区版的版本必须大于等于 V4.2.1。 热升级之前和热升级过程中，请确保 OMS 社区版中没有正在新…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*L03BS6f-o40AAAAAAAAAAAAADiGDAQ/original) 迁移服务 OMSV 4.2.13 社区版

# OMS 社区版热升级

更新时间：2026-05-07 14:17:15

[编辑](https://github.com/oceanbase/oms-doc/edit/V4.2.13/zh-CN/1300.upgrade-guide/309.hot-upgrade.md)  

本文为您介绍如何在不影响数据迁移、数据同步任务运行的情况下对 OceanBase 迁移服务（OceanBase Migration Service，OMS）社区版进行热升级。

## 使用限制

- OMS 社区版的版本必须大于等于 V4.2.1。
 - 热升级之前和热升级过程中，请确保 OMS 社区版中没有正在新建的任务。
 - 热升级成功之后，刷新浏览器或删除数据后，才能显示热升级后版本的功能。删除数据的操作请参见《常见问题》模块的内容。
 - 热升级成功之后，新建数据迁移或数据同步任务，才会有热升级后版本的功能。
 - 已经存在的任务在热升级之后保持原样，特别是热升级后版本新增的配置在已有的旧版本任务中不会存在。
 - 热升级成功之后进行正向切换时，选择增量启动位点无效。该功能为 OMS 社区版 V4.2.11-CE 新增功能，新建数据迁移任务才会支持。

## 操作步骤

1. 登录安装 OMS 社区版的宿主机。
 2. 执行下述命令，获取新镜像中的热升级脚本。

   #### 注意

   在获取热升级脚本前，请确保您已加载新镜像的 OMS_IMAGE。

   ```shell
   sudo docker run -d --net host --name oms-config-tool ${OMS_IMAGE} bash \
   && sudo docker cp oms-config-tool:/root/docker_dump_file_from_image.sh . \
   && sudo docker cp oms-config-tool:/root/docker_copy_dumpfile_to_container.sh . \
   && sudo docker cp oms-config-tool:/root/docker_copy_dumpfile_rollback.sh . \
   && sudo docker rm -f oms-config-tool

   ```
 3. 多节点升级场景下，如果您开启了 HA 功能，请先关闭 HA。详情请参见 [修改高可用功能的配置](https://www.oceanbase.com/docs/community-oms-cn-1000000005764041)。
 4. 备份 OMS 社区版的数据库元数据。

   ```shell
   mysqldump -hxxx.xxx.xxx.1 -P<port> -u<username> -p<password> --triggers=false rm_4211 > /home/admin/rm_4211.sql

   mysqldump -hxxx.xxx.xxx.1 -P<port> -u<username> -p<password> --triggers=false cm_4211 > /home/admin/cm_4211.sql

   mysqldump -hxxx.xxx.xxx.1 -P<port> -u<username> -p<password> --triggers=false cm_hb_4211 > /home/admin/cm_hb_4211.sql

   ```

   备份参数说明

   | 参数 | 描述 |
   | --- | --- |
   | -h | 需要导出的主机信息。 |
   | -P | 连接数据库的端口号。 |
   | -u | 指定连接的用户名。 |
   | -p | 连接数据库的密码。 |
   | --triggers | 导出触发器，默认为 false（不导出）。 |
   | rm_4211、cm_4211、cm_hb_4211 | 此处为备份 rm、cm 和 cm_hb 库为 SQL 文件，格式为 `库名 > 存储 SQL 文件的路径.sql`，请替换为实际环境中的值。 |
 5. 复制新镜像文件到宿主机目录。

   ```shell
   sh docker_dump_file_from_image.sh ${OMS_IMAGE}

   ```
 6. 进入 OMS 社区版容器，暂停管控服务。

   ```shell
   supervisorctl stop nginx oms_console oms_drc_cm oms_drc_supervisor sshd

   ```
 7. 复制新镜像文件到 OMS 社区版容器。

   ```shell
   sh docker_copy_dumpfile_to_container.sh ${OMS 社区版容器名称}

   ```
 8. 执行热升级脚本 `sh /root/docker_hot_update_init.sh`。

   ```shell
   sudo docker exec -it ${OMS 社区版容器名称} /root/docker_hot_update_init.sh

   ```

   如果热升级脚本执行失败，可以使用 `docker_copy_dumpfile_rollback.sh` 进行回滚，命令如下。

   #### 注意

   仅 1~7 步执行成功，第 8 步热升级脚本执行失败时，才可以使用该脚本进行回滚。否则，回滚脚本会因为没有备份文件导致清空原始文件。

   ```shell
   sh docker_copy_dumpfile_rollback.sh ${OMS 社区版容器名称} /home/admin/logs/backup2025xxxx
   sudo docker exec -it ${OMS 社区版容器名称} /root/docker_init.sh

   ```

   #### 说明

   `/home/admin/logs/backup2025xxxx` 是指 `docker_copy_dumpfile_rollback.sh` 在更新之前备份容器中旧版本 OMS 社区版相关信息的目录，默认目录 `/home/admin/logs` 下以 `backup` 作为前缀的文件。

## 常见问题

### 访问 OMS 社区版失败

- 问题描述

  热升级成功之后，访问 OMS 社区版可能出现以下两种问题。

     - 出现 `HTTP Status 500 – Internal Server Error` 报错。

       ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-ce/omsce10.png)
     - 未显示登录用户名称。

       ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-ce/omsce11-zh.png)
 - 解决方法

     1. 进入网站设置页面。

        ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-ce/omsce12-zh.png)
     2. 单击删除数据。

        ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-ce/omsce13-zh.png)

### OMS 社区版 V4.2.1-CE 热升级至 V4.2.13-CE

从 OMS 社区版 V4.2.1-CE 热升级至 V4.2.13-CE 之前，如果存在新建任务的 OceanBase Store 组件未启动或失败的情况，升级成功之后，OceanBase Store 参数中需要新增 `drc_frame.dbversion` 来表示 OceanBase 数据库的版本号。

 上一篇 下一篇 ![有帮助](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) 咨询热线