---
title: "OCP 多集群模式开关 | OceanBase 文档中心"
description: OCP 多集群模式开关 本节介绍如何将标准模式的 OCP 改造为多集群模式的主备集群。 前提条件 已安装好 V3.1.1 及以上版本的 OCP 集群。 注意 OCP 所管理的 OceanBase 集群中，不能存在同名的 OceanBase 集群，否则备 OCP 集群将无法成功注册到主 OCP 集群。 操作步骤 执行 …
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.0.3 企业版

# OCP 多集群模式开关

更新时间：2024-02-27 11:16:53

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

## 前提条件

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

#### 注意

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

## 操作步骤

1. 执行 `docker exec -it ocp bash` 命令进入 OCP 容器。
 2. 执行 `env | grep -i metadb` 命令检查是否已设置了如下环境变量。

   ```SQL
   OCP_METADB_HOST
   OCP_METADB_PORT
   OCP_METADB_USER
   OCP_METADB_PASSWORD
   OCP_METADB_DBNAME

   ```

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

   ```SQL
   #以下变量值均为示例，请根据实际情况设置。
   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"

   ```
 3. 执行 `cd /home/admin/ocp-server/bin` 命令进入 `ocp-bootstrap` 脚本所在目录。
 4. 执行 `./ocp-bootstrap -i`，进入交互模式。
 5. 根据实际场景选择以下命令中的一条进行执行，改造 OCP。

      - 在目标 OCP 上执行 `enableMc <OCP_CLUSTER_ID> <OCP_CLUSTER_NAME> <OCP_CLUSTER_ROLE>`，改造目标 OCP 为主 OCP 集群。

       ```shell
       ocp-bootstrap> enableMc 1 ocp1 LEADER

       ```
      - 在目标 OCP 上执行，改造目标 OCP 为备 OCP 集群。

       ```shell
       ocp-bootstrap> enableMc 2 ocp2 FOLLOWER

       ```
      - Failover 之后，在原主 OCP 上执行如下命令，使原主 OCP 恢复到能注册到新主 OCP 的状态。

       ```shell
       ocp-bootstrap> unregisterMc

       ```
 6. 在 OCP 宿主机上执行 `docker restart ocp` 命令重启 OCP。

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

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线