首批通过分布式安全可靠测评,为关键业务系统打造
接管集群
更新时间:2026-01-15 10:40:51
您可通过接管集群的操作将通过黑屏操作或其它 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 集群时,为实现资源的统一管理,OCP 会同步接管集群下 OBServer 对应的主机。
- 若主机使用的凭据一致,可在接管集群的 预检查 步骤中统一接管主机。
- 若主机使用的凭据不一致,则先在 添加主机 中接管对应主机,再接管集群。
- 若当前 OceanBase 集群与 OBProxy 集群共享相同主机,在迁出/接管场景下,请您务必遵守如下操作顺序,详情可参考 OCP 机房迁移。
- 迁出 OBProxy 集群。
- 迁出 OceanBase 集群。
- 接管 OceanBase 集群。
- 接管 OBProxy。
操作步骤
登录 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 中,方便您批量上传集群的凭据信息,具体操作详情可参见 导入凭据。
后续步骤
- 若被接管的集群已配置负载类型,接管集群后,需要在集群 概览 页面重新为集群配置负载类型。
- 若集群内租户已开启 TDE 加密,接管集群后,请在当前 OCP 内完成相关租户的 TDE 加密配置,否则添加 OBServer、新建备租户及新建加密表空间等功能将不可用。
- 接管集群后,请根据原集群或租户的备份策略,重新配置相应的备份策略。