MetaDB is an OceanBase Database service deployed in containers, with a built-in OceanBase Proxy for direct external access. It can be used for metadata storage of OceanBase Cloud Platform (OCP), OceanBase Developer Center (ODC), OceanBase Migration Service (OMS), and other products.
This topic describes how to create MetaDB by using OceanBase Admin Toolkit (OAT).
Note
- This topic uses OAT V4.2.0 as an example. The GUI may vary with the OAT version.
- We recommend that you create a separate tenant in OceanBase Database for MetaDB. MetaDB stores persistent data other than monitoring data. We recommend that you allocate at least 4 CPU cores and 8 GB of memory to MetaDB.
- The disk capacity is affected by factors such as the size of OCP-managed clusters, stored file resources, and data retention period. We generally recommend at least 100 GB of disk space.
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
In the left-side navigation pane, click Product Service > Components to open the Components Management page. Click Create Component in the upper-right corner and select Create MetaDB.
On the Create MetaDB page, configure Basic Configuration.
Parameter Description MetaDB Image The Docker image of MetaDB. Component Name The name of the component. It must be unique. Default value: metadb.Server The IP address of the server where MetaDB is to be installed. Custom Zone Enable to specify Zone name, IDC, server, and Root Server location. Notice
This parameter and the Server parameter are mutually exclusive. When Custom Zone is enabled, the Server parameter is automatically hidden.
Configure Arbitration Service Enable or disable as needed. When enabled, enter the arbitration service address, for example, xxx.xxx.xxx.xxx:xxxx. Notice
You can configure the arbitration service only when a MetaDB image of V4.X is selected.
CPU The CPU cores available to MetaDB on the server. Default: 32C.Note
If the OCP server has 16 CPU cores and 32 GB of memory, we recommend that you set the CPU available to MetaDB to 8C.
Memory The memory available to MetaDB on the server. Default: 90GB.Note
If the OCP server has 16 CPU cores and 32 GB of memory, we recommend that you set the memory available to MetaDB to 16 GB.
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. On the Create MetaDB page, configure Installation path (optional).
The installation path parameters for creating MetaDB are as follows:
Parameter Description Installation directory The installation path of MetaDB. Default: /home/admin/oceanbase.Data directory The data storage path of MetaDB. Default: /data/1.Log directory The log storage path of MetaDB. Default: /data/log1.Backup directory (optional) The backup path of MetaDB. Default: empty. On the Create MetaDB page, configure Startup parameters (optional).
Notice
If the OCP server has 16 CPU cores and 32 GB of memory, and you have set MetaDB to use 8 CPU cores and 16 GB of memory, you need to set the
system_memoryparameter to 5G andresource_hard_limitto 150 in the observer process startup parameters.The startup parameters for creating MetaDB are as follows:
Parameter Description MySQL port The MySQL port of MetaDB. Default: 2881.RPC port The RPC port of MetaDB. Default: 2882.OB process startup parameters (optional) You can modify or add observer process startup parameters as needed. OB Proxy service port The service port of OBProxy. Default: 2883.OB Proxy process startup parameters (optional) You can modify or add OBProxy process startup parameters as needed. For more information, see OBProxy parameter description. SSHD port The SSHD port in the MetaDB container. Default: 2022. OCP deploys the OCP Agent by connecting to the SSHD port.root password The password of the root user in the MetaDB container. After configuring MetaDB, click Submit.
If your configuration is incorrect, click Reset to restore the default configuration.
What to do next
After MetaDB is installed, you can install OceanBase ecosystem tools such as OCP, ODC, OMS, and OB Sharding.