首批通过分布式安全可靠测评,为关键业务系统打造
接管 OBProxy
更新时间:2026-03-27 16:35:46
本节为您介绍将 OBProxy 接管到当前 OCP 管理的 OBProxy 集群中的方法。未在当前 OCP 中的 OBProxy 称为待接管的 OBProxy,待接管的 OBProxy 将要接入的 OBProxy 集群为目标 OBProxy 集群。OBProxy 接入到目标 OBProxy 集群后会随该集群一起由当前 OCP 运维管理。
说明
OBProxy 在接管时会被重启,重启 OBProxy 将对业务连接产生影响,请谨慎操作。
前提条件
请确保当前登录 OCP 的用户具备如下权限:
- OBProxy 维护 资源权限。
- OBProxy 概览 菜单权限。
待接管的 OBProxy 需满足以下条件:
版本为 V1.8.0 及以上。
由 rpm 包标准安装。
所在主机上有且仅有这一个 obproxy 进程。
可被 OCP 所在网络访问。
所在主机已添加到 OCP,添加主机请参考 添加主机。
当前 OCP 中已存在符合条件的目标 OBProxy 集群,目标 OBProxy 集群需满足的条件如下:
启动方式 与待接管的 OBProxy 一致。
即如果目标 OBProxy 集群的启动方式为 ConfigUrl,则待接管的 OBProxy 的启动方式也应为 ConfigUrl。
可连接 OceanBase 集群 需包含或等于待接管的 OBProxy 的可连接 OceanBase 集群。
启动方式为 ConfigUrl 时,待接管 OBProxy 的可连接 OceanBase 集群需在目标 OBProxy 集群的可连接 OceanBase 集群列表中。
启动方式为 RsList 时,待接管 OBProxy 的可连接 OceanBase 集群需和目标 OBProxy 集群的可连接 OceanBase 集群完全相同。
如果当前 OCP 中没有符合条件的 OBProxy 集群,请先参考 创建 OBProxy 集群 创建符合条件的空 OBProxy 集群。
注意事项
当前 OBProxy 集群为 V4.0 及以上版本时,仅支持接管 V4.0.0 及以上版本的 OBProxy;当前 OBProxy 集群为 V3.x 及以下版本时,仅支持接管 V1.8 以上、V4.0.0 以下版本的 OBProxy。
当源 OCP 和目标 OCP 的
ocp.config-url.site.url配置项的值一致,且 OBProxy 集群名称相同、所有启动参数均支持动态更新(无需重启)时,可避免在接管时重启 OBProxy 服务。
操作步骤
接管 OBProxy 有如下两个入口:
- 入口一:在 OBProxy 的 集群列表 中找到可接管该 OBProxy 的集群,并单击对应操作列的 接管 OBProxy 。
- 入口二:在 集群列表 中单击可接管该 OBProxy 的集群的集群名,进入该 OBProxy 集群 概览 页面,单击 概览 页右上角的 接管 OBProxy 。
以下操作步骤以 入口二 为例:
登录 OCP。
在左侧导航栏单击 OBProxy。
在 集群列表 中单击可接管该 OBProxy 的集群的集群名,进入 OBProxy 概览 页面。
单击 接管 OBProxy,进入 接管 OBProxy 界面。

在 接管 OBProxy 界面选择待接管的 OBProxy 所在主机。
参数 说明 root@proxysys 密码 输入 OBProxy 管理员账号密码。此为选填项,若之前未更改过待接管 OBProxy 的 root@proxysys 密码,则不需要填写。 说明
当接管多个 OBProxy 时,若多个 OBProxy 的 root@proxysys 密码不一致,建议将密码相同的作为一组进行分批接管。
机房 OBProxy 所在的机房,一个 OBProxy 只能存在于一个机房。 机型 可选项。如果选择了机型,后面主机列表会根据机型进行过滤。 主机 选择 OBProxy 所在主机。 SQL 端口 选择 OBProxy 所在主机的 SQL 端口。 负载均衡配置 可选项。支持手动填入和导入两种方式,具体如下图所示。 - 单击 OBLB,手动填入 OBLB 服务相关信息,参数说明可参见 管理负载均衡。
- 单击右侧 导入 按钮,上传迁出 OBProxy 集群时所导出的负载均衡器数据文件,OCP 将自动填入文件中的负载均衡信息,文件导出详情可参见 迁出 OBProxy 集群。

单击 下一步 ,系统对待接管的 OBProxy 进行预检查,并将检查结果显示在预检查界面。
存在检查不通过的 OBProxy 时,不可执行接管,可:
视实际情况删除检查不通过的 OBProxy,只接管预检查通过的 OBProxy。
将鼠标悬浮于 检查结果 列的 原因 上,查看预检查不通过的原因。修复后,单击 重新检查 。

当列表中所有 OBProxy 的预检查结果均为通过时,可执行步骤 7。

单击 全部接管 按钮,在 接管确认 面板中 OBProxy 的接管信息。
当待接管的 OBProxy 上存在可连接的 OceanBase 集群时,接管 OBProxy 时会将 OBProxy 上的可连接 OceanBase 集群同步添加至 OBProxy 集群中。
当主机所在的 OBProxy 的部分参数值与 OBProxy 集群不一致,将无法进行接管,您需同意修改 OBProxy 参数。单击 同意修改 后,主机所在的 OBProxy 的参数均会被修改为与 OBProxy 集群参数一致。

在接管对话框中输入 confirm,并单击 确认接管,提交接管任务。
等待接管任务执行成功,则接管完成。
说明
为便于管理,当目标 OBProxy 被接管后,其 root@proxysys 密码将被统一设置为其所属的 OBProxy 集群的 root@proxysys 密码。