OCP 多集群模式开关 - 云平台 OCP V4.2.2

OCP 多集群模式开关

更新时间：2026-04-14 15:15:57

编辑

本节介绍如何将标准模式的 OCP 改造为多集群模式的主备集群。

功能适用性

该内容仅适用于 OCP 企业版，OCP 社区版不提供此功能。

前提条件

已安装好 V3.1.1 及以上版本的 OCP 集群。

注意

OCP 所管理的 OceanBase 集群中，不能存在同名的 OceanBase 集群，否则备 OCP 集群将无法成功注册到主 OCP 集群。

操作步骤

执行 docker exec -it ocp bash 命令进入 OCP 容器。

执行 env | grep -i metadb 命令检查是否已设置了如下环境变量。

OCP_METADB_HOST
OCP_METADB_PORT
OCP_METADB_USER
OCP_METADB_PASSWORD
OCP_METADB_DBNAME

若未设置，请执行如下命令设置 MetaDB 的环境变量。

#以下变量值均为示例，请根据实际情况设置。
export OCP_METADB_HOST="xxx.xxx.xxx.xxx"
export OCP_METADB_PORT="2881"
export OCP_METADB_USER="ocp@ocp_meta"
export OCP_METADB_PASSWORD="******"
export OCP_METADB_DBNAME="meta_01"

执行 cd /home/admin/ocp-server/bin 命令进入 ocp-bootstrap 脚本所在目录。
执行 ./ocp-bootstrap -i，进入交互模式。
根据实际场景选择以下命令中的一条进行执行，改造 OCP。
- 在目标 OCP 上执行 enableMc <OCP_CLUSTER_ID> <OCP_CLUSTER_NAME> <OCP_CLUSTER_ROLE>，改造目标 OCP 为主 OCP 集群。
```
ocp-bootstrap> enableMc 1 ocp1 LEADER
```
- 在目标 OCP 上执行，改造目标 OCP 为备 OCP 集群。
```
ocp-bootstrap> enableMc 2 ocp2 FOLLOWER
```
- Failover 之后，在原主 OCP 上执行如下命令，使原主 OCP 恢复到能注册到新主 OCP 的状态。
```
ocp-bootstrap> unregisterMc
```
在 OCP 宿主机上执行 docker restart ocp 命令重启 OCP。

如果该 OCP 集群部署了多个 OCP 实例，需要全部重启。