---
title: "使用图形化界面升级 OCP - 云平台 OCP V4.3.5 | OceanBase 文档中心"
description: 使用图形化界面升级 OCP 本节为您介绍如何通过 OceanBase 安装部署工具（OceanBase Deployer，OBD）将 OCP-CE 升级到最新版本。 前提条件 仅支持 OCP V4.0.3 及之后版本通过该方式进行升级，其它版本升级方式可联系技术支持获取。 已安装并配置 Java 环境，目前仅支持 J…
---
切换语言

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

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

# 使用图形化界面升级 OCP

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

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.5/zh-CN/400.upgrade-guide/200.upgrade-community-ocp/100.update-ocp.md)  

本节为您介绍如何通过 OceanBase 安装部署工具（OceanBase Deployer，OBD）将 OCP-CE 升级到最新版本。

## 前提条件

- 仅支持 OCP V4.0.3 及之后版本通过该方式进行升级，其它版本升级方式可联系技术支持获取。
 - 已安装并配置 Java 环境，目前仅支持 JDK1.8 版本。
 - 已参见 [安装准备](https://www.oceanbase.com/docs/common-ocp-1000000002381078) 获取 `ocp-all-in-one-4.3.5-YYYYMMDDhhmmss.el7.x86_64.tar.gz` 软件包，将软件包上传至 OCP 宿主机的任一目录，执行如下命令进行解压。

  ```bash
  tar zxf ocp-all-in-one-4.3.5-YYYYMMDDhhmmss.el7.x86_64.tar.gz

  ```

## 操作步骤

### 步骤一：启动 obd

1. 登录 obd 中控机所在节点。
 2. 执行如下命令进入解压后软件包的 `bin` 目录下，启动部署程序。

   ```bash
   cd ocp-all-in-one/bin && bash install.sh

   ```
 3. 执行如下命令，使环境变量生效。

   ```bash
   source ~/.oceanbase-all-in-one/bin/env.sh

   ```
 4. 执行 `obd web upgrade` ，在返回信息中获取升级向导页面的 IP 地址。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421-ce/upgrade.png)

### 步骤二：进入 OCP 升级向导页面

通过浏览器访问 **步骤一** 获取的 IP 地址，进入升级向导页面，单击 **开始升级**。

![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421-ce/%E5%8D%87%E7%BA%A7%E5%90%91%E5%AF%BC.png)

### 步骤三：配置部署相关信息

1. 自定义待管理的 OceanBase 集群名称。

   系统会自动获取已被 OBD 管理的所有集群名称，您可在 **集群名称** 下拉列表选择需要升级的集群。 若您需要升级的集群（如使用 docker 部署的集群）未被 OBD 接管，可手动输入集群名。当集群升级完成后，OBD 将自动接管该集群。
 2. 选择要升级的产品版本。

![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421-ce/%E5%8D%87%E7%BA%A7%E9%85%8D%E7%BD%AE.png)

### 步骤四：验证 MetaDB 联通性

1. 确认 MetaDB 连接信息是否无误，单击 **验证**，系统将校验该 MetaDB 是否连接成功。

   安装程序会根据当前主机的 OCP 自动获取 MetaDB 配置信息，请检查表单中的信息是否与预期待升级环境一致，OCP 将根据该信息执行升级程序。
 2. 填写操作系统用户相关信息，填写完成后，单击 **验证** 测试用户连通性。

   | 参数 | 说明 |
   | --- | --- |
   | 用户名 | 需提供主机操作系统的用户以便安装程序进行自动化配置，该用户名需具有 sudo 权限。 |
   | 用户密码 | 需输入 **用户名** 的对应密码。当主机已设置免密时，可忽略此项配置。 |
 3. 单击 **下一步**。

![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421-ce/%E8%BF%9E%E6%8E%A5%E4%BF%A1%E6%81%AF.png)

### 步骤五：环境预检查

环境预检查将验证您的环境是否满足升级 OCP 的要求。

系统会根据 MetaDB 配置信息，获取 OCP 相关配置信息，为保证管理功能一致性，升级程序将升级平台管理服务（COP Server）及其管理的所有主机代理服务（OCP Agent）。

1. 确认 **安装配置** 及 **升级配置信息** 中的升级内容是否满足预期要求，确认无误后单击 **预检查**。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421-ce/%E5%8D%87%E7%BA%A7%E9%85%8D%E7%BD%AE%E4%BF%A1%E6%81%AF.png)
 2. 查看检查结果。

      - 若检查通过，单击 **下一步**。
      - 若检查失败，支持对失败项进行修复或忽略。若选择修复，待修复完成后单击 **重新检查**，系统将重新执行环境预检查程序；若选择忽略，单击 **忽略全部未通过项**，此时未通过的检查项状态将变更为 **已忽略**，可进行 **下一步**。  

   #### 注意

   忽略全部未通过项可能会导致升级失败，建议您修复检查失败项后再进行下一步。

   ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421-ce/%E5%8D%87%E7%BA%A7%E9%A2%84%E6%A3%80%E6%9F%A5.png)

### 步骤六：升级 OCP

OCP 升级过程中，您可以通过 **升级日志** 模块查看详细升级日志。

- 若 OCP 升级成功，可在 **升级日志** 中查看 OCP 登录信息，包括 URL、用户名及密码等。
 - 若 OCP 升级失败，请查看日志信息获取失败原因，并联系技术支持同学进行处理。待定位安装失败问题原因且修复问题后，单击 **重新升级** ，系统将重新执行失败的升级步骤。

#### 说明

升级 OCP 的过程会耗时较长，请您耐心等待。

![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421-ce/ocp%E5%8D%87%E7%BA%A7%E6%88%90%E5%8A%9F.png)

### 步骤七（可选）：使用 OBD 接管原 metadb 集群

使用 OBD 升级 OCP 后，若您想使用 OBD 管理原 OCP 的 metadb 集群，您可将原 metadb 集群的信息复制到 OBD 目录下即可，命令如下：

```bash
cp -rf ~/.ocp-installer/cluster/<metadb_cluster_name> ~/.obd/cluster/

```

其中，`metadb_cluster_name` 表示原 metadb 集群的名称，您需根据实际情况替换。

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