接管 OBProxy

本节为您介绍如何接管 OBProxy。在本文中，即将接管进 OCP 的 OBProxy 称为待接管的 OBProxy，待接管的 OBProxy 将要接入的 OBProxy 集群称为目标 OBProxy 集群。

应用场景

接管 OBProxy 操作将会使待接管的 OBProxy Server 被 OCP 管理，通常与 迁出 OBProxy 集群 配合使用，用来将 OBProxy 从一个 OCP 迁移到另一个 OCP 中。

注意事项

接管 OBProxy 是以单个 OBProxy Server 为最小粒度，而迁出 OBProxy 集群只能整集群迁出，二者略有不同。因此在接管时，需要在 OCP 上准备一个已有的 OBProxy 集群，用来将 OBProxy Server 接管进目标 OBProxy 集群。

前置条件

• 待接管的 OBProxy 需要满足以下条件：

  • OBProxy 的版本为 V1.8.0 及以上。
  • 所在主机上有且仅有 1 个 OBProxy 进程。
  • 若 OBProxy 使用了非默认的 root@proxysys 密码，则需要提前准备好 root@proxysys 密码。
  • 所在主机已被 OCP 管理。
  • OBProxy 有可连接的 OceanBase 集群，并且使用过 OBProxy 连接到 OceanBase 集群。

• 目标 OBProxy 集群需要满足以下条件：

  • 启动方式（ConfigUrl / RsList）与待接管的 OBProxy 一致。
  • 可连接的 OceanBase 集群需要包含或等于待接管的 OBProxy 的可连接 OceanBase 集群。

• OCP 不允许在一个 OBProxy 集群中混合部署 V4.x 以前和 V4.x 以后版本的 OBProxy Server，因此要求：目标 OBProxy 集群中的 OBProxy 与待接管的 OBProxy 不能同时存在 V4.x 以前和 V4.x 以后的版本。

操作步骤

1. 登录 OCP，进入待接管的 OBProxy 集群概览页面。

2. 单击右上方 接管 OBProxy 按钮，进入到接管 OBProxy 页面。

3. 在 选择 OBProxy 所在主机 页面填充相关信息，总共分为如下三部分：

   • root@proxysys 密码（可选）：开关关闭时，OCP 会使用默认密码连接 OBProxy；开关打开时，不填充则默认为空密码，填充则会使用所填充的密码连接 OBProxy。填充后若无法连接 OBProxy，会在下一步接管前预检查时报错。

   • 主机信息：依次选择待接管的 OBProxy 的机房、机型、主机 IP、SQL 端口信息。

   • 负载均衡管理：若希望将待接管的 OBProxy 使用的 OBLB、SLB 实例录入到新的 OCP 中，则需要将对应的负载均衡实例信息填充在此处。也可以选择导入已有的负载均衡实例配置文件，文件来自在 OCP 迁出 OBProxy 集群 时导出的负载均衡实例数据文件。

     注意

     • 此处填写的信息仅表示录入已使用的负载均衡实例信息，而非新创建负载均衡实例。
     • 所录入的负载均衡实例对应的 OBProxy 应全部在此次待接管 OBProxy 范围中。

   

4. 信息录入完毕后，单击 下一步 进入到预检查结果展示页面。若预检查不通过，可以将光标悬停于 检查结果 列的 原因 上，查看检查不通过的原因。

   根据问题原因进行修复，修复后，单击 重新检查。当列表中所有 OBProxy 的预检查结果均为通过时，单击 全部接管 按钮。

   

5. 当待接管 OBProxy 与目标 OBProxy 集群参数不一致时，将无法进行接管，您需同意将待接管 OBProxy 参数修改为与目标 OBProxy 集群参数一致。

   单击 同意修改，并在弹出的对话框输入 confirm，即提交接管 OBProxy 任务。若有需要重启生效的参数，在接管过程中会重启 OBProxy。任务运行完毕后，代表 OBProxy 接管成功。

   

常见问题

Q：接管预检查时报错，报错内容为「无法获取 obproxy 可连接集群信息。当前 obproxy 自启动后是否还未访问过 OceanBase 集群？」

A：如报错信息所述，您需要通过当前报错的 OBProxy 连接 OceanBase 集群后，再重新进行预检查；此报错也能说明当前 OBProxy 还未被使用过，可以执行先删除后重建的操作。

Q：在准备目标 OBProxy 集群时，建立好了空集群，无法将一个 V4.x 的 OceanBase 集群添加到可连接 OceanBase 集群中，如何处理？

A：此报错是因为 OCP 进行了限制：空 OBProxy 集群不允许关联 V4.x 的可连接 OceanBase 集群。

此时您可以为空集群添加一个 V4.x 版本的 OBProxy，然后正常进行接管流程即可（即添加可连接 OceanBase 集群 > 接管 OBProxy）。接管流程结束后，若不需要则可删除最初临时添加的 OBProxy。

Q：接管预检查时报错，报错内容为「lb 实例 ip:port 所对应的 obproxy ip1,ip2,ip3 未全部包含在此次接管的范围中。」

A：此报错说明接管预检查时填写的负载均衡实例 ip:port 所对应的 OBProxy 并未全部在此次接管的范围中，此时可以考虑将负载均衡实例对应的 OBProxy 全部放在同一批次中进行接管，或接管时不填写该负载均衡实例信息（即不把该负载均衡实例录入到新 OCP 中）。