---
title: "安装 OAT - 云平台 OCP V4.5.0 | OceanBase 文档中心"
description: 安装 OAT OCP 支持通过 OAT（OceanBase 生态产品的自动化部署工具）进行白屏化部署。在部署 OCP 前，您需先安装好 OAT。 前提条件 在部署 OAT 之前，您需要确认以下信息： 您的操作系统满足以下条件： 服务器类型 操作系统 支持版本 x86_64/ARM aarch64 RHEL (及兼容的…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.5.0

# 安装 OAT

更新时间：2026-08-03 16:09:20

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.5.0/zh-CN/300.deployment-guide/100.deploying-enterprise-ocp/200.prepare-the-deployment-environment/100.install-oat.md)  

OCP 支持通过 OAT（OceanBase 生态产品的自动化部署工具）进行白屏化部署。在部署 OCP 前，您需先安装好 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 | 凝思 | V6.0.99 及以上 |
 - 您已经安装并启动 Docker，推荐 Docker 版本为社区版 18.09.9 及以上。
 - OAT 的默认端口 7000 未被占用。

## 操作步骤

1. 下载 OAT 安装包。

   详情可参考 [准备安装介质](https://www.oceanbase.com/docs/common-ocp-1000000006645327)。
 2. 使用 `scp` 命令将 OAT 安装包上传到服务器中。

   其中 `oat_server` 为部署 OAT 的服务器的 IP 地址。

   ```shell
   scp <oat_directory> <oat_server_user>@:<oat_server_ip>

   ```
 3. 挂载 OAT 目录。

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

   在 `/data_dir` 目录被挂载到 OAT 容器后，OAT 会自动创建 `/data_dir/logs`、`/data_dir/images` 和 `/data_dir/db` 目录，分别用于存放 OAT 的系统日志、组件和产品的 Docker 镜像以及 OAT 的数据库文件。

   ```shell
   mkdir -p /data_dir

   ```
 4. 将 OAT 安装包装载为镜像。其中 `oat_xxx_xxxxxxxx_xxx.tgz` 为安装包的名称。

   ```shell
   docker load -i oat_xxx_xxxxxxxx_xxx.tgz

   ```
 5. 用 `docker images` 命令获取 OAT 镜像的标签。

   #### 说明

   当只加载了一个 OAT 安装包时，使用示例命令即可。当加载了多个安装包时，使用 docker images 命令查看显示内容，并使用冒号（:）连接前两列的内容。

   ```shell
   oat_image=`docker images | grep oat | awk '{printf $1":"$2"\n"}'`

   ```
 6. 运行 `docker run` 命令，启动 OAT。其中 `$oat_image` 是 OAT 镜像的标签。

   ```shell
   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` 影响。
 7. 启动成功后，在浏览器地址栏输入 `http://<oat_server_ip>:7000`。其中 `<oat_server_ip>` 需替换为部署 OAT 的服务器的 IP 地址。

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

   #### 说明

   OAT 默认用户名及密码可联系技术支持获取，首次登录后您必须修改该默认密码。

## 参考文档

[安装 OAT](https://www.oceanbase.com/docs/enterprise-oat-doc-cn-1000000005282164)

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线