Create MetaDB

As a service provided by OceanBase Database, MetaDB is deployed in containers and has a built-in OceanBase Database Proxy (ODP) to support direct access to OceanBase Database. It stores the metadata of OceanBase Cloud Platform (OCP), OceanBase Developer Center (ODC), and OceanBase Migration Service (OMS).

This topic describes how to create MetaDB by using OceanBase Admin Toolkit (OAT).

Prerequisites

Before you create MetaDB, ensure that:

• You have installed OAT. For more information, see Deploy OAT.
• You have logged on to OAT by using a super administrator account or an account with O&M permissions. For more information, see Manage users.
• You have added the server where MetaDB is to be installed. For more information, see Add a server.

Procedure

1. In the left-side navigation pane, choose Product Service > Components.

2. On the Components Management page, click Create Component in the upper-right corner, and choose Create MetaDB.

   Parameter	Description
   MetaDB Image	The Docker image of MetaDB.
   Component Name	The name of the component, which must be unique. Default value: metadb.
   Server	The IP address of the server where MetaDB is to be installed.
   Custom Zone	The zone name and addresses of the IDC, server, and RootServer. Notice If you choose to specify this parameter, the Server parameter is automatically hidden.
   Configure the quorum service	Specify whether to enable the arbitration service. When you enable the arbitration service, you must enter the IP address of the arbitration service, for example, xxx.xxx.xxx.xxx:xxxx. Notice You can configure the arbitration service only if you set the MetaDB Image parameter to a version of MetaDB V4.X.
   CPU	The number of CPU cores allocated to MetaDB. Default value: 32C. Note If the OCP server has 16 CPU cores and 32 GB of memory, we recommend that you set CPU to 8C for MetaDB.
   Memory	The memory allocated to MetaDB. Default value: 90GB. Note If the OCP server has 16 CPU cores and 32 GB of memory, we recommend that you set Memory to 16G for MetaDB.
   MetaDB Cluster Name	The name of the MetaDB cluster.
   root@sys Password	The password of the root user of the sys tenant in the MetaDB cluster.

3. On the Create MetaDB page, specify the parameters in the Basic Configurations section.

   Parameter	Description
   MetaDB Image	The Docker image of MetaDB.
   Component Name	The name of the component, which must be unique. Default value: metadb.
   Server	The IP address of the server where MetaDB is to be installed.
   CPU	The number of CPU cores allocated to MetaDB. Default value: 32C. Note If the OCP server has 16 CPU cores and 32 GB of memory, we recommend that you set CPU to 8C for MetaDB.
   Memory	The memory allocated to MetaDB. Default value: 90GB. Note If the OCP server has 16 CPU cores and 32 GB of memory, we recommend that you set Memory to 16G for MetaDB.
   MetaDB Cluster Name	The name of the MetaDB cluster.
   root@sys Password	The password of the root user of the sys tenant in the MetaDB cluster.

4. On the Create MetaDB page, specify the parameters in the Installation Path (Optional) section.

   The following table describes the installation path parameters that you can specify when you create MetaDB.

   Parameter	Description
   Installation Directory	The installation path of MetaDB. Default value: /home/admin/oceanbase.
   Data Directory	The data storage path of MetaDB. Default value: /data/1.
   Log Directory	The log storage path of the MetaDB. Default value: /data/log1.
   Backup Directory	The backup path of MetaDB. By default, this parameter is left empty. This parameter is optional.

5. On the Create MetaDB page, specify the parameters in the Startup Parameters (Optional) section.

   Notice

   If the OCP server has 16 CPU cores and 32 GB of memory and you have configured 8 CPU cores and 16 GB of memory for MetaDB, you need to set the system_memory parameter to 5G and resource_hard_limit to 150 in the OB Process Startup Parameters (Optional) area.

   The following table describes the startup parameters that you can specify when you create MetaDB.

   Parameter	Description
   MySQL Port	The MySQL port of MetaDB. Default value: 2881.
   RPC Port	The RPC port of MetaDB. Default value: 2882.
   OB Process Startup Parameters (Optional)	You can modify or add startup parameters of the observer process as needed.
   OB Proxy Service Port	The service port of the ODP. Default value: 2883.
   OB Proxy Process Startup Parameters (Optional)	You can modify or add the startup parameters of the obproxy process as needed. For more information, see Parameter description.
   SSHD Port	The SSHD port in the MetaDB container. Default value: 2022. OCP deploys the OCP Agent by connecting to the SSHD port.
   root Password	The password of the root user in the MetaDB container.

6. After you set the parameters, click Submit.

   You can also click Reset to restore the default configurations.

What to do next

After you install MetaDB, you can install the OceanBase ecosystem tools, including OCP, ODC, OMS, and OB Sharding.

References

Create and uninstall MetaDB