本文介绍如何 Docker 部署 OAT。

前提条件

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

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

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

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

• OAT 的默认端口 7000 未被占用。

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

oat-all-in-one 安装包提供了 Docker 18.09.9，OAT 4.1.0，MetaDB 2.2.77、NLB 3.5.1 镜像及常用工具软件包。您可以从 OceanBase 官网的下载中心 获取 OAT 的 oat-all-in-one 安装包。 按照以下步骤安装 OAT：

1. 解压 oat-all-in-one 安装包。

tar -xf oat-all-in-one-x86.tar

1. 运行安装脚本 install.sh。

sh oat-all-in-one-x86/install.sh

运行此命令将自动安装 Docker (如果您的环境没有 Dcoker)，部署 OAT 并扫描已有的镜像和工具软件包。 3. 根据提示，输入 docker root dicr 和 OAT data dir（无需手动创建这两个目录）、OAT HTTP listen port（默认 7000）、 OAT database port（默认 3306）和 OAT 初始密码（默认 aaAA11__）等设置。 4. 根据返回的 URL 访问 OAT，验证 OAT 服务的可用性。

使用 OAT 安装包安装

1. 下载 OAT 安装包。

   您需要联系 OceanBase 的技术人员下载安装包。

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

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

   scp oat.tgz <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 安装包装载为镜像。

   docker load -i oat.tar
   

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

   说明

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

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

6. 运行 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 参数修改为其他端口。

   • OAT 的默认密码为 aaAA11__，可以指定 -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。

   说明

   如果您在启动 OAT 时添加了环境变量配置 `docker run -e OAT_INITIAL_ADMIN_PASSWORD=xxx`，则 OAT 密码为您设置的密码。 如果您未指定 `-e` 参数，则 OAT 默认用户名为 admin，默认密码为 aaAA11__。首次登录后您必须修改密码。