安装并配置 OBD | OceanBase 文档中心

安装并配置 OBD

更新时间：2026-04-14 17:56:04

本文介绍如何安装 OBD，以及安装成功后如何配置 OBD。

安装 OBD

使用 RPM 包安装

在线安装

若您的机器可以连接网络，在 CentOS 或 RedHat 系统上，您可执行以下命令在线安装 OBD。

[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

说明

YUM 命令默认安装最新版本，您可通过声明版本号安装指定版本，如使用 yum install -y ob-deploy-1.6.2 命令安装 OBD V1.6.2，推荐安装最新版本。

离线安装

若您的机器无法连接网络，您可从 OceanBase 软件下载中心下载所需版本的 OBD。下载完成后，将 OBD 复制到您的中控机器上。推荐您使用最新版本的安装包。

在 CentOS 或 RedHat 系统上，执行如下命令安装 OBD：

sudo yum install ob-deploy-*.rpm

在 Ubuntu 或 Debian 系统上，执行如下命令安装 OBD：

sudo alien --scripts -i ob-deploy-*.rpm

使用 all-in-one 安装包安装 OBD

OceanBase 从 V4.0.0 开始提供统一的安装包 all-in-one package。您可以通过这个统一的安装包一次性完成 OBD、OceanBase 数据库、ODP、OBAgent、Grafana、Prometheus 和 OCP Express（自 V4.1.0 起支持）的安装。

在线安装

若您的机器可以连接网络，可执行如下命令在线安装。

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

离线安装

若您的机器无法连接网络，可参考如下步骤离线安装。

从 OceanBase 软件下载中心下载最新的 all-in-one 安装包，并将其复制到中控机中。推荐使用最新版本的安装包

在安装包所在目录下执行如下命令解压安装包并安装。

[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

使用源码安装

在使用源码安装 OBD 之前，请您确认已安装以下依赖：

gcc
wget
python-devel
openssl-devel
xz-devel
mysql-devel

源码编译安装 OBD 需要使用到 Python 2.7 环境和 Python 3.8 环境。安装步骤如下：

在 Python 2.7 环境下执行以下命令。
```
sh rpm/build.sh executer
```
说明

上述命令是为了编译 OceanBase 数据库升级所需的解释器，如果不使用升级功能可以跳过该命令。

在 Python3.8 环境下执行以下命令。

sh rpm/build.sh build_obd
source /etc/profile.d/obd.sh

说明

OBD 自 V2.0.0 开始不支持在 Python2 环境下使用源码安装。

配置 OBD

在线配置

OBD 自带仓库信息，当机器可以连接网络时，无须配置，执行 obd mirror list 命令即可查看 OBD 仓库中的软件。

# 查看 OBD 仓库信息
[admin@test001 ~]$ obd mirror list
+-----------------------------------------------------------------------------+
|                            Mirror Repository List                           |
+----------------------------+--------+---------+----------+------------------+
| SectionName                | Type   | Enabled | Avaiable | Update Time      |
+----------------------------+--------+---------+----------+------------------+
| oceanbase.community.stable | remote | True    | True     | 2023-03-20 11:21 |
| oceanbase.development-kit  | remote | True    | True     | 2023-03-20 11:21 |
| local                      | local  | -       | True     | 2023-03-20 11:23 |
+----------------------------+--------+---------+----------+------------------+
Use `obd mirror list <section name>` for more details
Trace ID: 8a4da3a0-c6ce-11ed-91cc-00163e030166
If you want to view detailed obd logs, please run: obd display-trace 8a4da3a0-c6ce-11ed-91cc-00163e030166
# 查看对应仓库中的软件信息
[admin@test001 ~]$ obd mirror list oceanbase.community.stable
Update OceanBase-community-stable-el7 ok
Update OceanBase-development-kit-el7 ok
+--------------------------------------------------------------------------------------------------------------------------------------------------+
|                                                     oceanbase.community.stable Package List                                                      |
+-----------------------------------+---------+------------------------+--------+------------------------------------------------------------------+
| name                              | version | release                | arch   | md5                                                              |
+-----------------------------------+---------+------------------------+--------+------------------------------------------------------------------+
| grafana                           | 7.5.17  | 1                      | x86_64 | f0c86571a2987ee6338a42b79bc1a38aebe2b07500d0120ee003aa7dd30973a5 |
| libobclient                       | 2.0.0   | 1.el7                  | x86_64 | 7bbb2aeb9c628ee35c79d6dc2c1668ebbf97a3323f902e8fd33ff1a5ea95220f |
| libobclient                       | 2.0.0   | 2.el7                  | x86_64 | 6c1587b80df64b68343479aecddb0ca912d5ccd3d085cb41c7a37a1e38effc34 |
| libobclient                       | 2.0.1   | 3.el7                  | x86_64 | 4f92926496dec89936422f41f2f2206eb61c5e62e7b0dde1006c6e02eaebec6e |
| libobclient                       | 2.0.2   | 2.el7                  | x86_64 | eed33520e6911140dad65197cff53652310609ab79d7960ec4d2d6d4b2318ba7 |
# 省略后续输出

离线配置

当您的机器无法连接网络时，您需提前下载好所需软件的安装包，并将其添加到 OBD 的本地仓库。

下载地址：

说明

请根据实际需求下载软件包，建议使用最新版本的软件。

将安装包添加到本地仓库

在部署运行 OBD 的操作系统用户下按照如下步骤操作，示例中使用的是用户 admin。

执行如下命令禁用远程仓库
```
obd  mirror disable remote
```
禁用后可通过 obd mirror list 命令进行确认，查看 Type=remote 对应的 Enabled 变成了 False，说明已关闭远程镜像源
在安装包所在目录执行如下命令将下载好的安装包上传到本地仓库
```
obd mirror clone *.rpm
```
查看本地仓库的安装包列表
```
obd mirror list local
```
在输出的列表中查看到部署所需安装包即表示上传成功。