--- title: "通过白屏部署 OceanBase 集群 | OceanBase 文档中心" description: 通过白屏部署 OceanBase 集群 本文以 x86 架构的 CentOS Linux 7.9 镜像作为环境介绍如何使用 obd 白屏部署 OceanBase 数据库。 背景信息 obd 自 V2.0.0 起支持白屏部署 OceanBase 数据库及相关组件，如 OBAgent、ODP、OCP Express 等，… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*Qq8pT6yBPTcAAAAAAAAAAAAADiGDAQ/original) 安装部署工具 OBDV 2.7.0 社区版 # 通过白屏部署 OceanBase 集群 更新时间：2026-04-14 17:55:41 [编辑](https://github.com/oceanbase/obd-doc/edit/V2.7.0/zh-CN/200.quick-start/300.use-ui-deploy-oceanbase.md) 本文以 x86 架构的 CentOS Linux 7.9 镜像作为环境介绍如何使用 obd 白屏部署 OceanBase 数据库。 ## 背景信息 obd 自 V2.0.0 起支持白屏部署 OceanBase 数据库及相关组件，如 OBAgent、ODP、OCP Express 等，白屏界面配置简单，通过页面的引导配置即可完成单集群部署。 ## 名词介绍 - OceanBase 数据库 一款完全自研的企业级原生分布式数据库，详细信息请参见 [OceanBase 数据库文档](https://www.oceanbase.com/docs/oceanbase-database-cn)。 - ODP OceanBase Database Proxy，OceanBase 数据库代理，是 OceanBase 数据库专用的代理服务器，简称为 ODP（又称为 OBProxy）。详细信息请参见 [OceanBase 数据库代理文档](https://www.oceanbase.com/docs/odp-doc-cn)。 - OCP Express 基于 Web 的 OceanBase 数据库 4.x 管理工具，融合在 OceanBase 数据库集群中，支持对数据库集群关键性能及基本数据库管理功能。详细信息请参考 [OceanBase 云平台 Express (OCP Express)](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000818967)。 - OBAgent OBAgent 是 OceanBase 数据库监控采集框架，支持推、拉两种数据采集模式，可以满足不同的应用场景。 ## 前提条件 - 仅部署 OceanBase 数据库，至少需要 2vCPU、8 GB 内存、19 GB 磁盘的可用资源。 - 部署 OceanBase 数据库及全部组件，至少需要 4vCPU、10 GB 内存、25 GB 磁盘的可用资源，推荐内存在 16 GB 以上。 - 部署 OCP Express 组件需先安装配置 Java 环境，目前仅支持 JDK1.8 版本。详细操作可参考 [常见问题](https://www.oceanbase.com/docs/community-obd-cn-1000000000634890) 中 **部署 OCP Express 前如何配置 Java 环境**。 #### 注意 obd 是通过 SSH 远程执行安装部署，所以您需通过 SSH 验证 Java 环境是否可用，详细操作请参考 **Java 环境验证**。 ## 准备软件 使用 obd 白屏部署 OceanBase 数据库时，可以选择在线部署或离线部署两种部署方式。 - 在线部署：obd 所在机器需保证能访问外部网络，无需提前配置部署所需安装包，部署过程中 obd 会从远程镜像仓库获取部署所需安装包。 - 离线部署：部署过程中无需访问外部网络，您需提前将部署所需安装包上传至 obd 本地镜像库。选择离线部署时推荐直接下载所需版本的 all-in-one 安装包。 根据不同的部署方式有不同的准备软件方法，您可根据实际情况选择合适的方法准备软件。 ### 在线部署 当您选择在线部署时，可以参考本节命令在中控机上安装 obd。 ```shell [admin@test001 ~]$ sudo yum install -y yum-utils [admin@test001 ~]$ sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo [admin@test001 ~]$ sudo yum install -y ob-deploy [admin@test001 ~]$ source /etc/profile.d/obd.sh ``` ### 离线部署 当您选择离线部署时，可参考本节命令下载并安装 all-in-one 安装包。 您可从 [OceanBase 软件下载中心](https://www.oceanbase.com/softwarecenter) 下载最新的 all-in-one 安装包，并将其复制到中控机中。执行如下命令解压并安装： ```shell [admin@test001 ~]$ tar -xzf oceanbase-all-in-one-*.tar.gz [admin@test001 ~]$ cd oceanbase-all-in-one/bin/ [admin@test001 bin]$ ./install.sh [admin@test001 bin]$ source ~/.oceanbase-all-in-one/bin/env.sh ``` ## 操作步骤 1. 启动白屏界面 命令行执行 `obd web` 命令启动白屏界面，单击输出的地址访问白屏界面。 ```shell [admin@test001 ~]$ obd web start OBD WEB in 0.0.0.0:8680 please open http://10.10.10.1:8680 ``` #### 说明 - 白屏界面默认使用 8680 端口，您可使用 `obd web -p ` 命令指定端口。 - 在阿里云或其他云环境下，可能出现程序无法获取公网 IP，从而输出内网地址的情况，此 IP 非公网地址，您需要使用正确的地址访问白屏界面。 - `obd web` 命令绑定在 0.0.0.0 上，在多网卡部署的情况下，您可通过任意一个可访问的 IP 访问白屏界面。 鼠标放置到图形化操作界面右上角的 **中文** 字符处可根据显示的语种单击切换中英文界面。 ![语种切换](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.4.0/zh-CN/200.quick-start/300.deploy-ocp-by-ui-12.png) 在白屏界面中单击 **开启体验之旅**，在显示的 **欢迎使用 OceanBase 部署向导** 界面选择 **OceanBase 及配套工具** 模块，单击 **确定** 后进入 OceanBase 数据库部署界面。 2. 部署配置 **部署配置** 界面可以配置集群名称，部署类型和部署组件。 ![部署配置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.2.0/zh-CN/2.quick-start/3.use-ui-deploy-oceanbase-02.png) 其中： - **集群名称** 默认为 `myoceanbase`，支持自定义，不可和已有部署名重复。 - 默认部署全部组件，您可通过单击 **可选组件** 下对应组件前的勾选框设置是否部署对应组件。需注意，勾选 OCP Express 组件时会自动勾选 OBAgent 组件，取消勾选 OBAgent 组件时会自动取消勾选 OCP Express 组件。 - 单击对应组件后的 **了解更多** 可跳转查看对应组件的文档介绍。 - 部署所需组件时，您可单击 **版本** 下的下拉框自行选择 OceanBase 数据库的版本，其他组件版本固定为最新版本。 配置完成之后单击 **下一步** 可进入到 **节点配置** 页面。 3. 节点配置 **节点配置** 界面可以配置数据库和组件节点，部署用户以及软件安装路径。 ![节点配置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.1.0/zh-CN/2.quick-start/3.use-ui-deploy-oceanbase-03.png) 其中： - 数据库节点默认为三个 Zone，可通过单击 **+ 新增 Zone** 或尾部的删除图标新增或删除 Zone。 - **OCP Express 节点** 既可从下选框选择 OBServer 节点 IP，也可输入新的节点 IP，仅支持选择或输入一个节点。 - **OBProxy 节点** 既可通过下选框选择 OBServer 节点 IP，也可输入新的节点 IP，支持配置多个节点。 - **用户名** 默认为当前进程的启动用户，默认 SSH 端口为 22 端口，支持自定义用户和 SSH 端口。您需输入对应用户的密码，如各节点间已配置免密可免去输入密码。 - **软件路径** 默认为部署用户的家目录，可自定义修改。 配置完成之后单击 **下一步** 可进入到 **集群配置** 页面。 4. 集群配置 **集群配置** 界面可对集群进行配置，包括系统租户的管理员用户（root@sys）密码、数据和日志目录、数据库及各组件的端口和参数配置等。 ![集群配置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.1.0/zh-CN/2.quick-start/3.use-ui-deploy-oceanbase-04.png) 其中： - **模式配置** 可选择 **最大占用** 或 **最小可用**，**最大占用** 模式将最大化利用环境资源，保证集群的性能与稳定性，推荐使用；**最小可用** 模式配置满足集群正常运行的资源参数。两种模式的详细介绍可参考 [模式配置规则](https://www.oceanbase.com/docs/community-obd-cn-1000000000634883) 一文。 - **root@sys 密码** 默认为 obd 自动生成的随机字符串，可自定义设置。自定义设置时，密码复杂度需满足如下要求： - 长度为 8~32 位字符 - 包含以下四种类型字符中至少三种：数字（0~9）、大写字母（A~Z）、小写字母（a~z）和特殊字符（`~!@#%^&*_-+=|(){}[]:;,.?/`） - 集群的数据目录和日志目录默认在 **节点配置** 页面中配置的软件路径下，需为以 `/` 开头的绝对路径，支持自定义设置，但需确保设置的目录为空。 - 数据库和各组件的端口均为默认值，可自定义设置（仅支持 1024~65535 范围），需确保设置的端口未被占用。 - 单击打开 **更多配置** 按钮查看对应的集群或组件参数，可使用自动分配的值进行配置，也可自定义各个参数。 全部配置完成后，单击 **下一步** 即可进入到 **预检查** 页面。 5. 预检查 在 **预检查** 页面查看所有配置信息，若发现问题可单击 **上一步** 进行修改；确认无误后，单击 **预检查** 进行检查。 若预检查报错，您可根据页面建议选择 **自动修复** 或者单击 **了解更多方案** 跳转至错误码文档，参考文档自行修改。所有报错修改后，可单击 **重新检查** 再次进行预检查。 ![预检查](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.1.0/zh-CN/2.quick-start/3.use-ui-deploy-oceanbase-05.png) 6. 部署 预检查通过后，单击 **部署** 即可开始 OceanBase 数据库的部署。 ![部署](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.1.0/zh-CN/2.quick-start/3.use-ui-deploy-oceanbase-06.png) 其中： - 部署成功后可复制显示的连接串，在黑屏界面执行连接 OceanBase 数据库。 - 单击输出的 OCP Express 组件的连接串可跳转到 OCP Express 的登录界面，通过部署界面展示的账号密码登录并修改密码后可使用白屏界面管理集群。 #### 说明 在阿里云或其他云环境下，可能出现程序无法获取公网 IP，从而输出内网地址的情况，此 IP 非公网地址，您需要使用正确的地址访问白屏界面。 - 在 **部署报告** 里单击对应组件前的展开图标即可在白屏页面查看部署的日志信息。 - 在 **部署报告** 里单击对应组件列表里的 **查看详情** 后，单击对应命令后的复制图标即可复制命令在中控机中执行查看对应组件的日志位置。 7. 单击 **完成**，结束部署 #### 注意 如需部署多个集群，您需在白屏界面单击 **完成** 结束当前 obd 进程后才可再次执行 `obd web` 命令进行下一集群的部署。 ## 相关操作 ### Java 环境验证 由于 obd 是通过远程执行脚本部署 OCP Express，所以需要通过 SSH 方式验证 Java 环境，直接在机器上执行 `java -version` 可能无效。 #### 说明 使用终端交互会自动初始化环境变量，SSH 方式访问不会初始化环境变量，会导致使用 SSH 执行命令时出现 Java 命令不存在或使用错误 Java 版本的情况。 您可在任意一台网络与 OCP Express 所在节点连通的机器上执行如下命令进行验证。 ```shell # ocp_express_node_username：ocp_express 所在节点的用户名 # ocp_express_node_ip：ocp_express 所在节点 IP [admin@test001 ~]$ ssh @ 'java -version' # 输出结果 openjdk version "1.8.0_xxx" OpenJDK Runtime Environment (build 1.8.0_362-b08) OpenJDK 64-Bit Server VM (build 25.362-b08, mixed mode) ``` 如您已安装符合条件的 Java 但是验证却没有通过，可以通过以下任一方法解决： - 方法一：通过组件页面 **更多配置** 配置 **java_bin** 路径 如下图，在配置项 `java_bin` 中配置 Java 的真实路径，如 `/jdk8/bin/java`。 ![更多配置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.1.0/zh-CN/2.quick-start/3.use-ui-deploy-oceanbase-07.png) - 方法二：将 Java 可执行文件软链接到 `/usr/bin/java` 中 ```shell [admin@test001 bin]$ pwd /jdk8/bin [admin@test001 bin]$ ln -s /jdk8/bin/java /usr/bin/java ``` ### 管理部署后的集群 您可执行如下命令对 obd 部署的集群进行管理。更多操作详见 [集群命令组](https://www.oceanbase.com/docs/community-obd-cn-1000000000634909)。 ```shell # 查看集群列表 [admin@test001 ~]$ obd cluster list # 查看集群状态，以部署名为 myoceanbase 为例 [admin@test001 ~]$ obd cluster display myoceanbase # 停止运行中的集群，以部署名为 myoceanbase 为例 [admin@test001 ~]$ obd cluster stop myoceanbase # 销毁已部署的集群，以部署名为 myoceanbase 为例 [admin@test001 ~]$ obd cluster destroy myoceanbase ``` ### 部署特定版本组件 使用 all-in-one 安装包部署时，all-in-one 的包是基于 OceanBase 版本进行迭代，若包中有其他组件存在更新版本，您可从 [OceanBase 软件下载中心](https://www.oceanbase.com/softwarecenter) 下载最新版本的组件，参考如下步骤将其上传至本地镜像库，obd 部署时会自动获取本地镜像库中的最新版本。 1. 进到组件安装包所在目录下，将安装包添加至本地镜像库 ```shell [admin@test001 rpm]$ obd mirror clone *.rpm ``` 2. 查看本地镜像库中安装包列表 ```shell [admin@test001 rpm]$ obd mirror list local ``` 上一篇 下一篇 ![有帮助](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) 咨询热线