升级版本

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

前提条件

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

  • 集群维护 资源权限。
  • 集群 概览 菜单权限。

• 当 OceanBase 集群为 V4.0 以下版本时，仅支持升级至 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。

• 由于 2F1R （即 2 个全功能副本 + 1 个只读副本）不支持轮转升级，对于 2F1R 部署方案的集群，需将 R 副本转换为 F 副本。

升级策略

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

• 当待升级的集群为 V4.x 及以上版本时：

  • 主备级联部署场景

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

  • 主备租户场景

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

    1. 统一租户类型。在升级开始前，执行 主备租户日常切换 操作，确保两集群中的租户类型一致，即同为主租户或同为备租户。若租户类型已一致，可跳过此步骤。

       注意

       此操作会造成业务断连，建议提前为主备租户配置 Service Name 并设置应用重连机制。

    2. 升级备租户所在集群。优先升级当前备租户所在集群版本，得益于 OceanBase 的 CLOG 日志向前兼容性，在升级备租户所在集群后，能够确保日志同步机制的正常运行。

    3. 升级主租户所在集群。升级主租户所在集群，确保两集群版本保持一致。请注意尽量缩短主备租户所在集群版本不一致的时间窗口，以降低同步异常风险。

    4. 恢复业务布局。升级完成后，执行 主备租户日常切换 操作，按业务需求重新排布主备租户关系。若租户类型已一致，可跳过此步骤。

       注意

       此操作会造成业务断连，建议提前为主备租户配置 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。

• 若您选择调整 Zone 的升级顺序，需注意：

  • OceanBase 4.X 仅支持主备租户，建议您升级前将主租户切换至同一集群，方便系统进行集群升级操作。

  • OceanBase 2.X/OceanBase 3.X 仅支持设置主集群 Zone 升级顺序，若存在备集群，则优先升级备集群，备集群会按默认顺序进行升级且升级过程中不会停止。

  • 当开始执行主集群升级任务后，您需要在任务流程 Stop Zone 之前手动确认是否继续执行升级操作，关于任务流程，详情可参考 管理任务。同时，建议您尽快执行完升级操作，避免出现异常行为造成集群升级问题。

• 集群升级完成后，请务必对集群手动发起一次全量备份。

操作步骤

1. 登录 OCP 。

2. 在左侧导航栏单击 集群 ，系统默认进入 集群列表 页签。

3. 在 集群列表 中选择待操作的集群并单击其集群名。

4. 进入集群 概览 页面，单击右上角 ... 图标，选择 升级版本 。

   系统弹出 升级版本 界面。

   

   • 查看当前准备升级的 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 包。

     

6. 单击 确定 。

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

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

   注意

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

7. 查看升级任务。

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

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

   

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