---
title: 编组
description: 升级版本 本节介绍使用 OCP 升级 OceanBase 集群的操作方法。因 OceanBase 升级方法与其版本强相关，具体升级事项还请参考 OceanBase 官网 中对应版本的《升级指南》。 前提条件 请确保当前登录账号具备集群的管理权限。 当前集群为 V4.0 及以上版本时，不支持对集群进行升级。 （可选）如…
---
切换语言

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

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

# 升级版本

更新时间：2023-08-10 11:45:58

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

## 前提条件

- 请确保当前登录账号具备集群的管理权限。
 - 当前集群为 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。

## 操作步骤

1. 登录 OCP 。
 2. 在左侧导航栏单击 **集群**，进入 **集群** 概览页面。
 3. 在 **集群列表** 区域，选择待操作的集群并单击其集群名。

   系统默认进入该集群的 **总览** 页面。
 4. 单击 **总览** 页面右上角的 **...** 图标，选择并单击 **升级版本** 。

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

   ![1130](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/4270628361/p360958.png)

      - **集群** 中展示当前准备升级的 OceanBase 集群。

       若步骤 2 中进入的集群有关联的主/备集群，则主/备集群也会作为本次的目标集群一同被升级。
      - **升级方式** 请根据您业务的实际情况选择。

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

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

#### 说明

- 仅可选择高于当前版本的软件包版本。
 - 选择软件包版本后，系统会检查是否存在符合当前集群硬件架构的安装包。当缺少指定架构的安装包时，将无法进行升级。

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) 咨询热线
