Install OAT

This topic describes how to deploy OceanBase Admin Toolkit (OAT) in a Docker container.

Prerequisites

Before you deploy OAT, make sure that the following conditions are met:

• Your operating system meets the conditions described in the following table.

  Server type	Operating system	Supported version
  x86_64 or ARM aarch64	Red Hat Enterprise Linux (RHEL) and its compatible operating systems such as Rocky Linux and CentOS	7.2 and later
  x86_64 or ARM aarch64	Anolis and its compatible operating systems such as Alibaba Cloud Linux, Kylin V10, Unity Operating System (UOS), BC-Linux of China Mobile, Linx OS, and NFSChina	8.4 and later
  x86_64 or ARM AArch64	Debian and its compatible operating systems such as Ubuntu	11 and later
  x86_64 or ARM AArch64	openSUSE	12SP3 and later
  x86_64 or ARM AArch64	openSUSE	12SP3 and later
  x86_64 or ARM AArch64	Linx	V6.0.99 and later

• You have installed and started Docker. Docker Community Edition 17.03 or later is recommended. If you use the oat-all-in-one installation package to deploy OAT, the install.sh script in the package will automatically install Docker.

• The default port 7000 of OAT is not occupied.

Use the oat-all-in-one installation package to install OAT

The oat-all-in-one package provides images of Docker 18.09.9, OAT V4.2.0, MetaDB V4.2.1, and Network Load Balancer (NLB) 4.0.0, and software packages of common tools. To obtain the oat-all-in-one installation package, go to OceanBase Download Center and click a version based on your business requirements in the OceanBase Administrator Tool card. Then, perform the following steps to install OAT:

1. Decompress the oat-all-in-one installation package.

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

2. Run the installation script install.sh.

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

If Docker is not installed in your environment, this command automatically installs Docker, deploys OAT to Docker, and scans for existing images and tool packages. 3. Specify the root directory of Docker and the data directory, HTTP listening port, database port, and initial login password of OAT as prompted. You do not need to manually create the specified directories. By default, the HTTP listening port of OAT is 7000 and the database port of OAT is 3306. 4. Use the returned URL to access OAT and verify the availability of OAT.

Use the installation package to install OAT

1. Download the installation package of OAT.

   You need to contact OceanBase Technical Support to obtain the installation package.

2. Run the scp command to upload the OAT installation package to the server.

   oat_server specifies the IP address of the server on which OAT is deployed.

   scp oat.tgz <oat_server_user>@<oat_server_ip>:~/
   

3. Mount the OAT directory.

   Create a directory named /data_dir on the server to save persistent data of OAT.

   After the /data_dir directory is mounted to the OAT container, OAT automatically creates the /data_dir/logs, /data_dir/images, and /data_dir/db directories respectively for storing OAT system logs, Docker images of related components and services, and database files of OAT.

   mkdir -p /data_dir
   

4. Load the OAT installation package as an image.

   docker load -i oat.tar
   

5. Run the docker images command to obtain the tag of the OAT image.

   Note

   If only one OAT installation package is loaded, run the sample command. If multiple installation packages are loaded, run the docker images command to view the displayed content and connect the first two columns with a colon (:).

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

6. Run the docker run command to start OAT.

   docker run -d --net host --name oat  -v /data_dir:/data -e OAT_INITIAL_ADMIN_PASSWORD=xxx --restart on-failure:5 $oat_image
   

   Note

   • The default HTTP listening port of OAT is 7000. You can specify the -e HTTP_PORT=7001 parameter to modify the port.

   • You can specify the -e OAT_INITIAL_ADMIN_PASSWORD=xxx parameter to change the password of OAT.

   • By default, the built-in MariaDB of OAT listens on port 3306. You can specify the -e DB_PORT=3307 parameter to modify the port.

   • We recommend that you start OAT by specifying the --net host parameter because a container started in bridge mode can be affected by docker0 bridge failures or the ip_forward parameter of the operating system.

7. After OAT is started, enter http://<<oat_server_ip>:7000 in the address bar of the browser.

   If the login page appears, OAT is installed and started.