OceanBase 数据库安装与配置指南

OceanBase（简称 OB）是一款企业级原生分布式数据库，具备高可用、高扩展、强一致和高度兼容 MySQL 协议等特性。其安装与配置流程涉及集群规划、软件部署、集群初始化、租户创建等关键步骤。本文将提供一个从零开始的详细指南。

一、 环境规划与准备

在开始安装前，必须进行详细的规划，以确保集群的稳定性和性能。

安装依赖包示例（以 CentOS 为例）：

sudo yum install -y libaio-devel numactl net-tools

二、 使用 OBD 自动化部署（推荐）

OceanBase Deployer (OBD) 是官方推荐的自动化部署和管理工具，能极大简化安装流程。

1. 安装 OBD

   # 通过 OceanBase 官方软件源安装
   sudo yum install -y yum-utils
   sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo
   sudo yum install -y ob-deploy
   # 验证安装
   obd --version
   

2. 准备集群配置文件
   创建一个 YAML 配置文件（如 obcluster.yaml），定义集群拓扑和参数。

   ## obcluster.yaml 示例：部署一个包含3个节点的测试集群
   oceanbase-ce:
     servers:
       - name: server1
         ip: 192.168.1.101
       - name: server2
         ip: 192.168.1.102
       - name: server3
         ip: 192.168.1.103
     global:
       # 集群基础配置
       cluster_id: 1
       # 指定数据、日志、安装等目录（需提前创建并有足够权限）
       home_path: /home/admin/observer
       data_dir: /data/obdata
       redo_dir: /data/oblog
       # 资源规划
       memory_limit: 8G           # 单个observer进程内存上限
       system_memory: 4G          # 系统预留内存
       cpu_count: 8
       datafile_size: 50G         # 数据文件初始大小
       log_disk_size: 100G        # 日志磁盘大小
       # 网络配置
       devname: eth0
       mysql_port: 2881
       rpc_port: 2882
       # 高可用配置：定义3个Zone，每个Zone一个副本
       replication_num: 3
       zone_list: [zone1, zone2, zone3]
     server1:
       zone: zone1
     server2:
       zone: zone2
     server3:
       zone: zone3
   

3. 部署集群

   # 1. 检查并自动安装 OceanBase 软件包
   obd cluster deploy obtest -c obcluster.yaml
   # 2. 启动集群
   obd cluster start obtest
   # 3. 查看集群状态
   obd cluster display obtest
   

   执行 display 命令后，如果所有服务的状态（status）均为 active，则表明集群启动成功。

三、 集群初始化与基础配置

集群启动后，需要通过命令行客户端连接并进行初始化设置。

1. 连接系统租户（sys）

   # 使用 OBD 自带的客户端连接，-h 指定任意一个节点IP
   obclient -h192.168.1.101 -P2881 -uroot@sys -p
   # 或者使用 MySQL 客户端
   mysql -h192.168.1.101 -P2881 -uroot@sys -p
   

2. 修改 root@sys 密码（首次必须）

   ALTER USER root IDENTIFIED BY 'YourStrongPassword123';
   

3. 创建业务租户
   OceanBase 采用多租户架构。系统租户（sys）主要用于管理，业务数据应存放在独立的业务租户中。

   -- 1. 创建资源单元配置（Resource Unit），定义租户的CPU、内存等资源上限
   CREATE RESOURCE UNIT my_unit_config
   MAX_CPU = 2,
   MIN_CPU = 1,
   MEMORY_SIZE = '4G',
   LOG_DISK_SIZE = '20G',
   MAX_IOPS = 10000,
   MIN_IOPS = 1000;
   
   -- 2. 创建资源池，将资源单元与 Zone 关联
   CREATE RESOURCE POOL my_resource_pool
   UNIT = 'my_unit_config',
   UNIT_NUM = 1, -- 每个Zone上的单元数量
   ZONE_LIST = ('zone1', 'zone2', 'zone3');
   
   -- 3. 创建业务租户，并指定字符集、副本数等
   CREATE TENANT IF NOT EXISTS my_tenant
   RESOURCE_POOL_LIST = ('my_resource_pool'),
   PRIMARY_ZONE = 'RANDOM', -- 主副本优先分布策略
   COMMENT = '我的业务租户',
   CHARSET = 'utf8mb4',
   REPLICA_NUM = 3, -- 副本数，通常与Zone数一致
   ZONE_LIST = ('zone1', 'zone2', 'zone3'),
   OB_COMPATIBILITY_MODE = 'mysql'; -- 兼容MySQL模式
   
   -- 4. 为业务租户创建管理用户
   CREATE USER my_user IDENTIFIED BY 'UserPassword123';
   GRANT ALL PRIVILEGES ON *.* TO my_user;
   

四、 连接与验证业务租户

1. 连接业务租户

   mysql -h192.168.1.101 -P2881 -umy_user@my_tenant -p
   # 或
   obclient -h192.168.1.101 -P2881 -umy_user@my_tenant -p
   

2. 执行基本操作验证

   -- 在业务租户连接下执行
   -- 1. 创建测试数据库和表
   CREATE DATABASE test_db;
   USE test_db;
   CREATE TABLE test_table (
       id INT PRIMARY KEY AUTO_INCREMENT,
       name VARCHAR(50),
       create_time DATETIME DEFAULT CURRENT_TIMESTAMP
   );
   
   -- 2. 插入和查询数据
   INSERT INTO test_table (name) VALUES ('OceanBase Test');
   SELECT * FROM test_table;
   
   -- 3. 查看表分布（验证分布式特性）
   SELECT /*+ READ_CONSISTENCY(WEAK)*/ table_name, partition_id, svr_ip FROM oceanbase.__all_virtual_proxy_schema WHERE table_name='TEST_TABLE'\G
   

五、 关键参数调优与管理

安装后，根据业务负载调整关键参数至关重要。

参数修改示例：

-- 在 sys 租户下，修改集群级参数
ALTER SYSTEM SET memory_limit='16G' SERVER='192.168.1.101:2882';
-- 或修改租户级参数
ALTER TENANT my_tenant SET ob_sql_work_area_percentage=30;

六、 生产环境高可用考量

对于生产环境，仅完成基础安装是不够的，还需规划高可用和监控。

1. 部署 OBProxy
   OBProxy 是 OceanBase 的智能路由代理，对应用透明，提供读写分离、故障自动切换、连接池等功能。

   # 使用 OBD 部署 OBProxy
   # 在单独的配置文件中定义 OBProxy 节点，然后执行部署和启动
   obd cluster deploy obproxy-test -c obproxy.yaml
   obd cluster start obproxy-test
   

   应用应连接 OBProxy 的地址（默认端口 2883），而非直连 OBServer。

2. 配置监控与告警

   • OCP (OceanBase Cloud Platform)：官方的集中式管理平台，提供监控、告警、备份恢复、性能诊断等全套运维能力，是生产运维的首选。
   • Prometheus + Grafana：社区方案，通过 exporter 采集 OceanBase 指标，在 Grafana 中展示监控大盘。

3. 制定备份策略

   -- 1. 设置备份路径
   ALTER SYSTEM SET data_backup_dest='file:///obbackup/data';
   ALTER SYSTEM SET log_archive_dest='file:///obbackup/archive';
   
   -- 2. 开启日志归档
   ALTER SYSTEM ARCHIVELOG;
   
   -- 3. 发起一次全量备份（可配置定时任务）
   ALTER SYSTEM BACKUP DATABASE;
   

通过以上步骤，您就完成了 OceanBase 数据库从环境准备、自动化部署、初始化配置到基础验证的全过程。对于生产环境，务必在部署后详细测试高可用切换、备份恢复等关键场景，并建立完善的监控体系。

参考来源

• OceanBase 4.X-2F1A 仲裁高可用方案初探
• openclaw安装配置
• OpenClaw安装配置
• OpenClaw 安装配置指南
• 快速安装 OpenClaw：安装与配置指南
• OpenClaw（七）| Skills 安装与配置