首批通过分布式安全可靠测评,为关键业务系统打造
接管集群
更新时间:2026-04-14 15:11:03
您可通过接管集群的操作将通过黑屏操作或其它 OCP 创建的集群接管到当前 OCP 中,并通过当前 OCP 对新接管的集群继续运维和管理。
前提条件
当前登录 OCP 的用户为 ADMIN 角色或 ORG_ADMIN 角色。
待接管的 OceanBase 集群中所有 OBServer 节点都正常运行。
接管 OceanBase 集群时,应遵循主集群优先原则:
单 OCP 场景下接管集群时,需先接管 OceanBase 主集群,再接管 OceanBase 备集群。
OCP 多集群场景下接管集群时,需先在某一 OCP 中接管 OceanBase 主集群后,再通过任一 OCP 接管 OceanBase 备集群。
被接管的 OceanBase 集群内的租户服务名与系统内现存服务名均需保持唯一,否则接管后该集群中服务名冲突的租户,服务名状态将被置为 非法。关于服务名的更多介绍,可参见 管理服务名。
若待接管的集群为 obd 部署的,接管前需要参考 使用 OCP 接管 obd 部署的集群 检查该集群是否满足接管条件。
若待接管的 OceanBase 集群已配置仲裁服务,在执行接管前,请先迁出该仲裁服务并将其接管到新 OCP 中,详情可参考 迁出仲裁服务、接管仲裁服务。
注意事项
每个 OceanBase 集群只能被一个 OCP 管理。接管集群后,该集群在原 OCP 中将无法正常运维和监控,接管前请谨慎评估。建议您在接管前先对集群进行迁出操作,详情参见 迁出集群。
若当前 OceanBase 集群与 OBProxy 集群共享相同主机,在迁出/接管场景下,请您务必遵守如下操作顺序,详情可参考 OCP 机房迁移。
- 迁出 OBProxy 集群。
- 迁出 OceanBase 集群。
- 接管 OceanBase 集群。
- 接管 OBProxy。
若被接管的集群已配置负载类型,在接管集群后,您需在集群 概览 页面重新为该集群配置负载类型。
接管 OceanBase 集群时,为实现统一管理,OCP 会同步接管集群下 OBServer 对应的主机。
- 若主机使用的凭据一致,可在 预检查 步骤中统一接管主机。
- 若主机使用的凭据不一致,则需要您先在 添加主机 中接管对应主机,再接管集群。
操作步骤
登录 OCP 。
在左侧导航栏选择 集群 ,系统默认进入 集群列表 页签。
在 集群列表 页面,单击右上角 接管集群 。
连接集群,支持 直连 和 OBProxy 连接两种方式。
直连: 填写集群的连接 访问地址 、集群的连接 端口 、root@sys 密码 ,并可选择是否 录入 proxyro 账号的密码 ,单击 下一步 。
说明
proxyro 账号的密码用于 OBProxy 访问 OceanBase 集群,您可在此处录入以确保 proxyro 密码的统一性。关于 proxyro 账号的更多信息,可参考 proxyro 账号管理。

OBProxy: 填写集群的连接 访问地址 、集群的连接 端口、集群名、集群 ID(可选)、root@sys 密码,并可选择是否 录入 proxyro 账号的密码,该账号用于 OBProxy 访问 OceanBase 集群。单击 下一步 。
说明
- 当接管集群为备集群时,则集群 ID 为必填。主备集群都需要接管时,优先接管主集群,再接管备集群。
- proxyro 账号的密码用于 OBProxy 访问 OceanBase 集群,您可在此处录入以确保 proxyro 密码的统一性。关于 proxyro 账号的更多信息,可参考 proxyro 账号管理。

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

单击 提交 。
任务提交后,您可在提交结果页面查看任务执行进度或返回集群概览页面。
说明
由于 OCP 连接数据库需要在凭据管理中有对应的凭据串存在,当接管集群完成后,您可将 导出集群 时获取的集群凭据文件导入此 OCP 中,方便您批量上传集群的凭据信息,具体操作详情可参见 导入凭据。