0. 有奖征文活动
OceanBase 社区正在组织一个以 "OBD 单机部署上手体验" 为主题的有奖征文活动，参与方式详见：ask.oceanbase.com/t/topic/356...
征文奖金超级丰厚，具体有多么丰厚？更多详情👉「2025 OceanBase 布道师计划」
1. 概述
本文主要分享在 Windows 笔记本上的 Linux 子系统 Ubuntu 上部署 OB 社区版单机版的过程以及相关原理讲解。
本次部署没有部署 OCP ，OB 集群的部署是依赖 obd web 平台做的。部署后会自动启动 OB-Dashboard （进程是 obshell ，Http 端口是 2886 )。通过 OB-Dashbaord 也可以做一些简单的 OB 单节点运维。
2. 环境准备
部署环境是 Windows 笔记本上的一个 WSL 子系统，选择的是 Ubuntu-22.04 。大概 16C 22G 内存资源，1T 空间。
plain
d:\Download>wsl -l -v
NAME STATE VERSION
* Ubuntu-22.04 Running 22.1 资源检查
OB 社区版运行最小资源规格官网说明是 2C4G 。考虑到 OB 的多租户能力，这里就不测试这种小规格了，个人在生产部署最低要求 8C16G。
进入 Ubuntu 系统后，核实一下机器资源。
- 检查 CPU 数量和指令集选项
plain
mq@OBPILOT:~$ lscpu
Architecture: x86_64
CPU op-mode(s): 32-bit, 64-bit
Address sizes: 48 bits physical, 48 bits virtual
Byte Order: Little Endian
CPU(s): 16
On-line CPU(s) list: 0-15
Vendor ID: AuthenticAMD
Model name: AMD Ryzen 7 7840U w/ Radeon 780M Graphics
CPU family: 25
Model: 116
Thread(s) per core: 2
Core(s) per socket: 8
Socket(s): 1
Stepping: 1
BogoMIPS: 6587.24
Flags: fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ht syscall nx mmxext fxsr_opt pdpe1gb rdtscp
lm constant_tsc rep_good nopl tsc_reliable nonstop_tsc cpuid extd_apicid pni pclmulqdq ssse3 fma cx16 sse4_1 sse4_2 movbe popcnt aes xsave avx
f16c rdrand hypervisor lahf_lm cmp_legacy svm cr8_legacy abm sse4a misalignsse 3dnowprefetch osvw topoext perfctr_core ssbd ibrs ibpb stibp vmm
call fsgsbase bmi1 avx2 smep bmi2 erms invpcid avx512f avx512dq rdseed adx smap avx512ifma clflushopt clwb avx512cd sha_ni avx512bw avx512vl xs
aveopt xsavec xgetbv1 xsaves avx512_bf16 clzero xsaveerptr arat npt nrip_save tsc_scale vmcb_clean flushbyasid decodeassists pausefilter pfthre
shold v_vmsave_vmload avx512vbmi umip avx512_vbmi2 gfni vaes vpclmulqdq avx512_vnni avx512_bitalg avx512_vpopcntdq rdpid fsrm
Virtualization features:
Virtualization: AMD-V
Hypervisor vendor: Microsoft
Virtualization type: full
Caches (sum of all):
L1d: 256 KiB (8 instances)
L1i: 256 KiB (8 instances)
L2: 8 MiB (8 instances)
L3: 16 MiB (1 instance)
Vulnerabilities:
Gather data sampling: Not affected
Itlb multihit: Not affected
L1tf: Not affected
Mds: Not affected
Meltdown: Not affected
Mmio stale data: Not affected
Reg file data sampling: Not affected
Retbleed: Not affected
Spec rstack overflow: Mitigation; safe RET
Spec store bypass: Mitigation; Speculative Store Bypass disabled via prctl and seccomp
Spectre v1: Mitigation; usercopy/swapgs barriers and __user pointer sanitization
Spectre v2: Mitigation; Retpolines; IBPB conditional; IBRS_FW; STIBP always-on; RSB filling; PBRSB-eIBRS Not affected; BHI Not affected
Srbds: Not affected
Tsx async abort: Not affectedCPU 是 AMD 的，其中关键信息是 16 个 逻辑 CPU，CPU Flags 支持 avx2、avx512 相关指令集。
- 检查内存大小，特别是可用内存
plain
mq@OBPILOT:~$ free -h
total used free shared buff/cache available
Mem: 23Gi 548Mi 22Gi 14Mi 236Mi 22Gi
Swap: 4.0Gi 0B 4.0Gi- 检查 github 地址
OB 社区版在 github 开源,开源地址：github.com/oceanbase/o... 。
plain
mq@OBPILOT:~/obce/ob-deploy$ ping github.com
PING github.com (20.205.243.166) 56(84) bytes of data.
64 bytes from 20.205.243.166: icmp_seq=3 ttl=110 time=85.0 ms
64 bytes from 20.205.243.166 (20.205.243.166): icmp_seq=4 ttl=110 time=84.5 ms
64 bytes from 20.205.243.166: icmp_seq=5 ttl=110 time=84.0 ms
64 bytes from 20.205.243.166 (20.205.243.166): icmp_seq=6 ttl=110 time=86.2 ms
64 bytes from 20.205.243.166: icmp_seq=7 ttl=110 time=87.1 ms
64 bytes from 20.205.243.166 (20.205.243.166): icmp_seq=8 ttl=110 time=89.3 ms
^C64 bytes from 20.205.243.166: icmp_seq=9 ttl=110 time=88.5 ms
--- github.com ping statistics ---
9 packets transmitted, 7 received, 22.2222% packet loss, time 35399ms
rtt min/avg/max/mdev = 84.003/86.359/89.261/1.865 ms
mq@OBPILOT:~/obce/ob-deploy$- 检查 gcc 编译命令
plain
mq@OBPILOT:~/obce/ob-deploy$ gcc --version
gcc (Ubuntu 11.4.0-1ubuntu1~22.04.2) 11.4.0
Copyright (C) 2021 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.- 检查防火墙状态
plain
mq@OBPILOT:~/obce/ob-deploy$ sudo ufw status
Status: inactive2.2 下载软件
部署下载地址： www.oceanbase.com/softwarecen...
OB 软件后期通过部署软件自动下载。
CentOS/RHEL/Fedora 等使用 RPM 包管理系统（.rpm文件），Ubuntu/Debian 等使用 Debian 包管理系统（.deb文件）。这两种格式互不兼容，Ubuntu 的 dpkg和 apt无法直接安装或管理 RPM 文件。
官网 OBD 的软件包只有 RPM 格式，分别支持 x86 版和 ARM 版。 所以这里有多个途径可以在 Ubuntu 下使用 RPM 包。
- 安装 rpm 命令
- 将 rpm 文件转换为 deb 文件
- 提取 RPM 包内容手动安装。
这里首先演示一下 3 ，这样能理解 rpm 包的原理。
首先安装提取 RPM 包所需要的软件。
plain
sudo apt update
sudo apt install rpm2cpio cpio然后创建目录 ob-deploy 并提取文件到目录中。
plain
mkdir ob-deploy
cd ob-deploy
rpm2cpio ../ob-deploy-3.6.0-3.el7.x86_64.rpm | cpio -idmv查看解压缩的目录结构，也能看出原 RPM 包安装的时候文件会复制到的目标目录。
plain
mq@OBPILOT:~/obce/ob-deploy$ tree -L 3
.
├── etc
│ └── profile.d
│ └── obd.sh
└── usr
├── bin
│ └── obd
└── obd
├── config_parser
├── example
├── lib
├── mirror
├── optimize
├── plugins
├── web
└── workflows
13 directories, 2 files所以，手动将这些目录文件复制到系统目录。
plain
sudo cp -r etc/* /etc/
sudo cp -r usr/* /usr/
which obd
obd --version
mq@OBPILOT:~/obce/ob-deploy$ which obd
/usr/bin/obd
mq@OBPILOT:~/obce/ob-deploy$ obd --version
OceanBase Deploy: 3.6.0
REVISION: b36013bb09a84516e56db51dba78a9d9096735e7
BUILD_BRANCH: HEAD
BUILD_TIME: Sep 04 2025 10:50:58OURCE
Copyright (C) 2025 OceanBase
License Apache 2.0: Apache version 2 or later <https://www.apache.org/licenses/LICENSE-2.0>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.3. 安装部署
3.1 前置部署
- 关闭防火墙（如果之前开了）
plain
mq@OBPILOT:~/obce/ob-deploy$ sudo ufw disable
Firewall stopped and disabled on system startup- 安装依赖包
plain
sudo apt update
sudo apt install -y gcc make libssl-dev python3 python3-pip libaio1 libaio-dev- 修改内核参数
plain
# 创建自定义配置文件
sudo tee /etc/sysctl.d/99-custom.conf << EOF
vm.swappiness=0
net.core.somaxconn=2048
vm.overcommit_memory=0
fs.file-max=6573688
EOF
# 应用所有配置
sudo sysctl --system- 创建用户
admin
plain
sudo useradd -m -s /bin/bash -g admin admin
sudo passwd adminUbuntu 里默认没有 admin 用户，但是可能有个 admin 用户组，并且默认有 sudo 权限。这个也符合 OB 运维需求，admin 用户有 sudo 权限，能减少切换 root 的次数，降低误操作风险。这里各个客户公司安全规范不一，可以不一样。
plain
mq@OBPILOT:~$ sudo su - admin
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.
Welcome to Ubuntu 22.04.5 LTS (GNU/Linux 5.15.167.4-microsoft-standard-WSL2 x86_64)
* Documentation: https://help.ubuntu.com
* Management: https://landscape.canonical.com
* Support: https://ubuntu.com/pro
System information as of Mon Sep 8 17:09:42 CST 2025
System load: 0.19 Processes: 55
Usage of /: 4.5% of 1006.85GB Users logged in: 1
Memory usage: 3% IPv4 address for eth0: 172.20.143.100
Swap usage: 0%
* Strictly confined Kubernetes makes edge and IoT secure. Learn how MicroK8s
just raised the bar for easy, resilient and secure K8s cluster deployment.
https://ubuntu.com/engage/secure-kubernetes-at-the-edge
This message is shown once a day. To disable it please create the
/home/admin/.hushlogin file.
admin@OBPILOT:~$ sudo date
[sudo] password for admin:
Mon Sep 8 17:09:59 CST 2025- 安装 SSH 服务
WSL 子系统 Ubuntu 默认没有启动 SSHD 服务，还需要安装一下。
plain
sudo apt update
sudo apt install openssh-server启动服务 SSH 。
plain
# 手动启动
sudo service ssh start
# 检查状态
sudo service ssh status
# 停止服务
sudo service ssh stop
mq@OBPILOT:~$ sudo service ssh status
● ssh.service - OpenBSD Secure Shell server
Loaded: loaded (/lib/systemd/system/ssh.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2025-09-08 17:14:11 CST; 2min 52s ago
Docs: man:sshd(8)
man:sshd_config(5)
Main PID: 4696 (sshd)
Tasks: 1 (limit: 28835)
Memory: 1.7M
CGroup: /system.slice/ssh.service
└─4696 "sshd: /usr/sbin/sshd -D [listener] 0 of 10-100 startups"
Sep 08 17:14:11 OBPILOT systemd[1]: Starting OpenBSD Secure Shell server...
Sep 08 17:14:11 OBPILOT sshd[4696]: Server listening on 0.0.0.0 port 22.
Sep 08 17:14:11 OBPILOT sshd[4696]: Server listening on :: port 22.
Sep 08 17:14:11 OBPILOT systemd[1]: Started OpenBSD Secure Shell server.- 准备数据目录
通常 OB 有两个主要目录。数据目录放在 /data/1 ，（事务）日志目录放在 /data/log1 。生产环境这两个目录要用独立的磁盘和文件系统。这里是测试环境，就共用一块盘和文件系统了。
plain
sudo mkdir -p /data && sudo chown -R admin.admin /data3.2 OBD 白屏部署 OB 单机版
这里就部署在当前用户（普通用户mq下），个人认为部署在 root 下是很危险的。
plain
mq@OBPILOT:~$ sudo obd web start
start OBD WEB in 0.0.0.0:8680
please open http://127.0.1.1:8680这里注意我是用 sudo 命令启动的。 用跟不用区别很大，不用，就是安装到当前用户下；用，就是可以安装到不同用户下（我也不想安装到 root 用户下）。
这里提示的访问地址是 127.0.0.1 ，由于是虚拟机，外面肯定无法访问这个地址。所以还需要查看虚拟机地址。
plain
mq@OBPILOT:~$ ip addr
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet 10.255.255.254/32 brd 10.255.255.254 scope global lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
link/ether 00:15:5d:73:e0:00 brd ff:ff:ff:ff:ff:ff
inet 172.20.143.100/20 brd 172.20.143.255 scope global eth0
valid_lft forever preferred_lft forever
inet6 fe80::215:5dff:fe73:e000/64 scope link
valid_lft forever preferred_lft forever里面真实 IP 是 172.20.143.100 ，所以访问地址是： http://172.20.143.100:8680/
看到这个页面，就成功了四分之一。点击"开启体验之旅"。
这里 OBD WEB 提供了 OB 的部署、OB 云平台的部署以及组件的管理。本文主要探索 OB 单机部署，所以不选择 【OB 云平台】，选第一个【OB 及配套工具】。
后面会进入 OB 部署向导页面。
3.2.1 部署配置
- 设置集群名称 和选择 数据库版本
集群名称很重要，后期不能改。
版本的选择，如果是正式业务用，就查看官网 Release Note 里。一般首先用 LTS 版本（4.2.5 或 4.3.5 ），然后选择倒数第二个 BP 版本。
- 选择负载类型
负载类型有 OLTP、OLAP、HTAP、OBKV 等。选错了也没关系。这个选择只是影响一些参数的设置，并且这些参数后期都可以改。
- 选择组件
这些组件的作用在生产的运维，都很有必要。 有 OCP 的场景里，这些组件都在后台默默的工作（除了 OBConfigServer）；没有 OCP 的场景里，组件的作用就浮出水面了。
所有组件除了 OBConfigServer 外大家都能理解，OBConfigServer 应该是一个"服务"，用于OB RS 的元信息的注册、查询和存储。以前手动部署 OB 集群的时候，缺陷就是 RS 是写死 IP 的，有了这个服务，OBProxy 就可以写死这个服务的 API 地址动态获取 OB 集群的 RS 地址。
3.2.2 节点配置
- 指定数据库节点和组件节点
这里只有一个节点，并且尽量不要用 127.0.0.1 那个地址，改用实际的 IP 。
- 指定部署用户
部署用户名就用常用的 admin 用户。不要用 root！
- 指定软件路径配置
部署目录就用常用的默认目录：/home/admin/obcedemo 。
3.2.3 集群配置
- 设置集群密码、数据目录、端口
模式配置如果是生产服务器，就选择"最大占用"；开发测试环境选择"最小可用"。这个是给不熟悉 OB 的人使用。选错不要紧，后面还可以改相应参数。
OBShell 端口 2886 后面会有用。
- 配置更多参数
即使是初学者，也建议配置这些参数。否则后面磁盘和内存被用去大半会让人很意外。这里的每个参数都有其用处，可以参考图中配置。
小内存规格下，参数product_mode 设置为 False 。
- 配置组件参数
主要就设置一下密码，其他参数都保持默认。
主要就是小内存环境限制一下 OBProxy 的内存。如果是生产环境，还要调大这个内存参数 proxy_mem_limited 。
后面参数按页面提示输入相应的。( 这里 vip_address 有个前端 BUG ，格式检查不过。可以收起这个"更多配置" 绕过这个问题
3.2.4 预检查
3.2.5 开始部署
点击下面的"部署按钮"。
- 部署成功
3.2.6 创建业务租户
创建成功如下。
3.2.7 租户连接
验证租户连接需要命令obclient 。先安装一下。
plain
mkdir obclient && cd obclient
rpm2cpio ../obclient-2.2.11-22025090217.el7.x86_64.rpm |cpio -idmv
sudo cp -r u01/obclient/bin/* /usr/local/bin/
4. OB 社区版体验
4.1 巡检 OB 体验环境
命令行下还是使用 obd 命令查看部署信息。
- 查看各个组件的连接方式和账户密码。
plain
mq@OBPILOT:~$ sudo obd cluster display obcedemo
Get local repositories and plugins ok
Open ssh connection ok
Connect to ob-configserver ok
+--------------------------------------------------------------------+
| ob-configserver |
+----------------+------+----------------+----------+--------+-------+
| server | port | vip_address | vip_port | status | pid |
+----------------+------+----------------+----------+--------+-------+
| 172.20.143.100 | 8080 | 172.20.143.100 | 8080 | active | 27382 |
+----------------+------+----------------+----------+--------+-------+
curl -s 'http://172.20.143.100:8080/services?Action=GetObProxyConfig'
Connect to observer 172.20.143.100:2881 ok
Wait for observer init ok
+--------------------------------------------------+
| oceanbase-ce |
+----------------+---------+------+-------+--------+
| ip | version | port | zone | status |
+----------------+---------+------+-------+--------+
| 172.20.143.100 | 4.3.5.3 | 2881 | zone1 | ACTIVE |
+----------------+---------+------+-------+--------+
obclient -h172.20.143.100 -P2881 -uroot@sys -p'*******' -Doceanbase -A
cluster unique id: b8c970ad-2f63-50f3-9b9e-7c77262e05ee-199314d5555-03050304
Connect to obproxy ok
+--------------------------------------------------------------------+
| obproxy-ce |
+----------------+------+-----------------+-----------------+--------+
| ip | port | prometheus_port | rpc_listen_port | status |
+----------------+------+-----------------+-----------------+--------+
| 172.20.143.100 | 2883 | 2884 | 2885 | active |
+----------------+------+-----------------+-----------------+--------+
obclient -h172.20.143.100 -P2883 -uroot@proxysys -p'***********' -Doceanbase -A
Connect to Obagent ok
+-------------------------------------------------------------------+
| obagent |
+----------------+--------------------+--------------------+--------+
| ip | mgragent_http_port | monagent_http_port | status |
+----------------+--------------------+--------------------+--------+
| 172.20.143.100 | 8089 | 8088 | active |
+----------------+--------------------+--------------------+--------+
Connect to Prometheus ok
+----------------------------------------------------------+
| prometheus |
+----------------------------+-------+------------+--------+
| url | user | password | status |
+----------------------------+-------+------------+--------+
| http://172.20.143.100:9090 | admin | '*********' | active |
+----------------------------+-------+------------+--------+
Connect to grafana ok
+----------------------------------------------------------------------+
| grafana |
+----------------------------------------+-------+------------+--------+
| url | user | password | status |
+----------------------------------------+-------+------------+--------+
| http://172.20.143.100:3000/d/oceanbase | admin | '********' | active |
+----------------------------------------+-------+------------+--------+
Connect to Alertmanager ok
+------------------------------------------------------------+
| alertmanager |
+----------------------------+-------+--------------+--------+
| url | user | password | status |
+----------------------------+-------+--------------+--------+
| http://172.20.143.100:9093 | admin | '*********' | active |
+----------------------------+-------+--------------+--------+
obshell program health check ok
display ob-dashboard ok
+---------------------------------------------------------+
| ob-dashboard |
+----------------------------+------+------------+--------+
| url | user | password | status |
+----------------------------+------+------------+--------+
| http://172.20.143.100:2886 | root | '********' | active |
+----------------------------+------+------------+--------+
Trace ID: 6acb9326-8df4-11f0-8bd2-00155dd330c2
If you want to view detailed obd logs, please run: obd display-trace 6acb9326-8df4-11f0-8bd2-00155dd330c2这个命令会把密码明文输出，这个很不好。上面 * 是我改过 的。产品其实可以将密码的背景色和前景色设置为一样，让密码不是那么"直白" 但是可以被复制。
- 查看相关产品目录
plain
admin@OBPILOT:~/obcedemo$ pwd
/home/admin/obcedemo
admin@OBPILOT:~/obcedemo$ tree -L 2
.
├── alertmanager
│ ├── LICENSE -> /home/admin/.obd/repository/alertmanager/0.28.1/c5fe05fcc8263b83f6d0602a871d7e1a7a79bdb8//./LICENSE
│ ├── NOTICE -> /home/admin/.obd/repository/alertmanager/0.28.1/c5fe05fcc8263b83f6d0602a871d7e1a7a79bdb8//./NOTICE
│ ├── alertmanager -> /home/admin/.obd/repository/alertmanager/0.28.1/c5fe05fcc8263b83f6d0602a871d7e1a7a79bdb8//./alertmanager
│ ├── alertmanager.yaml
│ ├── alertmanager.yml -> /home/admin/.obd/repository/alertmanager/0.28.1/c5fe05fcc8263b83f6d0602a871d7e1a7a79bdb8//./alertmanager.yml
│ ├── amtool -> /home/admin/.obd/repository/alertmanager/0.28.1/c5fe05fcc8263b83f6d0602a871d7e1a7a79bdb8//./amtool
│ ├── data
│ ├── log
│ ├── run
│ └── web_config.yaml
├── grafana
│ ├── bin
│ ├── conf
│ ├── data
│ ├── log -> /home/admin/obcedemo/grafana/data/log
│ ├── plugins-bundled
│ ├── public
│ ├── run
│ └── scripts
├── obagent
│ ├── backup
│ ├── bin
│ ├── conf
│ ├── log
│ ├── pkg_store
│ ├── position_store
│ ├── run
│ ├── site-packages
│ ├── task_store
│ └── tmp
├── obconfigserver
│ ├── bin
│ ├── conf
│ ├── log
│ └── run
├── obproxy
│ ├── bin
│ ├── control-config
│ ├── etc
│ ├── lib
│ ├── log
│ ├── obproxyd.sh
│ ├── run
│ └── sharding-config
├── oceanbase
│ ├── admin
│ ├── audit
│ ├── bin
│ ├── etc
│ ├── etc2
│ ├── etc3
│ ├── lib
│ ├── log
│ ├── log_obshell
│ ├── run
│ └── store -> /data/1
└── prometheus
├── console_libraries
├── consoles
├── data
├── log
├── prometheus -> /home/admin/.obd/repository/prometheus/2.37.1/d5fe6d40b6ccd6de9de036fd294966d044a3c328/prometheus
├── prometheus.yaml
├── prometheusd.sh
├── promtool -> /home/admin/.obd/repository/prometheus/2.37.1/d5fe6d40b6ccd6de9de036fd294966d044a3c328/promtool
├── rules
├── run
└── web_config.yaml
56 directories, 13 files
admin@OBPILOT:~/obcedemo/oceanbase$ cd oceanbase/
admin@OBPILOT:~/obcedemo/oceanbase$ tree bin -L 1
bin
├── import_srs_data.py -> /home/admin/.obd/repository/oceanbase-ce/4.3.5.3/01caa84d50b07cc5d09d3a34be2d543dd72e708f/bin/./import_srs_data.py
├── import_time_zone_info.py -> /home/admin/.obd/repository/oceanbase-ce/4.3.5.3/01caa84d50b07cc5d09d3a34be2d543dd72e708f/bin/./import_time_zone_info.py
├── observer -> /home/admin/.obd/repository/oceanbase-ce/4.3.5.3/01caa84d50b07cc5d09d3a34be2d543dd72e708f/bin/./observer
└── obshell -> /home/admin/.obd/repository/oceanbase-ce/4.3.5.3/01caa84d50b07cc5d09d3a34be2d543dd72e708f/bin/./obshell
0 directories, 4 files
admin@OBPILOT:~/obcedemo/oceanbase$ ll store
lrwxrwxrwx 1 admin admin 7 Sep 10 09:39 store -> /data/1/
admin@OBPILOT:~/obcedemo/oceanbase$ tree store
store
├── clog -> /data/log1/clog
├── slog
│ ├── server
│ │ └── 1
│ ├── tenant_1
│ │ └── 1
│ ├── tenant_1001
│ │ └── 1
│ └── tenant_1002
│ └── 1
└── sstable
└── block_file
7 directories, 5 files上面是 OB 相关的目录。这些目录有个需要注意的点就是 observer 和 obproxy 以及相关产品的可执行文件、个别脚本文件实际上都是软连接，真实的文件存在隐藏目录 ~/.obd 下。千万不要删除这个隐藏目录，也不要以为删除了软件目录就清理干净了。
最好的清理方法是用 obd 命令去清理。
plain
admin@OBPILOT:~/obcedemo/oceanbase$ tree store/clog/tenant_1* -L 2
store/clog/tenant_1
└── 1
├── log
└── meta
store/clog/tenant_1001
└── 1
├── log
└── meta
store/clog/tenant_1002
├── 1
│ ├── log
│ └── meta
└── 1001
├── log
└── meta上面就是 OB 4.2 讲的比较多的事务日志流的文件夹。每个租户一个大文件夹。
- 查看相关监听端口
plain
mq@OBPILOT:~$ sudo ss -tulnp | awk '!seen[$5]++'
Netid State Recv-Q Send-Q Local Address:Port Peer Address:PortProcess
udp UNCONN 0 0 127.0.0.53%lo:53 0.0.0.0:* users:(("systemd-resolve",pid=132,fd=13))
udp UNCONN 0 0 10.255.255.254:53 0.0.0.0:*
udp UNCONN 0 0 127.0.0.1:323 0.0.0.0:*
udp UNCONN 0 0 [::1]:323 [::]:*
tcp LISTEN 0 128 0.0.0.0:2884 0.0.0.0:* users:(("obproxy",pid=28181,fd=18))
tcp LISTEN 0 1024 0.0.0.0:2885 0.0.0.0:* users:(("obproxy",pid=28181,fd=103))
tcp LISTEN 0 1024 0.0.0.0:2881 0.0.0.0:* users:(("observer",pid=27477,fd=199))
tcp LISTEN 0 1024 0.0.0.0:2882 0.0.0.0:* users:(("observer",pid=27477,fd=99))
tcp LISTEN 0 1024 0.0.0.0:2883 0.0.0.0:* users:(("obproxy",pid=28181,fd=98))
tcp LISTEN 0 128 0.0.0.0:22 0.0.0.0:* users:(("sshd",pid=250,fd=3))
tcp LISTEN 0 244 127.0.0.1:5432 0.0.0.0:* users:(("postgres",pid=904,fd=5))
tcp LISTEN 0 1024 [::]:2885 [::]:* users:(("obproxy",pid=28181,fd=106))
tcp LISTEN 0 2048 *:2886 *:* users:(("obshell",pid=27993,fd=9))
tcp LISTEN 0 1024 [::]:2882 [::]:* users:(("observer",pid=27477,fd=103))
tcp LISTEN 0 1024 [::]:2883 [::]:* users:(("obproxy",pid=28181,fd=100))
tcp LISTEN 0 2048 *:3000 *:* users:(("grafana-server",pid=28755,fd=12))
tcp LISTEN 0 128 [::]:22 [::]:* users:(("sshd",pid=250,fd=4))
tcp LISTEN 0 2048 *:8080 *:* users:(("ob-configserver",pid=27382,fd=7))
tcp LISTEN 0 2048 *:8088 *:* users:(("ob_monagent",pid=28351,fd=7))
tcp LISTEN 0 2048 *:8089 *:* users:(("ob_mgragent",pid=28350,fd=7))
tcp LISTEN 0 2048 *:9093 *:* users:(("alertmanager",pid=28857,fd=3))
tcp LISTEN 0 2048 *:9090 *:* users:(("prometheus",pid=28639,fd=3))OBSERVER 本身很简单，单进程软件，就监听 2881 和 2882 . OBProxy 也是单进程软件，监听 2883、2884、2885 。 OBSHELL 进程监听 2886 。每个端口都有特殊的用途。具体参考官网文档。
4.2 OB_CONFIGSERVER 体验
ob_configserver 是为了方便没有 OCP 的情况下 OB 集群（多节点）的 RootService 服务地址的获取。OB 集群的参数 obconfig_url 就是为此设计，通常在生产环境这个内容是 OCP 的一个 API 地址。如果没有部署 OCP ，那就需要单独的一个服务提供这个 RoootService 元信息的读和写。
通常 OB 集群的参数 rootservice_list 会记录这个集群的 RootService 地址，这个参数是 observer 启动初始化时指定的参数。这个参数的弊端在于写死了，如果后期 SYS 租户换机器了，RootService 地址也会变化，但是这个参数不会变。
所以 OB 集群还有个参数 obconfig_url 是一个 API ，这个 API 可以获取这个集群的 RootService 地址。当 OB 集群的 SYS 租户成员发生变动时（也就是 RootService 地址发生变动）, OB 集群会通过这个 API 写入新的地址。
如果没有部署 OCP 了，那就部署一个单独的服务 ob_configserver 。下面通过这个 API 读取一下值。
这里面就是显示的 RootService 地址。
在 OBProxy 启动的时候也需要 OB 集群的 RootService 地址。同样的 OBProxy 也有两个类似参数。目前 Dashboard 还不支持查看 OBProxy 参数，我们就到命令行下去查看。
plain
admin@OBPILOT:~/obcedemo/obproxy$ mysql -h127.1 -uroot@proxysys -P2883 -p -c -A
Enter password:
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 786432005
Server version: 5.6.25
Copyright (c) 2000, 2025, Oracle and/or its affiliates.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql> show proxyconfig like '%rootservice_list%';
+------------------+---------------------+------------------------------------------------------------------------------------------------------------------+-------------+---------------+-------+--------------+
| name | value | info | need_reboot | visible_level | range | config_level |
+------------------+---------------------+------------------------------------------------------------------------------------------------------------------+-------------+---------------+-------+--------------+
| rootservice_list | 172.20.143.100:2881 | a list of servers against which election candidate is checked for validation, format ip1:sql_port1;ip2:sql_port2 | true | SYS | | LEVEL_GLOBAL |
+------------------+---------------------+------------------------------------------------------------------------------------------------------------------+-------------+---------------+-------+--------------+
1 row in set (0.00 sec)
mysql> show proxyconfig like '%obproxy_config_server_url%';
+---------------------------+-------------------------------------------------------------+---------------------------------------+-------------+---------------+-------+--------------+
| name | value | info | need_reboot | visible_level | range | config_level |
+---------------------------+-------------------------------------------------------------+---------------------------------------+-------------+---------------+-------+--------------+
| obproxy_config_server_url | http://172.20.143.100:8080/services?Action=GetObProxyConfig | url of config info(rs list and so on) | true | SYS | | LEVEL_GLOBAL |
+---------------------------+-------------------------------------------------------------+---------------------------------------+-------------+---------------+-------+--------------+
1 row in set (0.00 sec)
mysql>同样，我们要看看读取这里的 API 地址返回信息。
这个里面就记录了这个 OBProxy 集群能连接的 OB 集群对应的参数 obconfig_url 值。也就是前面的 API 地址。
所以，这两个 API 就是 ob_configserver 服务提供的。
- 巡检
ob_configserver服务
下面是巡检 ob_configserver 服务
首先确认 ob_configserver 已经启动。
plain
mq@OBPILOT:~$ sudo ss -tulnp | awk '!seen[$5]++' |grep 8080
tcp LISTEN 0 2048 *:8080 *:* users:(("ob-configserver",pid=27382,fd=7))然后查看 ob_configserver 参数。
plain
admin@OBPILOT:~/obcedemo/obconfigserver$ cat conf/ob-configserver.yaml
log:
level: info
filename: /home/admin/obcedemo/obconfigserver/log/ob-configserver.log
maxsize: 30
maxage: 7
maxbackups: 10
localtime: true
compress: true
server:
address: 0.0.0.0:8080
run_dir: run
vip:
address: 172.20.143.100
port: 8080
storage:
database_type: sqlite3
connection_url: /home/admin/obcedemo/obconfigserver/.data.db?cache=shared&_fk=1这个参数里指定了 VIP 地址，这个可以是实际物理 IP ，也可以是虚拟 IP 。在生产环境，如果 OB 集群是多节点的，这个应该是负载提供的 VIP，后端对应有部署 ob_configserver 的 地址 IP（可以独立部署在虚拟机上，也可以部署在 OB 节点上）。
参数文件里还提示了 ob_configserver 的日志。
查看日志就可以看到这个 API 周期性的被调用读取（GET）。如果是写入信息，那就是 POST 。GET 和 POST 是 HTTP 协议的内容。如果 API 有问题，这个日志里就有明细。
4.3 OB Dashboard 体验
plain
mq@OBPILOT:~$ ps -ef|grep obshell
admin 27960 1 0 09:48 ? 00:00:00 /home/admin/obcedemo/oceanbase/bin/obshell daemon --ip 172.20.143.100 --port 2886
admin 27993 27960 0 09:48 ? 00:00:10 /home/admin/obcedemo/oceanbase/bin/obshell server --ip 172.20.143.100 --port 2886
mq 53601 421 0 11:08 pts/0 00:00:00 grep obshellobshell 进程监听端口是 2886 , 这是 http 协议访问，访问地址： http://172.20.143.100:2886/
这个密码是 sys 租户的 root 密码。
- 集群管理
登陆后首页是集群管理，只支持当前集群。
这个时候能做的运维有参数管理、停止集群。
- 租户管理
租户管理下可以新建租户。这个很常见就不用演示了。
租户下可以新建数据库和新建用户。
- 软件包管理
可以上传软件包。一般来说要把当前 OB 集群版本和 obshell版本软件上传上去，以后才可以升级。
没有软件包删除入口，功能还有待完善。
- 任务中心
OB-Dashboard 的运维也是参考 OCP 的框架，只不过是更精简一些。运维操作都以任务流形式存在。任务流的细节目前看还比较粗糙。
- 参数管理
包括集群的参数管理和租户的参数管理。
集群的参数影响的是整个集群。
租户的参数管理只影响当前租户。
5. 总结
总体上来说 OB 社区版如果是测试学习，可以在笔记本上单机部署，并且不需要部署 OCP ，使用 OB-Dashboard 可以做一些简单的基础运维。
当然性能监控这些就还有待产品完善。如果是生产环境多节点集群，还是建议用专门的服务器部署一台社区版的 OCP 用于 OB 集群的运维。
使用 OBD 命令运维还是过于偏技术细节，有一定复杂度和风险。
最后为大家推荐这个 OceanBase 开源负责人老纪的公众号「老纪的技术唠嗑局」，会持续更新和 #数据库 、#AI 、#技术架构 相关的各种技术内容。欢迎感兴趣的朋友们关注！
「老纪的技术唠嗑局」不仅希望能持续给大家带来有价值的技术分享，也希望能和大家一起为开源社区贡献一份力量。如果你对 OceanBase 开源社区认可，点亮一颗小星星✨吧！你的每一个Star，都是我们努力的动力。