部署 OceanBase

OceanBase 是一款原生分布式关系型数据库，兼容 MySQL，支持金融级高可用、透明水平扩展、分布式事务和多租户等企业级特性。详细信息请参见 OceanBase 概述。

本文将引导您完成 OceanBase 数据库的部署，并成功连接数据库执行 SQL 验证。根据您的操作系统，选择下方适合的部署方式即可开始。完成本文操作后，您将获得一个可用的 OceanBase 数据库实例，并能够使用 obclient 连接执行 SQL 语句。

前提条件

在开始安装 OceanBase 数据库之前，请确保您的软硬件环境满足以下要求：

选择部署方式

以下部署方法适用于使用单台机器快速搭建 OceanBase 数据库环境。部署的数据库具备基本功能，可以帮助您快速了解 OceanBase 数据库，但无法体验高可用、水平扩展等分布式特性，不建议长期使用。

您可以使用以下几种方法快速体验 OceanBase 数据库。请根据您的操作系统和使用场景选择合适的方式：

下文命令行示例中，行首的 $ 表示以普通用户身份执行命令，# 表示以 root 用户身份执行命令（含 Docker 容器内的 root 环境），提示符本身无需输入。

方式一：使用 All in One 安装包（推荐）

使用 All in One 安装包将一键部署以下组件：

• obd：OceanBase 安装部署工具（OceanBase Deployer）。详细信息请参见 obd。
• ODP：OceanBase 数据库代理（又称为 OBProxy）。详细信息请参见 OceanBase 数据库代理（ODP）。
• obshell：OceanBase 数据库管控工具，提供 obshell Dashboard 白屏管控页面（部署输出中会给出访问地址和登录密码）。
• OBAgent：监控采集框架，支持推、拉两种数据采集模式。
• Grafana：数据可视化工具。详细信息请参见 Grafana 官网。
• Prometheus：监控系统和时序数据库。详细信息请参见 Prometheus 官网。

执行以下命令下载并安装 OceanBase All in One，该命令将在线下载并安装最新版本的 OceanBase All in One 包。

$ bash -c "$(curl -s https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/download-center/opensource/oceanbase-all-in-one/installer.sh)"
$ source ~/.oceanbase-all-in-one/bin/env.sh

其中 source 命令用于加载环境变量，执行后即可在当前终端直接使用 obd、obclient 等命令。

执行以下命令，将以最小规格部署并启动单节点的 OceanBase 数据库及相关组件（直接使用当前账号部署）：

$ obd demo

命令执行过程中会输出各组件的下载与启动进度，耗时与网络环境相关，请耐心等待。部署成功后，命令末尾会输出各组件的部署信息与连接方式，关键输出如下（版本号、密码等信息以实际环境为准）：

Wait for observer init ok
+---------------------------------------------+
|                 oceanbase-ce                |
+-----------+---------+------+-------+--------+
| ip        | version | port | zone  | status |
+-----------+---------+------+-------+--------+
| 127.0.0.1 | 5.0.1.0 | 2881 | zone1 | ACTIVE |
+-----------+---------+------+-------+--------+
obclient -h127.0.0.1 -P2881 -uroot@sys -p'qKxxxxxxxxxxxxxxxxxx' -Doceanbase -A
...
demo running

当输出中出现 demo running，且 oceanbase-ce 组件的状态为 ACTIVE 时，表示部署成功。输出中以 obclient 开头的一行即为数据库连接命令，其中 -p 后即为系统为 sys 租户 root 用户随机生成的登录密码，请妥善保存。

连接数据库

obclient 是 OceanBase 数据库的命令行客户端，使用方式与 MySQL 客户端一致。obd demo/obd perf 命令执行成功后会输出部署组件的连接方式，您可复制并执行输出中的连接串，使用 root 用户登录集群的 sys 租户。默认连接命令如下：

$ obclient -h127.0.0.1 -uroot@sys -P2881 -p -A oceanbase

连接命令中的参数说明如下：

sys 租户 root 用户的密码在部署完成时由系统随机生成，可在部署输出中 obclient 连接命令的 -p 参数处查看。如部署完成后忘记密码，可执行以下命令，在输出的连接命令中查看：

$ obd cluster display demo

连接成功后，返回信息示例如下（连接 ID、版本号等信息以实际环境为准）：

Enter password:
Welcome to the OceanBase.  Commands end with ; or \g.
Your OceanBase connection id is 3221225985
Server version: OceanBase 5.0.1.0 (r100000042026072711-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx) (Built Jul 27 2026 11:00:00)

Copyright (c) 2000, 2018, OceanBase and/or its affiliates. All rights reserved.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

obclient [oceanbase]>

登录集群后可执行 SQL 语句进行简单的功能体验，具体可参见 SQL 基础操作（MySQL 模式）。

离线安装（可选）

$ tar -xzf oceanbase-all-in-one-*.tar.gz
$ cd oceanbase-all-in-one/bin/
$ ./install.sh
$ source ~/.oceanbase-all-in-one/bin/env.sh

离线安装完成后，同样使用 obd demo 或 obd perf 命令进行部署。详细步骤请参见 使用命令行部署 OceanBase 数据库生产环境 中的"离线安装"部分。

后续管理：启动与停止

部署完成后，您可以通过 obd 集群命令管理 OceanBase 数据库及组件（如查看集群状态、启动、停止、销毁集群等），obd demo 命令的固定部署名为 demo。详细命令说明请参见 obd 文档 集群命令组；如需清理已部署的集群，具体操作可参见 清理旧集群。

方式二：使用 RPM 包

使用 systemd 命令部署

$ sudo bash -c "$(curl -s https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/download-center/opensource/service/installer.sh)"

以上为快速体验命令，将 在线下载 最新 LTS 版本的 RPM 包并直接使用 root 账号进行安装，后续可以通过 systemctl 命令管理 OceanBase 数据库。详细配置及离线安装步骤请参见 使用 systemd 部署 OceanBase 数据库。

安装脚本执行完成后，OceanBase 数据库会注册为 systemd 服务并自动启动，服务启动需要一段时间，可执行 sudo systemctl status oceanbase 查看服务状态，显示 active (running) 即表示启动成功。脚本最后若提示服务启动失败，可执行 sudo journalctl -u oceanbase 查看详细日志，若日志中出现 OB_NO_SUCH_FILE_OR_DIRECTORY 相关报错，通常为默认数据目录（/var/lib/oceanbase）缺失导致，可执行以下命令创建数据目录并修改属主后重新启动：

$ sudo mkdir -p /var/lib/oceanbase/data /var/lib/oceanbase/redo
$ sudo chown -R admin:admin /var/lib/oceanbase
$ sudo systemctl start oceanbase

连接数据库

若机器上尚未安装 obclient（OceanBase 数据库命令行客户端，使用方式与 MySQL 客户端一致），可配置 yum 源后执行 sudo yum install obclient 安装，或前往 OceanBase 软件下载中心 下载对应版本的安装包进行安装。

命令执行成功后会输出 OceanBase 数据库的连接方式，您可复制并执行输出的连接串，使用 root 用户登录集群的 sys 租户。默认连接命令如下：

$ obclient -h127.0.0.1 -uroot@sys -P2881 -p -A oceanbase

sys 租户 root 用户默认密码为空，提示输入密码时直接回车即可登录。连接命令的参数说明及连接成功后的返回信息示例请参见方式一中的"连接数据库"。

后续管理：启动与停止

通过上述安装脚本安装的 OceanBase 数据库会注册为 systemd 服务，可通过 systemctl 命令进行管理，目前支持启动（start）、停止（stop）以及查看状态（status）操作。详细操作及各状态的含义说明请参见 使用 systemd 部署 OceanBase 数据库 中的"管理 OceanBase 数据库"部分。

手动部署（可选）：自定义目录与启动参数

步骤 1：安装 RPM 包

从 OceanBase 软件下载中心 下载所需版本的 OceanBase 数据库 RPM 包并上传到目标机器，在 RPM 包所在目录执行以下命令安装（请将文件名替换为实际下载的安装包版本）：

$ sudo rpm -ivh oceanbase-5.0.1.0-100000042026072711.el7.x86_64.rpm

安装完成后，OceanBase 数据库的安装目录为 /home/admin/oceanbase，可执行文件为 /home/admin/oceanbase/bin/observer。

步骤 2：初始化数据目录

依次创建数据目录、日志目录和集群数据目录：

$ sudo mkdir -p /data/1/ob_test/{etc3,sstable,slog}
$ sudo mkdir -p /data/log1/ob_test/{clog,etc2}
$ sudo mkdir -p /home/admin/oceanbase/store/ob_test

其中 ob_test 为以集群名命名的目录，可自定义，启动 observer 进程时通过 -d 参数指定。

切换到 root 用户，将上述目录的属主和属组修改为 admin：

$ sudo -i

# cd /data/1/
# chown -R admin:admin ob_test

# cd /data/log1/
# chown -R admin:admin ob_test

# cd /home/admin/oceanbase/
# chown -R admin:admin store

保持 root 用户，为各目录创建软链接：

# for t in {etc3,sstable,slog}; do ln -s /data/1/ob_test/$t /home/admin/oceanbase/store/ob_test/$t; done
# for t in {clog,etc2}; do ln -s /data/log1/ob_test/$t /home/admin/oceanbase/store/ob_test/$t; done

执行以下命令检查目录结构：

# tree /home/admin/oceanbase/store/

返回结果示例如下，5 个子目录均已软链接至对应的数据目录与日志目录，表示目录初始化完成：

/home/admin/oceanbase/store/
└── ob_test
    ├── clog -> /data/log1/ob_test/clog
    ├── etc2 -> /data/log1/ob_test/etc2
    ├── etc3 -> /data/1/ob_test/etc3
    ├── slog -> /data/1/ob_test/slog
    └── sstable -> /data/1/ob_test/sstable

6 directories, 0 files

步骤 3：启动 observer 进程

observer 进程的常用启动参数如下：

执行 ifconfig 命令确认网卡名称和业务 IP：

# ifconfig

返回结果示例如下：

eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 10.10.10.1  netmask 255.255.252.0  broadcast 10.10.155.255
        ...
lo: flags=73<UP,LOOPBACK,RUNNING>  mtu 65536
        inet 127.0.0.1  netmask 255.0.0.0
        ...

如果机器存在多个网卡，-I 参数需使用业务 IP 所在网卡对应的地址，回环地址（127.0.0.1）和容器网卡（如 docker0）不可用。

切换到 admin 用户并启动 observer 进程（root 用户切换到 admin 用户无需输入密码）。以下命令以 8C 32G 规格为例，需确保机器内存不低于 32 GB，数据盘、日志盘可用空间分别不低于 100 GB、50 GB（前提条件中的最低资源要求仅适用于 obd demo、Docker MINI 等快速体验部署）；-I 和 -r 中的 IP 需替换为上一步查到的业务 IP：

# su - admin

$ cd /home/admin/oceanbase && /home/admin/oceanbase/bin/observer -I 10.10.10.1 -P 2882 -p 2881 -z zone1 -d /home/admin/oceanbase/store/ob_test -r 10.10.10.1:2882:2881 -c 10001 -n ob_test -o "cpu_count=8,memory_limit=32G,system_memory=8G,datafile_size=100G,log_disk_size=50G,__min_full_resource_pool_memory=1073741824,resource_hard_limit=100,config_additional_dir=/data/1/ob_test/etc3;/data/log1/ob_test/etc2"

命令执行完成后，返回信息如下：

local_ip: 10.10.10.1
rpc port: 2882
mysql port: 2881
zone: zone1
data_dir: /home/admin/oceanbase/store/ob_test
rs list: 10.10.10.1:2882:2881
cluster id: 10001
appname: ob_test

命令执行完成后，observer 进程已在后台启动。

-o 参数中的关键启动参数说明如下：

执行以下命令确认 observer 进程已正常启动：

$ ps -ef | grep observer

返回结果示例如下（具体进程号以实际环境为准）：

admin     31578      1 28 17:11 ?        00:00:47 /home/admin/oceanbase/bin/observer -I 10.10.10.1 -P 2882 -p 2881 -z zone1 -d /home/admin/oceanbase/store/ob_test -r 10.10.10.1:2882:2881 -c 10001 -n ob_test -o cpu_count=8,memory_limit=32G,...

确认进程的启动用户为 admin，且命令行参数与启动时指定的一致。

执行以下命令确认版本与所安装的 RPM 包版本一致：

$ /home/admin/oceanbase/bin/observer -V

返回结果中的版本号（如 5.0.1.0）即为当前 observer 的版本。

步骤 4：初始化集群（Bootstrap）

进程启动后，等待约 1 分钟待进程初始化完成，再使用 obclient 连接本节点（若未安装 obclient，安装方式可参见本方式“连接数据库”小节；sys 租户的 root 用户默认密码为空，提示输入密码时直接回车即可登录，若连接过早可能报错，稍等后重试即可）：

$ obclient -h127.0.0.1 -uroot -P2881 -p

返回结果示例如下（连接 ID、版本号等信息以实际环境为准）：

Enter password:
Welcome to the OceanBase.  Commands end with ; or \g.
Your OceanBase connection id is 3221225985
Server version: OceanBase 5.0.1.0 (r100000042026072711-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx) (Built Jul 27 2026 11:00:00)

Copyright (c) 2000, 2018, OceanBase and/or its affiliates. All rights reserved.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

obclient [(none)]>

执行以下语句初始化集群（单节点部署，SERVER 中为本机业务 IP 与 RPC 端口）：

obclient [(none)]> ALTER SYSTEM BOOTSTRAP ZONE 'zone1' SERVER '10.10.10.1:2882';

返回结果为 Query OK, 0 rows affected（实际耗时与机器性能相关）。

执行以下语句验证集群初始化成功：

obclient [(none)]> SHOW DATABASES;

返回结果示例如下，能看到 oceanbase 数据库即表示集群初始化成功：

+--------------------+
| Database           |
+--------------------+
| information_schema |
| LBACSYS            |
| mysql              |
| oceanbase          |
| ORAAUDITOR         |
| SYS                |
| sys_external_tbs   |
| test               |
+--------------------+
8 rows in set

方式三：使用 Docker 快速体验

对于非原生支持的操作系统（比如 macOS 和 Windows）的快速体验场景，建议使用 Docker 镜像的方式进行部署。详细操作步骤请参见 部署 OceanBase 数据库容器环境。

启动 OceanBase 容器

若本地不存在 OceanBase 数据库镜像，执行启动命令时将自动从 Docker Hub 拉取最新镜像；您也可以先执行以下命令提前拉取镜像：

$ sudo docker pull oceanbase/oceanbase-ce

运行如下命令，启动 OceanBase 数据库实例：

$ sudo docker run -p 2881:2881 -p 2886:2886 -v $PWD/ob:/root/ob -v $PWD/obd/cluster:/root/.obd/cluster --name obstandalone -e MODE=MINI -d oceanbase/oceanbase-ce

命令执行成功后会返回一串容器 ID（64 位十六进制字符串），此时容器已在后台启动，但 OceanBase 数据库仍在初始化中。

• -p：用于将容器的端口映射到宿主机端口，示例中是将容器中的 2881 和 2886 端口分别映射到宿主机的 2881 和 2886 端口。
• -v：用于在容器与宿主机之间共享文件或目录，实现数据持久化。默认情况下，系统会在容器的 /root/ob 目录下部署 OceanBase 数据库，并在 /root/.obd/cluster 下保存其配置。
• --name：用于设置 Docker 容器名称。
• -e：用于设置环境变量，其中 MODE 用于设置启动模式，OB_TENANT_PASSWORD 用于设置 root@test 用户密码。

启动预计需要 2~5 分钟。执行以下命令，如果返回 boot success!，则表示启动成功：

$ sudo docker logs obstandalone | tail -1

返回结果示例如下：

boot success!

连接数据库

oceanbase-ce 镜像安装了 obd 和 OBClient。您可选择进入容器使用 OBClient 连接实例，也可使用宿主机本地 OBClient 或 MySQL 客户端连接。

进入容器后连接（执行 sudo docker exec 命令后命令提示符会变为 root@<容器 ID>:/#，表示已进入容器内环境）：

$ sudo docker exec -it obstandalone bash
# obclient -h127.0.0.1 -uroot@sys -P2881 -p -A oceanbase

或使用宿主机本地客户端连接（需宿主机已安装 OBClient 或 MySQL 客户端）：

$ obclient -h127.0.0.1 -uroot@sys -P2881 -p -A oceanbase

后续管理：容器内管理

Docker 方式下 OceanBase 数据库随容器启动和停止，您可执行 sudo docker stop obstandalone 停止容器（即停止 OceanBase 数据库），执行 sudo docker start obstandalone 再次启动。由于部署数据已通过 -v 挂载到宿主机目录，容器停止或删除后数据不会丢失。进入容器后还可使用 obd 命令查看和管理集群，详细命令说明请参见 obd 文档 集群命令组。

连接验证

成功启动 OceanBase 数据库后，您可以在上述步骤连接数据库的会话中执行以下 SQL 语句，确认集群运行正常。

1. 查看集群节点状态。返回结果中包含节点 IP、端口、所属 Zone、节点状态等信息：

   obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_SERVERS\G
   

   返回结果示例如下（以单节点集群 ob_test 为例，时间、版本号等信息以实际环境为准）：

   *************************** 1. row ***************************
                SVR_IP: 10.10.10.1
              SVR_PORT: 2882
                    ID: 1
                  ZONE: zone1
              SQL_PORT: 2881
       WITH_ROOTSERVER: YES
                STATUS: ACTIVE
   START_SERVICE_TIME: 2026-10-09 10:00:00.000000
            STOP_TIME: NULL
   BLOCK_MIGRATE_IN_TIME: NULL
            CREATE_TIME: 2026-10-09 10:00:00.000000
            MODIFY_TIME: 2026-10-09 10:00:00.000000
           BUILD_VERSION: 5.0.1.0_100000042026072711-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx(Jul 27 2026 11:00:00)
       LAST_OFFLINE_TIME: NULL
   

   当 STATUS 列为 ACTIVE 时，表示 OBServer 节点运行正常。详细字段说明请参见 DBA_OB_SERVERS。

2. 查看租户信息：

   obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_TENANTS\G
   

   返回结果示例如下；若您已创建业务租户（如 mysql001），还会查询到该租户及其对应的 Meta 租户（如 META$1002）的记录：

   *************************** 1. row ***************************
                    TENANT_ID: 1
                  TENANT_NAME: sys
                  TENANT_TYPE: SYS
                  CREATE_TIME: 2026-10-09 10:00:00.000000
                  MODIFY_TIME: 2026-10-09 10:00:00.000000
                 PRIMARY_ZONE: RANDOM
                     LOCALITY: FULL{1}@zone1
              TABLEGROUP_NAME: NULL
            PREVIOUS_LOCALITY: NULL
           COMPATIBILITY_MODE: MYSQL
                       STATUS: NORMAL
                IN_RECYCLEBIN: NO
                       LOCKED: NO
                  TENANT_ROLE: PRIMARY
            SWITCHOVER_STATUS: NORMAL
             SWITCHOVER_EPOCH: 0
                     SYNC_SCN: NULL
               REPLAYABLE_SCN: NULL
                 READABLE_SCN: NULL
           RECOVERY_UNTIL_SCN: NULL
                   LOG_MODE: NOARCHIVELOG
   ARBITRATION_SERVICE_STATUS: DISABLED
                   UNIT_NUM: 1
           ZONE_UNIT_NUM_LIST: zone1:1
                   COMPATIBLE: 5.0.1.0
                    MAX_LS_ID: 1
            RESTORE_DATA_MODE: NORMAL
            FLASHBACK_LOG_SCN: NULL
                    COMMENT: system tenant
            PROTECTION_MODE: NULL
           PROTECTION_LEVEL: NULL
          DEFAULT_TABLESPACE: NULL
   

   当 sys 租户的 STATUS 列为 NORMAL 时，表示租户运行正常。详细字段说明请参见 DBA_OB_TENANTS。

下一步

完成本文的部署体验后，您可以继续以下探索之旅：

1. 连接与 SQL 操作：执行基本 SQL 语句，体验 OceanBase 数据库的 MySQL 兼容能力。详见 SQL 基础操作（MySQL 模式）。
2. 创建业务租户：创建独立租户，体验 OceanBase 数据库的多租户隔离能力。详见 体验多租户与资源隔离。
3. 体验高并发 OLTP：通过 TPC-C 压测体验 OceanBase 数据库的事务处理能力。详见 体验高并发 OLTP 场景。
4. 体验 HTAP 混合负载：通过 TPC-H 测试体验 OceanBase 数据库的行列混合存储与并行分析能力。详见 体验 HTAP 混合负载场景。

相关文档

• OceanBase 数据库社区版部署方式及适用场景的介绍可参见 OceanBase 数据库社区版部署概述。
• OceanBase 企业版的部署方式请参见 部署概述。
• 清理集群的具体操作可参见 清理旧集群。