安装 OAT

安装 OAT

更新时间：2026-06-15 15:55:31

本文介绍如何 Docker 部署 OAT。

前提条件

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

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

服务器类型	操作系统	支持版本
x86_64/ARM aarch64	RHEL (及兼容的 RockyLinux、CentOS 等)	7.2 及以上版本
x86_64/ARM aarch64	Anolis (及兼容的 Alibaba Cloud Linux、麒麟V10、统信UOS、中国移动 BC-Linux、凝思OS、中科方德等)	8.4 及以上版本
x86_64/ARM aarch64	Debian (及兼容的 Ubuntu 等)	11 及以上
x86_64/ARM aarch64	openSUSE	12SP3 及以上
x86_64/ARM aarch64	openSUSE	12SP3 及以上
x86_64/ARM aarch64	凝思	V6.0.99 及以上

如果使用 OAT 镜像包进行安装需要您已经安装并启动 Docker。推荐 Docker 版本为社区版 18.09.9 及以上。

注意

如果您使用 oat-all-in-one 安装包部署 OAT，oat-all-in-one 的 install.sh 脚本将自动安装 Docker，您无需再单独安装 Docker。
OAT 的默认端口 7000 未被占用。

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

说明

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

按照以下步骤安装 OAT：

请联系技术支持获取 OAT 的 oat-all-in-one 安装包。
解压 oat-all-in-one 安装包。

示例如下：
```
tar -xf oat-all-in-one-arm-xxx.tar
```
运行安装脚本 install.sh。

示例如下：
```
sh oat-all-in-one-arm/install.sh
```
运行此命令将自动安装 Docker (如果您的环境没有 Dcoker)，部署 OAT 并扫描 oat-all-in-one 中包含的镜像和工具软件包。
根据提示，依次确认以下信息：
1. 请输入 Docker 的根目录（建议设置为单独挂载的目录），默认值 /docker（无需手动创建这个目录），可自定义。如果已安装 Docker，会跳过此步骤。
2. 请输入 OAT 数据目录的路径，默认值 /oat_data（无需手动创建这个目录），可自定义。
3. 请输入 OAT HTTP 监听端口，默认值 7000，可自定义。
4. 请输入 OAT 数据库端口，默认值 3306，可自定义。
5. 请输入 OAT 管理员账户密码（设置初始登录密码），可自定义。
6. 根据返回的 URL 访问 OAT，验证 OAT 服务的可用性。
示例如下：

说明

因为服务器已安装了 Docker，所以本次安装跳过了安装 Docker 的步骤。
1. OAT 数据目录的路径，修改为 /data/oat_data，然后回车。
```
Input the OAT data dir: /data/oat_data
```
2. OAT HTTP 监听端口使用默认值，直接回车。
```
Input the OAT HTTP listen port: 7000
```
3. OAT 数据库端口使用默认值，直接回车。
```
Input the OAT database port: 3306
```
4. OAT 管理员 admin 用户密码（初始登录密码）修改后，回车。
```
Input the OAT admin user password(login password): ******
```
5. 根据返回的 URL 访问 OAT，验证 OAT 服务的可用性。
  
  返回结果如下：
```
Start prepare docker
Docker is already exists, start check...
Already installed docker check healthy, skip install docker
Start prepare OAT
Loaded image: xxx/oceanbase/oat:x.x.x_20241025_arm
45fd5a9b31b0af6aeb07b3e485503ad4c64629170b91d1d3c9e8128e8e532125
check OAT url http://127.0.0.1:7000/hc
OAT API not ready, please wait, sleep 5s retry...
OAT API not ready, please wait, sleep 5s retry...
OAT API not ready, please wait, sleep 5s retry...
OAT API not ready, please wait, sleep 5s retry...
OAT API not ready, please wait, sleep 5s retry...
OAT API not ready, please wait, sleep 5s retry...
OAT API ready
Copy images and binary_packages to OAT data dir
Trigger OAT scan api to find images and binary_packages
Trigger scan task success, please visit OAT web site and wait for scan task finished
OAT is ready for visit
url is: http://<current_ip>:7000
user/password is: admin/******
```

说明

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

使用 OAT docker image 安装 OAT

获取 OAT 安装包。

注意

请联系 OAT 技术支持人员获取安装包。
使用 scp 命令将 OAT 安装包上传到服务器中。

其中 oat_server 为部署 OAT 的服务器的 IP 地址。
```
scp oat.tgz <oat_server_user>@<oat_server_ip>:~/
```
示例如下：
```
scp oat_x.x.x_20241025_arm.tgz root@xxx.xxx.xxx.xxx:/home/admin/oat_rpm
```
挂载 OAT 目录。

在服务器创建 /data_dir 目录（可自定义路径，以 /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_xxx_xxxxxxxx_xxx.tgz

其中 oat_xxx_xxxxxxxx_xxx.tgz 为安装包的名称。

示例如下：

docker load -i oat_x.x.x_20241025_arm.tgz

返回结果如下：

Loaded image: xxx/oceanbase/oat:x.x.x_20241025_arm

使用 docker images 命令获取 OAT 镜像的标签。

说明

当只加载了一个 OAT 安装包时，使用示例命令即可。当加载了多个安装包时，使用 docker images 命令查看显示内容，并使用冒号（:）连接前两列的内容。
```
oat_image=`docker images | grep oat | awk '{printf $1":"$2"\n"}'`
```
运行 docker run 命令，启动 OAT。

其中 $oat_image 是 OAT 镜像的标签。
```
docker run -d --net host --name oat  -v /data_dir:/data -e OAT_INITIAL_ADMIN_PASSWORD=xxx --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 影响。
示例如下：
```
docker run -d --net host --name oat -v /data_dir:/data -e OAT_INITIAL_ADMIN_PASSWORD=****** --restart on-failure:5 $oat_image
```
返回结果如下：
```
490344724bfcb2801da271196ebc38b5c15547b796178dc7660553ae62b668c2
```
启动成功后，在浏览器地址栏输入 http://<oat_server_ip>:7000。

其中 <oat_server_ip> 替换为部署 OAT 的服务器的 IP 地址。

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

前提条件

注意

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

说明

说明

说明

使用 OAT docker image 安装 OAT

注意

说明

说明