Create MetaDB

Before you deploy OceanBase Cloud Platform (OCP), you must create the MetaDB component for OCP in OceanBase Admin Toolkit (OAT). If you want to use a deployed MetaDB, you can take it over to OAT. For more information, see Take Over MetaDB.

This topic describes how to create MetaDB in OAT.

Prerequisites

Before you create MetaDB, make sure that:

• You have installed and logged on to OAT as a super administrator or an O&M engineer. For more information, see Install OAT.
• You have added the server where MetaDB is to be installed. For more information, see Add a server.
• Your server meets the resource requirements for installing MetaDB.

Procedure

1. Log on to OAT.

2. In the left-side navigation pane, choose Product Service > Component Management.

3. On the Component Management page, click Create a component in the upper-right corner and then select Create MetaDB.

   

4. On the Create MetaDB page, specify related parameters.

   1. Specify the basic information of MetaDB.

      Parameter	Description
      MetaDB image	The Docker image file of MetaDB. Click Manage image files in the drop-down list. In the panel that appears, select Local scan or Remote connection as the mode for adding an image file. The Local scan mode is recommended. You need to upload the image file to the /data/images directory of the OAT container. If the host directory is mounted when OAT is started, you can directly copy the MetaDB image to the directory to which the host is mapped. The Remote connection mode applies when the image repository can be accessed. Enter the address of the Docker repository in Image Repository, such as reg.docker.alibaba-inc.com/xxx/xxx. Enter the image version in Image label, such as 3.3.9-x64. Select an architecture in Architecture as needed.
      Component name	The name of the component, which must not be the same as that of any other components. Default value: metadb.
      Server	The IP address of the server where MetaDB is to be installed. You can specify multiple server IP addresses. If so, a MetaDB will be installed on each server.
      CPU	The number of CPU cores on the server for MetaDB. Default value: 32C.
      Memory	The size of memory on the server for MetaDB. Default value: 90GB.
      MetaDB cluster name	The name of the MetaDB cluster.
      root@sys password	The password of the root user of the sys tenant.

      

   2. Optional. Configure the installation path of MetaDB.

      Parameter	Description
      Installation directory	The installation path of MetaDB. Default value: /home/admin/oceanbase. You can change the value.
      Data Directory	The data storage path of MetaDB. Default value: /data/1. You can change the value.
      Log Directory	The log storage path of MetaDB. Default value: /log/1. You can change the value.
      Backup Directory	Optional. The backup path of MetaDB. By default, this parameter is unspecified. You can specify a directory.

      

   3. Optional. Configure the startup parameters of MetaDB.

      Parameter	Description
      MySQL Port	The MySQL port of MetaDB. Default value: 2881.
      RPC Port	The RPC port of MetaDB. Default value: 2882.
      OBProxy service port	The service port of OBProxy. Default value: 2883.
      SSHD Port	The SSHD port in the MetaDB container. Default value: 2022. OCP connects to the SSHD port to deploy OCP Agent.
      root Password	The password of the root user in the MetaDB container.

      

      Note

      • The CPU and memory resources required by MetaDB are the sum of MetaDB resources, MonitorDB resources, resources of the sys tenant, the system memory, and resources of OBProxy. When you allocate resources to MetaDB, we recommend that you reserve a certain margin. This is because the sys tenant itself will also consume resources.
      • When you configure the installation path of MetaDB, make sure that the data directory, installation directory, and log directory are empty, and that the owner of these directories is admin.
      • Make sure that MetaDB images in the same MetaDB cluster use the same hardware architecture. At present, OAT does not support heterogeneous MetaDB images.
      • To deploy a multi-node MetaDB, you can specify multiple server IP addresses in the Server field when you configure basic MetaDB information.****

5. Click Submit. For any errors in configurations, click Reset to restore the default configurations.

6. Choose System and Security > Task list. On the task list page that appears, click the task name to view the task details.