安装 OAT | OceanBase 文档中心

安装 OAT

更新时间：2026-06-15 15:25:34

本文介绍如何 Docker 部署 OAT。

前提条件

在部署 OAT 之前，您需要确认以下信息：

您的操作系统满足以下条件：

服务器类型	操作系统	支持版本
x86_64	RHEL	7.2 及以上版本
x86_64	CentOS	7.2 及以上版本
x86_64	AliOS	7.2 及以上版本
x86_64	openSUSE	12SP3 及以上
x86_64	统信 UOS	V20
ARM aarch64	AliOS	7.2 及以上版本
ARM aarch64	中标麒麟	7.6
ARM aarch64	华为 EulerOS	2.0 SP8
ARM aarch64	统信 UOS	V20

您已经安装并启动 Docker。推荐 Docker 版本为社区版 17.03 及以上。如果您使用 all-in-one 安装包安装 OAT，all-in-one 的 install.sh 脚本将自动安装 Docker。
OAT 的默认端口 7000 未被占用。

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

说明

推荐您使用 oat-all-in-one 安装包安装 OAT。

按照以下步骤安装 OAT：

请联系技术支持获取 OAT 的 oat-all-in-one 安装包。
解压 oat-all-in-one 安装包。
```
tar -xf oat-all-in-one-x86.tar
```
运行安装脚本 install.sh。
```
sh oat-all-in-one-x86/install.sh
```
运行此命令将自动安装 Docker (如果您的环境没有 Dcoker)，部署 OAT 并扫描已有的镜像和工具软件包。
根据提示，输入 docker root dir 和 OAT data dir（无需手动创建这两个目录）、OAT HTTP listen port（默认 7000）、 OAT database port（默认 3306）和 OAT 初始密码等设置。
根据返回的 URL 访问 OAT，验证 OAT 服务的可用性。

说明

install.sh 脚本启动 OAT 容器默认使用 --net host（主机网络模式）。如您需要配置为其他网络模式，请下载 OAT 容器手动启动。
x86（arrch64）版本的 oat-all-in-one 默认只包含 x86（aarch64）和 noarch 的镜像和软件包，如需 aarch64（x86）架构，请自行下载拷贝到 OAT 容器挂载的对应目录，然后发起扫描任务进行添加。

使用 OAT 安装包安装

下载 OAT 安装包。

您需要联系 OceanBase 的技术人员下载安装包。
使用 scp 命令将 OAT 安装包上传到服务器中。

其中 oat_server 为部署 OAT 的服务器的 IP 地址。
```
scp oat.tgz <oat_server_user>@<oat_server_ip>:~/
```
挂载 OAT 目录。

在服务器创建 /data_dir 目录用来保存 OAT 的持久化数据。

在 /data_dir 目录被挂载到 OAT 容器后，OAT 会自动创建 /data_dir/logs、/data_dir/images 和 /data_dir/db 目录，分别用于存放 OAT 的系统日志、组件和产品的 Docker 镜像以及 OAT 的数据库文件。
```
mkdir -p /data_dir
```
将 OAT 安装包装载为镜像。
```
docker load -i oat.tar
```
用 docker images 命令获取 OAT 镜像的标签。

说明

当只加载了一个 OAT 安装包时，使用示例命令即可。当加载了多个安装包时，使用 docker images 命令查看显示内容，并使用冒号（:）连接前两列的内容。
```
oat_image=`docker images | grep oat | awk '{printf $1":"$2"\n"}'`
```
运行 docker run 命令，启动 OAT。
```
 docker run -d --net host --name oat -v /data_dir:/data --restart on-failure:5 $oat_image
```
说明
- OAT 的 HTTP 服务默认监听 7000 端口，可以指定 -e HTTP_PORT=7001 参数修改为其他端口。
- 可以指定 -e OAT_INITIAL_ADMIN_PASSWORD=xxx 参数修改 OAT 的密码。
- OAT 内置了 MariaDB 作为数据存储，默认监听 3306 端口，可以指定 -e DB_PORT=3307 参数修改为其他端口。
- 建议使用 --net host 参数启动，因为 bridge 网络模式启动的容器可能被 docker0 网桥故障或操作系统参数 ip_forward 影响。
启动成功后，在浏览器地址栏输入 http://<<oat_server_ip>:7000。

如果在浏览器窗口中看到登录界面，表示已经成功安装并启动 OAT。