安装 OAT

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 安装包。

   详情可参考 准备安装介质。

2. 使用 scp 命令将 OAT 安装包上传到服务器中。

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

   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 的数据库文件。

   mkdir -p /data_dir
   

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

   docker load -i oat_xxx_xxxxxxxx_xxx.tgz
   

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

   说明

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

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

6. 运行 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 影响。

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

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

   说明

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

参考文档

安装 OAT