升级版本

本节介绍使用 OCP 升级 OceanBase 集群的操作方法。因 OceanBase 升级方法与其版本强相关，具体升级事项还请参考 OceanBase 官网 中对应版本的《升级指南》。

前提条件

• 请确保当前登录账号具备集群的管理权限。

• 当前集群为 V4.0 及以上版本时，不支持对集群进行升级。

• （可选）如升级 OceanBase 的目标版本低于 V2.2.60，则需在 OCP 的 /home/admin/ocp-server/etc/oceanbase_upgrade_dep.yml 文件中定义了类似如下的升级路径。填写方法可参考该文件顶部介绍。

  ###以上省略
  - 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. 单击 总览 页面右上角的 ... 图标，选择并单击 升级版本 。

   系统弹出 升级版本 界面。

   

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

     若步骤 2 中进入的集群有关联的主/备集群，则主/备集群也会作为本次的目标集群一同被升级。

   • 升级方式 请根据您业务的实际情况选择。

     • 滚动升级（推荐） ：升级过程中不停业务，建议优先选择。

     • 停服升级 ：升级过程中会停业务，请慎重选择。如果您的 Zone 个数小于 3，滚动升级时则无法构成多数派，建议您选择 停服升级 。

   • 升级版本 中选择升级 OceanBase 的目标版本。

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

5. 单击 升级 。

   • 如报错" 未找到从版本 xxx 到版本 xxx 的升级路径"，请先参考前提条件中的提示去 oceanbase_upgrade_dep.yml 文件中定义升级路径。

   • 正常时，系统弹出 xxx 升级路径确认 的界面。

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

     

6. 单击 确定 。

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

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

7. 查看升级任务。

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

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

   

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