0. 有奖征文活动 OceanBase 社区正在组织一个以 “OBD 单机部署上手体验” 为主题的有奖征文活动，参与方式详见：https://ask.oceanbase.com/t/topic/35630223。
征文奖金超级丰厚，具体有多么丰厚？更多详情👉「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 空间。
1 2 3 d:\Download>wsl -l -v NAME STATE VERSION * Ubuntu-22.04 Running 2
2.1 资源检查 OB 社区版运行最小资源规格官网说明是 2C4G 。考虑到 OB 的多租户能力，这里就不测试这种小规格了，个人在生产部署最低要求 8C16G。
进入 Ubuntu 系统后，核实一下机器资源。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 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 affected
CPU 是 AMD 的，其中关键信息是 16 个 逻辑 CPU，CPU Flags 支持 avx2、avx512 相关指令集。
1 2 3 4 mq@OBPILOT:~$ free -h total used free shared buff/cache available Mem: 23Gi 548Mi 22Gi 14Mi 236Mi 22Gi Swap: 4.0Gi 0B 4.0Gi
OB 社区版在 github 开源,开源地址：https://github.com/oceanbase/oceanbase 。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 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$
1 2 3 4 5 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.
1 2 mq@OBPILOT:~/obce/ob-deploy$ sudo ufw status Status: inactive
2.2 下载软件 部署下载地址： https://www.oceanbase.com/softwarecenter
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 包所需要的软件。
1 2 sudo apt update sudo apt install rpm2cpio cpio
然后创建目录 ob-deploy 并提取文件到目录中。
1 2 3 mkdir ob-deploycd ob-deployrpm2cpio ../ob-deploy-3.6.0-3.el7.x86_64.rpm | cpio -idmv
查看解压缩的目录结构，也能看出原 RPM 包安装的时候文件会复制到的目标目录。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 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
所以，手动将这些目录文件复制到系统目录。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 sudo cp -r etc/* /etc/ sudo cp -r usr/* /usr/ which obdobd --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:58 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 前置部署
1 2 mq@OBPILOT:~/obce/ob-deploy$ sudo ufw disable Firewall stopped and disabled on system startup
1 2 sudo apt update sudo apt install -y gcc make libssl-dev python3 python3-pip libaio1 libaio-dev
1 2 3 4 5 6 7 8 9 10 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
1 2 sudo useradd -m -s /bin/bash -g admin admin sudo passwd admin
Ubuntu 里默认没有 admin 用户，但是可能有个 admin 用户组，并且默认有 sudo 权限。这个也符合 OB 运维需求，admin 用户有 sudo 权限，能减少切换 root 的次数，降低误操作风险。这里各个客户公司安全规范不一，可以不一样。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 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: x.x.x.x 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
WSL 子系统 Ubuntu 默认没有启动 SSHD 服务，还需要安装一下。
1 2 sudo apt update sudo apt install openssh-server
启动服务 SSH 。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 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 。生产环境这两个目录要用独立的磁盘和文件系统。这里是测试环境，就共用一块盘和文件系统了。
1 sudo mkdir -p /data && sudo chown -R admin.admin /data
3.2 OBD 白屏部署 OB 单机版 这里就部署在当前用户（普通用户mq下），个人认为部署在 root 下是很危险的。
1 2 3 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 ，由于是虚拟机，外面肯定无法访问这个地址。所以还需要查看虚拟机地址。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 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 x.x.x.x/20 brd x.x.x.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 是 x.x.x.x ，所以访问地址是： http://x.x.x.x: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 。先安装一下。
1 2 3 mkdir obclient && cd obclientrpm2cpio ../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 命令查看部署信息。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 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 | +----------------+------+----------------+----------+--------+-------+ | x.x.x.x | 8080 | x.x.x.x | 8080 | active | 27382 | +----------------+------+----------------+----------+--------+-------+ curl -s 'http://x.x.x.x:8080/services?Action=GetObProxyConfig' Connect to observer x.x.x.x:2881 ok Wait for observer init ok +--------------------------------------------------+ | oceanbase-ce | +----------------+---------+------+-------+--------+ | ip | version | port | zone | status | +----------------+---------+------+-------+--------+ | x.x.x.x | 4.3.5.3 | 2881 | zone1 | ACTIVE | +----------------+---------+------+-------+--------+ obclient -hx.x.x.x -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 | +----------------+------+-----------------+-----------------+--------+ | x.x.x.x | 2883 | 2884 | 2885 | active | +----------------+------+-----------------+-----------------+--------+ obclient -hx.x.x.x -P2883 -uroot@proxysys -p'***********' -Doceanbase -A Connect to Obagent ok +-------------------------------------------------------------------+ | obagent | +----------------+--------------------+--------------------+--------+ | ip | mgragent_http_port | monagent_http_port | status | +----------------+--------------------+--------------------+--------+ | x.x.x.x | 8089 | 8088 | active | +----------------+--------------------+--------------------+--------+ Connect to Prometheus ok +----------------------------------------------------------+ | prometheus | +----------------------------+-------+------------+--------+ | url | user | password | status | +----------------------------+-------+------------+--------+ | http://x.x.x.x:9090 | admin | '*********' | active | +----------------------------+-------+------------+--------+ Connect to grafana ok +----------------------------------------------------------------------+ | grafana | +----------------------------------------+-------+------------+--------+ | url | user | password | status | +----------------------------------------+-------+------------+--------+ | http://x.x.x.x:3000/d/oceanbase | admin | '********' | active | +----------------------------------------+-------+------------+--------+ Connect to Alertmanager ok +------------------------------------------------------------+ | alertmanager | +----------------------------+-------+--------------+--------+ | url | user | password | status | +----------------------------+-------+--------------+--------+ | http://x.x.x.x:9093 | admin | '*********' | active | +----------------------------+-------+--------------+--------+ obshell program health check ok display ob-dashboard ok +---------------------------------------------------------+ | ob-dashboard | +----------------------------+------+------------+--------+ | url | user | password | status | +----------------------------+------+------------+--------+ | http://x.x.x.x: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
这个命令会把密码明文输出，这个很不好。上面 * 是我改过 的。产品其实可以将密码的背景色和前景色设置为一样，让密码不是那么“直白” 但是可以被复制。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 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 命令去清理。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 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 讲的比较多的事务日志流的文件夹。每个租户一个大文件夹。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 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 参数，我们就到命令行下去查看。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 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 | x.x.x.x: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://x.x.x.x: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 已经启动。
1 2 mq@OBPILOT:~$ sudo ss -tulnp | awk '!seen[$5]++' |grep 8080 tcp LISTEN 0 2048 *:8080 *:* users :(("ob-configserver",pid=27382 ,fd=7 ))
然后查看 ob_configserver 参数。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 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: x.x.x.x 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 体验 1 2 3 4 mq@OBPILOT:~$ ps -ef|grep obshell admin 27960 1 0 09:48 ? 00:00:00 /home/admin/obcedemo/oceanbase/bin/obshell daemon --ip x.x.x.x --port 2886 admin 27993 27960 0 09:48 ? 00:00:10 /home/admin/obcedemo/oceanbase/bin/obshell server --ip x.x.x.x --port 2886 mq 53601 421 0 11:08 pts/0 00:00:00 grep obshell
obshell 进程监听端口是 2886 , 这是 http 协议访问，访问地址： http://x.x.x.x:2886/
这个密码是 sys 租户的 root 密码。
登陆后首页是集群管理，只支持当前集群。
这个时候能做的运维有参数管理、停止集群。
租户管理下可以新建租户。这个很常见就不用演示了。
租户下可以新建数据库和新建用户。
可以上传软件包。一般来说要把当前 OB 集群版本和 obshell版本软件上传上去，以后才可以升级。
没有软件包删除入口，功能还有待完善。
OB-Dashboard 的运维也是参考 OCP 的框架，只不过是更精简一些。运维操作都以任务流形式存在。任务流的细节目前看还比较粗糙。
包括集群的参数管理和租户的参数管理。
集群的参数影响的是整个集群。
租户的参数管理只影响当前租户。
5. 总结 总体上来说 OB 社区版如果是测试学习，可以在笔记本上单机部署，并且不需要部署 OCP ，使用 OB-Dashboard 可以做一些简单的基础运维。
当然性能监控这些就还有待产品完善。如果是生产环境多节点集群，还是建议用专门的服务器部署一台社区版的 OCP 用于 OB 集群的运维。
使用 OBD 命令运维还是过于偏技术细节，有一定复杂度和风险。
最后为大家推荐这个 OceanBase 开源负责人老纪的公众号「老纪的技术唠嗑局」，会持续更新和 #数据库 、#AI 、#技术架构 相关的各种技术内容。欢迎感兴趣的朋友们关注！
「老纪的技术唠嗑局」不仅希望能持续给大家带来有价值的技术分享，也希望能和大家一起为开源社区贡献一份力量。如果你对 OceanBase 开源社区认可，点亮一颗小星星✨吧！你的每一个Star，都是我们努力的动力。
