首批通过分布式安全可靠测评，为关键业务系统打造
创建、升级和卸载 MetaDB
更新时间：2026-04-13 16:30:39
分享
本文介绍如何使用 OAT 创建、升级和卸载 MetaDB。
前提条件
在创建 MetaDB 之前，您需要确认以下信息：
安装 MetaDB
按照以下步骤安装 MetaDB：
在左侧导航栏，单击 产品服务 > 组件。
在 组件管理 页面，单击右上角的 创建组件，选择 创建 MetaDB。
在 创建 MetaDB 页面，配置各项参数。
MetaDB 基础配置参数如下：
参数 说明 MetaDB 镜像 MetaDB 的 Docker 镜像 组件名称 组件的名称。不允许与其他组件重名。默认名称为 metadb服务器 待安装 MetaDB 的服务器 IP 地址 自定义 Zone 开启自定义 Zone，需要填写 Zone 名称、机房、服务器、Root Server 位置。 注意
此参数与服务器参数二选一，当打开自定义 Zone 后，上述服务器参数会自动隐藏。
配置仲裁服务 可自由开启或者关闭，开启时需要填写仲裁服务地址，示例： xxx.xxx.xxx.xxx:xxxx。注意
当 MetaDB 镜像处选择 V4.X 版本的 MetaDB 时，才能配置仲裁服务。
CPU MetaDB 在服务器上可用的 CPU，默认为 32C 内存 MetaDB 在服务器上可用的内存，默认为 90G MetaDB 集群的名称 MetaDB 的集群名称 root@sys 密码 sys 租户的 root 用户密码 日志目录 MetaDB 的日志存储路径 MetaDB 的安装路径配置参数如下：
参数 说明 安装目录 MetaDB 的安装路径，默认值为 /home/admin/oceanbase数据目录 MetaDB 的数据存储路径，默认值为 /data/1日志目录 MetaDB 的日志存储路径，默认值为 /data/log/1（可选）备份目录 MetaDB 的备份路径，，默认值为空 MetaDB 的启动参数配置参数如下：
参数 说明 MySQL 端口 MetaDB 的 MySQL 端口，默认值为 2881 RPC 端口 MetaDB 的 RPC 端口，默认值为 2882 OB Proxy 服务端口 OB Proxy 的服务端口，默认值为 2883 SSHD 端口 MetaDB 容器内的 SSHD 端口，默认值为 2022。OCP 通过连接 SSHD 端口部署 OCP Agent root 密码 MetaDB 容器内的 root 用户密码 说明
您可以根据需要，修改或添加 MetaDB 和 OBProxy 的启动参数。更多信息，参考 ODP 参数说明。
MetaDB 配置完成后，点击 提交。
如果您的配置有误，点击 重置 一键恢复默认配置。
升级 MetaDB
注意
- 只支持 V4.x 的 MetaDB 进行白屏升级。
- 发起升级任务前，通过 OCP 完成合并和数据备份。
按以下步骤 升级 MetaDB：
在左侧导航栏，单击 产品服务 > 组件。
在 组件管理 页面，单击上方 MetaDB。
找到待升级的 MetaDB 服务，在对应的 名称 列中，单击组件名称进入 MetaDB详情 页面。
说明
支持名称检索，您可以在页面上方通过组件名称搜索查询。
在 MetaDB详情 页面，单击右上角的 升级。
在弹出的 升级 对话框中，填写相关信息。
相关字段说明如下：
字段 描述 升级方式 系统默认选择升级方式。 说明
- MetaDB 服务部署架构如果是单节点，升级方式只显示停服升级。
- MetaDB 服务部署架构如果是多节点，升级方式只显示滚动升级。
请选择升级的镜像文件 单击请选择或下拉图标选择 升级目标镜像文件。 已通过 OCP 完成合并/已通过 OCP 完成数据备份 只有勾选了 已通过 OCP 完成合并 和 已通过 OCP 完成数据备份 之后才能发起升级。 单击右下角 确认。
卸载 MetaDB
按以下步骤 卸载 MetaDB：
在左侧导航栏，单击 产品服务 > 组件。
找到待卸载的 MetaDB 服务，在对应的 操作 列中，单击 卸载。
说明
支持名称检索，您可以在页面上方通过组件名称搜索查询。
在弹出的确认框中，单击 卸载。
OAT 会提示正在卸载中。同时，OAT 还会创建一个卸载任务，您可以在弹出的确认框中单击任务 ID，查看当前卸载任务的执行进度。
注意
如果待卸载的 MetaDB 与其他产品关联，卸载将失败。
后续操作
安装 MetaDB 后，您可以安装 OceanBase 的生态产品。
