OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

A unified distributed database ready for your transactional, analytical, and AI workloads.

DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

OceanBase Admin Tool

V4.1.2

  • What's new
  • Product introduction
    • What is OAT?
    • Architecture
    • Concepts
  • Quick start
    • Install OAT
    • Get started with OAT
  • oatcli
  • Upgrade guide
  • User guide
    • Log on to OAT
    • Page layout of the OAT console
    • Servers
      • Add a server
      • Edit a server
      • Perform O&M operations on a server
      • Remove a server
      • Manage credentials
    • Product services
      • Install, upgrade, and uninstall OCP
      • Install, upgrade, and uninstall ODC
      • Install, upgrade, and uninstall OMS
      • Install, Upgrade, Modify, and Uninstall OB Sharding
      • Create and uninstall MetaDB
      • Create and uninstall OBDNS
      • Create and uninstall InfluxDB
      • Create and uninstall NLB
      • Create and uninstall OpenSearch
      • Install and uninstall OBLB
      • Take over OCP
      • Take over ODC
      • Take over OB Sharding
      • Take over OMS
      • Take over MetaDB
      • Take over OBDNS
      • Take over InfluxDB
      • Take over NLB
      • Manage images
      • Modify resources of products and components
      • Manage tools
      • Data refresh
    • System security
      • Task list
      • Package management
      • Manage users
      • Operation audit
  • FAQ

Download PDF

What's new What is OAT? Architecture Concepts Install OAT Get started with OAT oatcli Upgrade guide Log on to OAT Page layout of the OAT console Add a server Edit a server Perform O&M operations on a server Remove a server Manage credentials Install, upgrade, and uninstall OCP Install, upgrade, and uninstall ODC Install, upgrade, and uninstall OMS Install, Upgrade, Modify, and Uninstall OB Sharding Create and uninstall MetaDB Create and uninstall OBDNS Create and uninstall InfluxDB Create and uninstall NLB Create and uninstall OpenSearch Install and uninstall OBLB Take over OCP Take over ODC Take over OB Sharding Take over OMS Take over MetaDB Take over OBDNS Take over InfluxDB Take over NLB Manage images Modify resources of products and components Manage tools Data refresh Task list Package management Manage users Operation audit FAQ
OceanBase logo

The Unified Distributed Database for the AI Era.

Follow Us
Products
OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
Resources
DocsBlogLive DemosTraining & Certification
Company
About OceanBaseTrust CenterLegalPartnerContact Us
Follow Us

© OceanBase 2026. All rights reserved

Cloud Service AgreementPrivacy PolicySecurity
Contact Us
Document Feedback
  1. Documentation Center
  2. OceanBase Admin Tool
  3. V4.1.2
iconOceanBase Admin Tool
V 4.1.2
  • V 4.5.0
  • V 4.4.1
  • V 4.4.0
  • V 4.3.2
  • V 4.3.1
  • V 4.3.0
  • V 4.2.1
  • V 4.1.2

Create and uninstall MetaDB

Last Updated:2026-04-13 08:27:12  Updated
share
What is on this page
Prerequisites
Install MetaDB
Uninstall MetaDB
What to do next

folded

share

This topic describes how to create and uninstall MetaDB in the OceanBase Admin Toolkit (OAT) console.

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.
  • The server meets the requirements for installing MetaDB.

Install MetaDB

To install MetaDB, perform the following steps:

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

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

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

    The following table describes the basic parameters of 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 the MetaDB is to be installed.
    CPU The number of CPU cores allocated to the MetaDB. Default value: 32C.
    Memory The memory allocated to the MetaDB. Default value: 90G.
    MetaDB Cluster Name The name of the MetaDB cluster.
    root@sys Password The password of the root user of the sys tenant.
    Log Directory The log storage path of the MetaDB.

    The following table describes the installation path parameters of the MetaDB.

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

    The following table describes the startup parameters of the MetaDB.

    Parameter Description
    MySQL Port The MySQL port of the MetaDB. Default value: 2881.
    RPC Port The RPC port of the MetaDB. Default value: 2882.
    ODP Service Port The service port of the OceanBase Database Proxy (ODP). Default value: 2883.
    SSHD Port The SSHD port in the MetaDB container. Default value: 2022. OceanBase Cloud Platform (OCP) deploys the OCP Agent by connecting to the SSHD port.
    root Password The password of the root user in the MetaDB container.

    Note

    You can modify or add the startup parameters of MetaDB and ODP based on your business needs. For more information, see ODP parameters.

  4. After you set the parameters, click Submit.

    You can also click Reset to restore the default configurations.

Uninstall MetaDB

To uninstall MetaDB, perform the following steps:

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

  2. Find the target MetaDB service and click Uninstall in the Operation column.

    You can also search for the service by name.

  3. In the confirmation dialog box that appears, click Uninstall.

    OAT displays a message indicating that the service is being uninstalled. OAT also creates an uninstall task. In the confirmation dialog box that appears, you can click the task ID to view the task progress.

    Notice

    If MetaDB is associated with another product, the uninstall will fail.

What to do next

After you install MetaDB, you can install other products in the OceanBase ecosystem.

Previous topic

Install, Upgrade, Modify, and Uninstall OB Sharding
Last

Next topic

Create and uninstall OBDNS
Next
What is on this page
Prerequisites
Install MetaDB
Uninstall MetaDB
What to do next