---
title: "安装、升级、版本回退和卸载 OCP | OceanBase 文档中心"
description: 安装、升级、版本回退和卸载 OCP 本文介绍如何使用 OAT 安装、升级、版本回退和卸载 OCP。 前提条件 在安装 OCP 之前，您需要确认以下信息： 您已安装并使用超级管理员或运维人员账号登录 OAT。更多信息，参考 安装 OAT 。 您已添加待安装 OCP 的服务器。更多信息，参考 添加服务器 。 您的服务器满…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*jLd4SamEcM0AAAAAAAAAAAAADiGDAQ/original) 管理者工具 OATV 4.3.2 企业版

# 安装、升级、版本回退和卸载 OCP

更新时间：2026-04-13 16:30:39

本文介绍如何使用 OAT 安装、升级、版本回退和卸载 OCP。

## 前提条件

在安装 OCP 之前，您需要确认以下信息：

- 您已安装并使用超级管理员或运维人员账号登录 OAT。更多信息，参考 [安装 OAT](https://www.oceanbase.com/docs/enterprise-oat-doc-cn-1000000003049301)。
 - 您已添加待安装 OCP 的服务器。更多信息，参考 [添加服务器](https://www.oceanbase.com/docs/enterprise-oat-doc-cn-1000000003049330)。
 - 您的服务器满足安装 OCP 的要求。更多信息，参考 [OCP 资源规划](https://www.oceanbase.com/docs/common-ocp-1000000001740935)。
 - 您已为 OCP 创建元数据库 MetaDB 组件。更多信息，参考 [创建 MetaDB](https://www.oceanbase.com/docs/enterprise-oat-doc-cn-1000000003049319)。

## 安装 OCP

按照以下步骤安装 OCP：

1. 在左侧导航栏，单击 **产品服务 > 产品**。
 2. 在 **产品管理** 页面，单击右上角的 **安装产品**，选择 **安装 OCP**。
 3. 在 **安装 OCP** 页面，配置各项参数。

   **OCP 基础配置参数如下：**

   | 参数 | 说明 |
   | --- | --- |
   | OCP 镜像 | OCP 的 Docker 镜像。   #### 说明    OCP V3.3.0 以下版本不支持搭配 OpenSearch 使用。 |
   | 产品名称 | 产品名称，不允许与其他产品重名。 |
   | 多可用区模式 | 启用多可用区安装。 |
   | 服务器 | 待安装 OCP 的服务器 IP 地址。 |
   | OCP 代理 IP | 与多可用区模式关联，当多可用区模式开启时，需要填写此可用区的 OCP 访问入口 IP，此 IP 为虚拟 IP。 |
   | OCP 代理端口 | 与多可用区模式关联，当多可用区模式开启时，需要填写此可用区的 OCP 访问入口端口号，默认值为 `80`，此端口为虚拟端口，实际端口为 HTTP 端口。 |
   | CPU | OCP 在服务器上可用的 CPU，默认为 8C。 |
   | 内存 | OCP 在服务器上可用的内存，默认为 20G。 |
   | HTTP 端口 | OCP 的 HTTP 端口号，默认为 8080。 |
   | 多集群模式 | 启用多集群安装模式。 |
   | 日志目录 | OCP 的日志存储路径。 |

   **OCP 元数据库 MetaDB 配置参数如下：**

   | 参数 | 说明 |
   | --- | --- |
   | 存储数据库类型 | 选择 MetaDB 的类型。 |
   | 选择已创建的 MetaDB | 为 OCP 选择已创建的 MetaDB。 |
   | OCP Meta 租户 | OCP MetaDB 的专用租户。 |
   | OCP Monitor 租户 | OCP MonitorDB 的专用租户。 |
   | 租户名 | 租户名称。 |
   | 租户密码 | 租户密码。 |
   | CPU | MetaDB 在服务器上可用的 CPU，默认为 2C。 |
   | 内存 | MetaDB 在服务器上可用的内存，默认为 5G。 |
   | CPU | MonitorDB 在服务器上可用的 CPU，默认为 4C。 |
   | 内存 | MonitorDB 在服务器上可用的内存，默认为 16G。 |
   | 接管 MetaDB 集群 | 勾选以接管 MetaDB 集群。接管后可以在 OCP 中看到此 MetaDB 集群。每个 OceanBase 集群只能被一个 OCP 接管。 |

   **（可选）负载均衡配置参数如下：**

   | 参数 | 说明 |
   | --- | --- |
   | 负载均衡模式 | 选择负载均衡模式。 |
   | MetaDB TCP 代理 IP | TCP 协议地址，用来连接 MetaDB。 |
   | MetaDB TCP 代理端口 | TCP 协议端口号。 |
   | OCP HTTP 代理域名 | HTTP 协议地址，用来访问 OCP 的控制台。 |
   | OCP HTTP 代理端口 | HTTP 协议端口号。 |

   **OpenSearch 配置：**

   OAT 在 V4.1.2 版本中，新增 OpenSearch 配置，用户在创建 OCP 时，可以选择配置 OpenSearch。

   OpenSearch 配置的模式分为如下三种：

      - 已创建的 OpenSearch：用户可以在下拉框内选择通过 OAT 创建的 OpenSearch，关于 OpenSearch 的创建可参考 [创建和卸载 OpenSearch](https://www.oceanbase.com/docs/enterprise-oat-doc-cn-1000000003049313)
      - 外部的 OpenSearch：需要填写外部部署的 OpenSearch 的 URL、用户名、密码。
      - 不使用。
 4. OCP 配置完成后，点击 **提交**。 如果您的配置有误，点击 **重置** 一键恢复默认配置。

## 升级 OCP

按以下步骤升级 OCP：

1. 在左侧导航栏，单击 **产品服务 > 产品**。
 2. 找到待升级的 OCP 服务，在对应的 **名称** 列中，单击产品名称进入详情页。

   #### 说明

   支持名称检索，您可以在页面上方通过产品名称搜索查询。
 3. 在详情页右上角，单击 **升级**。
 4. 在弹出的 **升级** 对话框中，填写相关信息。

   相关字段说明如下：

   | 字段 | 描述 |
   | --- | --- |
   | 升级方式 | - 停服升级：适用于无业务连续性的产品，升级期间 OAT 会先停止产品旧版本服务，无法对外提供服务。   - 滚动升级：滚动升级期间，可以访问 OCP 未在升级的节点，提供只读服务。  #### 注意     - 如果升级的 OCP 是 V4.0.1 或之后的版本，不再需要 OCP 的用户名和密码，表单里也会自动消失。   - OCP 滚动升级要求当前 OCP 是 V4.3.0 或之后的版本，且部署架构为多节点。 |
   | 请选择升级的镜像文件 | 目标升级镜像文件。 |
   | 用户名 | OCP 用户名。 |
   | 密码 | OCP 密码。 |
 5. 单击 **确认**。

   #### 说明

   如果您安装的是 OCP V4.1.0 及以上版本，OAT 将提示您为 OCP 设置初始密码。如果您安装的是 OCP V4.1.0 以下版本，OAT 将不做此提示。

## 版本回退

### 支持版本回退场景

- OAT 升级产品任务失败，暂时无法解决，在任务中心页面发起版本回退任务，回退为升级前版本。
 - OAT 升级产品任务成功，使用产品过程中发现问题，产品回退为上一个版本。

### 使用版本回退限制

- 使用 OAT V4.3.0 或之后的版本进行的产品升级任务才允许进行版本回退。
 - OAT 上发起升级任务三天内允许回退。
 - OAT 升级产品任务的备份元数据子任务完成。
 - 如果 OCP 是多集群模式，需要用户先回退主集群，然后再发起回退备集群任务。
 - 升级前 OCP 为 V3.2.0 或之后的版本。

### 版本回退执行步骤

OAT 升级 OCP 产品任务成功，按以下步骤回退 OCP 版本：

1. 在左侧导航栏，单击 **产品服务 > 产品**。
 2. 找到待回退的 OCP 服务，在对应的 **名称** 列中，单击产品名称进入详情页。

   #### 说明

   支持名称检索，您可以在页面上方通过产品名称搜索查询。
 3. 在详情页右上角，单击 **版本回退**。
 4. 在弹出的 **版本回退** 对话框中，填写相关信息。

   相关字段说明如下：

   | 字段 | 描述 |
   | --- | --- |
   | 选择元数据备份文件 | 可选项，选择回退使用的元数据文件。 |
   | 请选择版本回退的镜像文件 | 选择回退使用的镜像文件。 |
   | 版本回退会丢失所有监控和诊断数据 | 勾选该选项。   #### 说明    因为数据量太大，无法备份 `ocp_monitor` 租户下的数据。 |
   | 版本回退会丢失当前版本运行期间产生的数据记录，当前版本新增加的功能/服务可能会有异常 | 勾选该选项。 |
 5. 单击 **确定**。

### 回退影响

- 停服回退，回退期间服务不可用。
 - 新版本中进行的运维操作信息会丢失，元数据可能会和实际不一致等。
 - 监控、诊断信息会丢失。
 - 任务列表可能有超前的信息。
 - 版本回退后新版本 OCP 增加的功能/服务可能会有异常，比如新版本安装了 binlog，老版本不支持。

## 卸载 OCP

按以下步骤卸载 OCP：

1. 在左侧导航栏，单击 **产品服务 > 产品**。
 2. 找到待卸载的 OCP 服务，在对应的 **名称** 列中，单击产品名称进入详情页。

   #### 说明

   支持名称检索，您可以在页面上方通过产品名称搜索查询。
 3. 在详情页右上角，单击 **卸载**。
 4. 在弹出的确认框中，单击 **卸载**。

   OAT 会提示正在卸载中。同时，OAT 还会创建一个卸载任务，您可以在弹出的确认框中单击任务 ID，查看当前卸载任务的执行进度。

## 后续操作

安装 OCP 后，您可以使用 OCP 监控、运维 OceanBase 数据库。更多信息，参考 [OCP 文档](https://www.oceanbase.com/docs/oceanbase-ocp-cn)。

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