---
title: "接管集群 - 云平台 OCP V4.3.5 | OceanBase 文档中心"
description: 接管集群 您可通过接管集群的操作将通过黑屏操作或其它 OCP 创建的集群接管到当前 OCP 中，并通过当前 OCP 对新接管的集群继续运维和管理。 前提条件 当前登录 OCP 的用户为 ADMIN 角色或 ORG_ADMIN 角色。 待接管的 OceanBase 集群中所有 OBServer 节点都正常运行。 接管 …
---
切换语言

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

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

# 接管集群

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

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.5/zh-CN/600.cluster-functions/300.manage-a-cluster/400.take-over-a-cluster.md)  

您可通过接管集群的操作将通过黑屏操作或其它 OCP 创建的集群接管到当前 OCP 中，并通过当前 OCP 对新接管的集群继续运维和管理。

## 前提条件

- 当前登录 OCP 的用户为 **ADMIN** 角色或 **ORG_ADMIN** 角色。
 - 待接管的 OceanBase 集群中所有 OBServer 节点都正常运行。
 - 接管 OceanBase 集群时，应遵循主集群优先原则：

     - 单 OCP 场景下接管集群时，需先接管 OceanBase 主集群，再接管 OceanBase 备集群。
     - OCP 多集群场景下接管集群时，需先在某一 OCP 中接管 OceanBase 主集群后，再通过任一 OCP 接管 OceanBase 备集群。
 - 被接管的 OceanBase 集群内的租户服务名与系统内现存服务名均需保持唯一，否则接管后该集群中服务名冲突的租户，服务名状态将被置为 **非法**。关于服务名的更多介绍，可参见 [管理服务名](https://www.oceanbase.com/docs/common-ocp-1000000002380971)。
 - 若待接管的集群为 obd 部署的，接管前需要参考 [使用 OCP 接管 obd 部署的集群](https://www.oceanbase.com/docs/community-obd-cn-1000000001477802) 检查该集群是否满足接管条件。
 - 若待接管的 OceanBase 集群已配置仲裁服务，在执行接管前，请先迁出该仲裁服务并将其接管到新 OCP 中，详情可参考 [迁出仲裁服务](https://www.oceanbase.com/docs/common-ocp-1000000002381121)、[接管仲裁服务](https://www.oceanbase.com/docs/common-ocp-1000000002381118)。

## 注意事项

- 每个 OceanBase 集群只能被一个 OCP 管理。接管集群后，该集群在原 OCP 中将无法正常运维和监控，接管前请谨慎评估。建议您在接管前先对集群进行迁出操作，详情参见 [迁出集群](https://www.oceanbase.com/docs/common-ocp-1000000002381090)。
 - 若当前 OceanBase 集群与 OBProxy 集群共享相同主机，在迁出/接管场景下，请您务必遵守如下操作顺序，详情可参考 [OCP 机房迁移](https://www.oceanbase.com/docs/common-ocp-1000000002380821)。

     1. [迁出 OBProxy 集群](https://www.oceanbase.com/docs/common-ocp-1000000002380849)。
     2. [迁出 OceanBase 集群](https://www.oceanbase.com/docs/common-ocp-1000000002381090)。
     3. 接管 OceanBase 集群。
     4. [接管 OBProxy](https://www.oceanbase.com/docs/common-ocp-1000000002380845)。
 - 若被接管的集群已配置负载类型，在接管集群后，您需在集群 **概览** 页面重新为该集群配置负载类型。
 - 接管 OceanBase 集群时，为实现统一管理，OCP 会同步接管集群下 OBServer 对应的主机。

     - 若主机使用的凭据一致，可在 **预检查** 步骤中统一接管主机。
     - 若主机使用的凭据不一致，则需要您先在 [添加主机](https://www.oceanbase.com/docs/common-ocp-1000000002380718) 中接管对应主机，再接管集群。

## 操作步骤

1. 登录 OCP 。
 2. 在左侧导航栏选择 **集群** ，系统默认进入 **集群列表** 页签。
 3. 在 **集群列表** 页面，单击右上角 **接管集群** 。
 4. 连接集群，支持 **直连** 和 **OBProxy** 连接两种方式。

      - **直连：** 填写集群的连接 **访问地址** 、集群的连接 **端口** 、**root@sys 密码** ，并可选择是否 **录入 proxyro 账号的密码** ，单击 **下一步** 。

       #### 说明

       proxyro 账号的密码用于 OBProxy 访问 OceanBase 集群，您可在此处录入以确保 proxyro 密码的统一性。关于 proxyro 账号的更多信息，可参考 [proxyro 账号管理](https://www.oceanbase.com/docs/common-ocp-1000000002380858)。

       ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/420/%E6%8E%A5%E7%AE%A1%E9%9B%86%E7%BE%A4-%E7%9B%B4%E8%BF%9E.png)
      - **OBProxy：** 填写集群的连接 **访问地址** 、集群的连接 **端口**、**集群名**、**集群 ID（可选）**、**root@sys 密码**，并可选择是否 **录入 proxyro 账号的密码**，该账号用于 OBProxy 访问 OceanBase 集群。单击 **下一步** 。

       #### 说明

            - 当接管集群为备集群时，则集群 ID 为必填。主备集群都需要接管时，优先接管主集群，再接管备集群。
            - proxyro 账号的密码用于 OBProxy 访问 OceanBase 集群，您可在此处录入以确保 proxyro 密码的统一性。关于 proxyro 账号的更多信息，可参考 [proxyro 账号管理](https://www.oceanbase.com/docs/common-ocp-1000000002380858)。

       ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/420/%E6%8E%A5%E7%AE%A1%E9%9B%86%E7%BE%A4-obproxy.png)
 5. 连接集群成功后，进入接管预检查。

      - 当预检查通过时，若集群下存在某些 OBServer 对应的主机未被 OCP 管理，请填写相关信息，对主机进行统一接管。
      - 当预检查不通过时，根据页面提示修改 OBServer 节点配置，修改完成后单击 **重新检查**。

   ![09010928](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/401/%E6%8E%A5%E7%AE%A1%E9%9B%86%E7%BE%A41.png)
 6. 单击 **提交** 。

   任务提交后，您可在提交结果页面查看任务执行进度或返回集群概览页面。

   #### 说明

   由于 OCP 连接数据库需要在凭据管理中有对应的凭据串存在，当接管集群完成后，您可将 [导出集群](https://www.oceanbase.com/docs/common-ocp-1000000002381090) 时获取的集群凭据文件导入此 OCP 中，方便您批量上传集群的凭据信息，具体操作详情可参见 [导入凭据](https://www.oceanbase.com/docs/common-ocp-1000000002381151)。

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