---
title: "升级版本 - 云平台 OCP V4.3.5 | OceanBase 文档中心"
description: 升级版本 本节介绍使用 OCP 升级 OceanBase 集群的操作方法。因 OceanBase 升级方法与其版本强相关，具体升级事项还请参考 OceanBase 官网中对应版本的 集群升级 。 前提条件 请确保当前登录 OCP 的用户具备如下权限： 集群维护 资源权限。 集群 概览 菜单权限。 当 OceanBas…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.3.5

# 升级版本

更新时间：2026-04-14 15:11:03

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.5/zh-CN/600.cluster-functions/700.upgrade-cluster-version.md)  

本节介绍使用 OCP 升级 OceanBase 集群的操作方法。因 OceanBase 升级方法与其版本强相关，具体升级事项还请参考 OceanBase 官网中对应版本的 [集群升级](https://www.oceanbase.com/docs/oceanbase-database-cn) 。

## 前提条件

- 请确保当前登录 OCP 的用户具备如下权限：

     - **集群维护** 资源权限。
     - 集群 **概览** 菜单权限。
 - 当 OceanBase 集群为 V4.0 以下版本时，仅支持升级至 V4.0 以下版本。
 - （可选）如升级 OceanBase 的目标版本低于 V2.2.60，则需在 OCP 的 `/home/admin/ocp-server/etc/oceanbase_upgrade_dep.yml` 文件中定义类似如下的升级路径。填写方法可参考该文件顶部介绍。

  ```yaml
  ###以上省略
  - version: 2.2.70
    can_be_upgraded_to:
        - 2.2.71
  - version: 2.2.71
    can_be_upgraded_to:
        - 2.2.72
  - version: 2.2.72
    can_be_upgraded_to:
        - 2.2.73
  - version: 2.2.73         # 目标版本必须以这样的形式（包含下面两行）完整的出现。
    can_be_upgraded_to:
        - 2.2.74

  ```

  #### 说明

  以上表示可以将 OceanBase 从 V2.2.72、V2.2.71、V2.2.70 及之前的任一版本升级到 V2.2.73，但无法升级到 V2.2.74。
 - 已上传升级路径上所需的所有 RPM 包，如：`oceanbase-x.x.x-YYYYMMDDhhmmss.el7.x86_64.rpm` 或 `oceanbase-x.x.x-YYYYMMDDhhmmss.el7.aarch64.rpm`。
 - 由于 2F1R （即 2 个全功能副本 + 1 个只读副本）不支持轮转升级，对于 2F1R 部署方案的集群，需将 R 副本转换为 F 副本。

## 升级策略

- 当待升级的集群为 V4.x 以下版本时，若集群存在关联的主/备集群，则主/备集群也会作为本次的目标集群一同被升级。
 - 当待升级的集群为 V4.x 及以上版本时：

     - **主备级联部署场景**

      升级策略应遵循从下游到上游的顺序。建议优先升级最末端的备租户所在的集群，确保数据同步链路稳定性，避免因版本差异导致的同步异常。
     - **主备租户场景**

      若两个集群下的租户存在主备关系，建议参考如下步骤进行升级：

           1. 统一租户类型。在升级开始前，执行 [主备租户日常切换](https://www.oceanbase.com/docs/common-ocp-1000000002381049) 操作，确保两集群中的租户类型一致，即同为主租户或同为备租户。若租户类型已一致，可跳过此步骤。

             #### 注意

             此操作会造成业务断连，建议提前为主备租户配置 Service Name 并设置应用重连机制。
           2. 升级备租户所在集群。优先升级当前备租户所在集群版本，得益于 OceanBase 的 CLOG 日志向前兼容性，在升级备租户所在集群后，能够确保日志同步机制的正常运行。
           3. 升级主租户所在集群。升级主租户所在集群，确保两集群版本保持一致。请注意尽量缩短主备租户所在集群版本不一致的时间窗口，以降低同步异常风险。
           4. 恢复业务布局。升级完成后，执行 [主备租户日常切换](https://www.oceanbase.com/docs/common-ocp-1000000002381049) 操作，按业务需求重新排布主备租户关系。若租户类型已一致，可跳过此步骤。

             #### 注意

             此操作会造成业务断连，建议提前为主备租户配置 Service Name 并设置应用重连机制，确保业务最终按预期布局。

## 注意事项

- 对于 OceanBase V4.2.1 及以上版本，当使用 DBLink 功能访问远端 Oracle 数据库时，需要在集群所有 OBServer 节点上安装并配置 OCI-12.2。此外，对于 OceanBase V4.2.1 以下版本升级到 V4.2.1 及以上版本的场景，也需要您将原来配置的 OCI-11.2 重新配置为 OCI-12.2。 请参见 [安装配置 OCI](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000641866)。
 - 若您选择调整 Zone 的升级顺序，需注意：

     - OceanBase 4.X 仅支持主备租户，建议您升级前将主租户切换至同一集群，方便系统进行集群升级操作。
     - OceanBase 2.X/OceanBase 3.X 仅支持设置主集群 Zone 升级顺序，若存在备集群，则优先升级备集群，备集群会按默认顺序进行升级且升级过程中不会停止。
     - 当开始执行主集群升级任务后，您需要在任务流程 **Stop Zone** 之前手动确认是否继续执行升级操作，关于任务流程，详情可参考 [管理任务](https://www.oceanbase.com/docs/common-ocp-1000000002380773)。同时，建议您尽快执行完升级操作，避免出现异常行为造成集群升级问题。
 - 集群升级完成后，请务必对集群手动发起一次全量备份。

## 操作步骤

1. 登录 OCP 。
 2. 在左侧导航栏单击 **集群** ，系统默认进入 **集群列表** 页签。
 3. 在 **集群列表** 中选择待操作的集群并单击其集群名。
 4. 进入集群 **概览** 页面，单击右上角 **...** 图标，选择 **升级版本** 。

   系统弹出 **升级版本** 界面。

   ![1130](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/432/%E5%8D%87%E7%BA%A7%E7%89%88%E6%9C%AC.png)

      - 查看当前准备升级的 OceanBase 集群信息，包括 `集群名:集群 ID`、OceanBase 版本及 CPU 架构。
      - 勾选是否在停止进程前执行转储操作，执行本动作会延长停止进程的响应时间，但可以显著缩短 OBServer 恢复时间。
      - 请根据您业务的实际情况选择升级方式。

            - **滚动升级（推荐）** ：升级过程中不停业务，建议优先选择。
            - **停服升级** ：升级过程中会停业务，请慎重选择。如果您的 Zone 个数小于 3，滚动升级时则无法构成多数派，建议您选择 **停服升级** 。
      - 在升级版本中选择升级 OceanBase 的目标版本。

       若 OCP 中无目标版本的 RPM 包，则可通过下拉框中列表下方的 **添加版本** 来上传目标版本的 RPM 包。

       #### 说明

            - **单机集中式** 数据库仅支持 **停服升级**。
            - 仅可选择高于当前版本的软件包版本。
            - 选择软件包版本后，系统会检查是否存在符合当前集群硬件架构的安装包。当缺少指定架构的安装包时，将无法进行升级。
      - 当 **升级方式** 选择 **滚动升级** 时，支持调整 Zone 的升级顺序。

       默认首先升级 RS Leader 节点所在的 Zone，其余默认根据集群概览中 **Zone 列表** 的顺序依次进行升级，您可通过拖拽调整升级顺序。
 5. 单击 **升级** 。

      - 如报错 “未找到从版本 xxx 到版本 xxx 的升级路径”，请先参考前提条件中的提示去 `oceanbase_upgrade_dep.yml` 文件中定义升级路径。
      - 正常时，系统弹出 **xxx 升级路径确认** 的界面。

       在该界面确认升级路径上所有版本的 RPM 包是否都存在，若不存在，可通过 **去上传** 按钮上传缺失的 RPM 包。

       ![07061854](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/6978365261/p291963.png)
 6. 单击 **确定** 。

   您可通过弹出框中的 **查看任务** 按钮，查看升级进度。

   当任务状态为 **完成** ，且 **集群** 页的 **集群列表** 中该集群的状态均为 **运行中** 时，表示升级成功。

   #### 注意

   OCP 不支持对 OceanBase 集群升级任务的回滚，请勿手动跳过或回滚任务。
 7. 查看升级任务。

   升级时会产生一个主任务及多个子任务。主任务根据每个需要替换 binary 版本的升级节点，来生成数个子任务，来逐步替换掉需要升级的 binary 文件。

      - 主任务：将升级路径中每个需要替换 binary 文件的升级节点都生成为一个子任务，用于逐步替换掉需要升级的 binary 文件。 如下图所示，`Submit cluster upgrade task` 即为生成一个子任务。`Wait dag success` 为等待子任务执行完成。`Submit cluster upgrade task` 和 `Wait dag success` 这个组合可能会执行多次，执行次数取决于升级路径中有多少个替换 binary 的节点。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E4%B8%BB%E4%BB%BB%E5%8A%A1.png)

      - 子任务：升级所有 OceanBase 集群版本。主要是执行升级脚本: 预检查脚本、升级 Pre 脚本、替换 OBServer 节点、升级 Post 脚本、版本检查等。

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E5%AD%90%E4%BB%BB%E5%8A%A1.png)

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