首批通过分布式安全可靠测评,为关键业务系统打造
新建集群
更新时间:2025-03-11 10:20:54
您可以根据业务需要新建待管理的分布式主备集群。
功能适用性
OCP 社区版仅支持新建主集群。
前提条件
当前登录 OCP 的用户有 Create Cluster 的权限。
(可选)如您创建的是多副本 OceanBase 集群,则需当前 OCP 中已存在可用的 OBProxy 集群,您可参考如下链接新增 OBProxy 集群。
只有运行中的主集群才能新建备集群,且要求 OceanBase 版本为 V2.2.50 及以上、V4.0.0 以下。
操作步骤
登录 OCP 后,根据实际业务场景,找到新建集群的入口。
如果您没有可管理的集群,系统会在 集群 页面提示您新建集群,直接在提示信息中单击 创建集群 。
如果您已经有可管理的集群,则在 集群 页面右上角,单击 新建集群 。
在 新建集群 页面,选择 分布式集群 模式。
设置集群的基础信息。
创建主集群

基础信息填写说明如下表所示。
配置 描述 集群类型 选择 主集群 。 集群名称 自定义待管理的集群的名称。集群名称必须以以英文字母开头、英文或数字结尾,可包含英文、数字和下划线,且长度为 2 ~ 32 个字符。 root@sys 密码 支持自定义或随机生成。 密码需要满足以下复杂度条件: - 长度为 8~32 个字符
- 支持字母、数字和特殊字符,且至少包含大、小写字母、数字和特殊字符各 2 个
- 支持的特殊字符为 ~!@#%^&*_-+=`|(){}[]:;',.?/
OceanBase 版本 可以从列表中选择已有的 OceanBase 集群版本,也可以在列表下方单击 添加版本 ,上传一个 OceanBase 的版本。 关联 OBProxy 集群 如您创建的是多副本的 OceanBase 集群,建议您打开关联 OBProxy 集群开关,为该 OceanBase 集群关联 OBProxy 集群。 关联后您的业务涉及的 SQL 请求将会被精准转发到相应的副本,使您对 OceanBase 数据库的访问效果能够媲美访问单机数据库。
1. 默认使用 proxyro 用户关联,您无需填写用户名和密码。
2. 在下拉框中选择要关联的 OBProxy 集群。如下拉框中没有可关联的 OBProxy 集群,请参考本文 前提条件 中的描述添加 OBProxy 集群。注意
当 OceanBase 版本 中选择的集群为 V4.0 及以上版本时,仅支持关联 V4.0.0 及以上版本的 OBProxy 集群。创建备集群

基础信息填写说明如下标所示:
配置 描述 集群类型 选择 备集群。 主集群 选择主集群,系统将创建属于该主集群的备集群。 备集群 OceanBase 版本 选择与主集群相同的 OceanBase 版本。 - 若列表中有该版本,则从列表中直接选择。
- 否则,可通过单击列表下方的 添加版本 来上传。
设置集群的部署模式信息。
默认添加 3 个 Zone 的信息,如果您希望部署的集群 Zone 的个数大于 3 个,您可以在下方单击 新增 按钮,增加 Zone 信息。如果部署的集群 Zone 的个数小于 3 个,您可以单击 Zone 后面的删除图标。

每个 Zone 需要设置的信息及其说明如下表所示。
配置 描述 Zone 名称 可保持默认也可自定义。 Zone 名称必须以英文字母开头,支持大小写字母、数字和下划线,长度为 2~48。 部署多 Zone 的 OceanBase 集群必须有一个 Zone 与主 Zone 的 Region 相同。 机房 Zone 所在的机房,一个 Zone 只能存在于一个机房。 机型 可选项。如果选择了机型,后面主机列表会根据机型进行过滤。 CPU 架构 当选择的 OceanBase 版本 中存在多个不同架构的安装包时,需选择匹配此软件包的主机硬件架构。 注意
- 默认架构类型为第一个安装包的架构类型,支持切换。切换指定架构后,主机 列表中即展示该架构的主机。
- 若为不同的 Zone 设置不同的架构时,混合架构部署模式可能存在稳定性与性能问题,请谨慎操作。
主机 您可以选择多个主机,或进行添加主机的操作。 Root Service 位置 您需选择一个 IP 作为 Root Service 所在的机器。多副本的 OceanBase 集群,其每个 Zone 都需指定一个 root Server。 Zone 优先级排序 (创建备集群无需配置) 选择是否为集群 sys 租户的主副本分布指定优先级。 - 如指定,最高优先级的 Zone 会被视为 Primary Zone,且只能有一个。 排序方法如下:
1. 勾选左侧列表框中的一个或多个 Zone。 左侧列表框中显示了当前集群中所有可选的 Zone。
2. 单击中间的 > 按钮。 此时勾选的 Zone 就会被移动到 Zone 优先级排序 列表中。同时勾选的多个 Zone 具有相同的优先级。
3. 重复 a、b 动作,添加低一优先级的 Zone。
4. 如需调整优先级,可在 Zone 优先级排序 列表中拖拽以调整顺序。 列表中从上到下,优先级依次递减。 - 如不指定,则以第一个 Zone 为第一优先级。
添加仲裁服务 选择是否为集群添加仲裁服务。您可在服务下拉列表中选择需要添加的服务,或单击 添加服务 为集群新创建仲裁服务,详情参见添加仲裁服务。 说明
仅支持为 V4.1.0 及以上版本的主集群添加仲裁服务。打开 参数设置 模块,并配置集群参数。
您可通过如图 ① 处,逐个添加启动参数项并为其配置值。
也可通过如图 ② 处,单击 选择参数模板 ,然后选择一个参数模板,系统会将模板中的参数连同配置自动填充到此处。
说明
- 当 OceanBase 版本为 V2.2.77 时,推荐您使用系统内置的 2.2.77 Version Parameter Template 参数模板。模板中包含了 OceanBase V2.2.77 的常用参数设置,您可直接应用该模板进行集群的初始化设置。
- 在未创建集群参数模板的情况下,您可单击 新建集群模板,为集群创建参数模板,详情可参考 集群参数模板管理。

打开 自定义配置,对操作系统所属主用户、路径及端口进行配置 。
配置操作系统所属主用户:
该用户为配置安装、运行 OBServer 的操作系统用户,不支持编辑。您可参考 修改系统参数 ,通过调整
ocp.operation.default.os.user参数的默认配置来修改用户。说明
当您对ocp.operation.default.os.user参数进行修改后,该参数的修改仅对创建分布式集群、创建 OBProxy 集群 和 创建仲裁服务 时产生影响,不影响已有集群的其他配置。配置相关路径:
配置 描述 软件安装路径 - 当 操作系统所属主用户 为 admin 时,软件安装路径 默认为
/home/admin/oceanbase,支持自定义路径。 - 当 操作系统所属主用户 为非 admin 时,软件安装路径 默认为
/opt/oceanbase/oceanbase,支持自定义路径。
数据盘路径 默认为 /data/1,支持自定义路径。Exporter 端口 默认为 /data/log1,支持自定义路径。配置完成后,单击 测试,校验路径是否可用。若不可用,您可根据测试结果进行排查,或将路径修改为其它可用路径。

- 当 操作系统所属主用户 为 admin 时,软件安装路径 默认为
配置端口:
配置 描述 SQL 端口 默认为 2881,支持自定义端口。 Exporter 端口 默认为 2882,支持自定义端口。 配置完成后,单击 测试,校验端口是否已被占用。若被占用,您需重新配置可用端口。

测试成功后,单击 提交 。
在弹出的 确认提交信息 对话框中,确认信息无误后,单击 确定 。
您可在 系统管理 > 任务 中查看该任务的执行进度。