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 Deployer

V3.2.1Community Edition

  • What is obd
  • Quick Start
    • Install obd
    • Quickly deploy OceanBase Database
    • Quickly deploy OCP
  • obd Command
    • Quick deployment command
    • Cluster commands
    • Mirror and repository commands
    • Testing commands
    • Tool commands
    • obdiag commands
    • Binlog commands
    • Host commands
    • License commands
    • Password commands
    • Telemetry commands
  • User Guide
    • Overview
    • Deploy through GUI
      • GUI operation overview
      • Mode configuration rules
      • Deploy an OceanBase cluster on the GUI
      • Deploy OCP through the GUI
      • Modify components on the GUI
      • Upgrade OCP on the GUI
    • Deploy through CLI
      • Configuration files
      • Deploy Component
        • Deploy OceanBase Database on a single OBServer node
        • Deploy OCP Express by using commands
        • Deploy and use obconfigserver
        • Deploy the obbinlog
        • Deploy oblogproxy by using the CLI
        • Deploy OCP by using commands
      • Manage Cluster
        • Physical Standby Database
          • Deploy primary and standby tenants by using obd
          • Switch the roles of tenants and decouple a standby tenant from the primary tenant
        • Scale out a cluster and change cluster components
        • Performance test
        • Cluster diagnotistics
        • Add GUI-based monitoring for an existing cluster
      • Takeover Cluster
        • Use OCP to take over a cluster deployed by obd
        • Use obd to take over a cluster
      • Upgrade Component
        • Upgrade OceanBase Database
        • Upgrade ODP
        • Upgrade OCP Express
      • Backup and restore
  • Upgrade obd
  • FAQ
  • Error codes
  • Release Notes
    • Version rules
    • V3.2
      • OceanBase Deployer V3.2.2
      • OceanBase Deployer V3.2.1
      • OceanBase Deployer V3.2.0
    • V3.1
      • OceanBase Deployer V3.1.2
      • OceanBase Deployer V3.1.1
      • OceanBase Deployer V3.1.0
    • V3.0
      • OceanBase Deployer V3.0.1
      • OceanBase Deployer V3.0.0
    • V2.10
      • OceanBase Deployer V2.10.1
      • OceanBase Deployer V2.10.0
    • V2.9
      • OceanBase Deployer V2.9.2
      • OceanBase Deployer V2.9.1
      • OceanBase Deployer V2.9.0
    • V2.8
      • OceanBase Deployer V2.8.0
    • V2.7
      • OceanBase Deployer V2.7.0
    • V2.6
      • OceanBase Deployer V2.6.2
      • OceanBase Deployer V2.6.1
      • OceanBase Deployer V2.6.0
    • V2.5
      • OceanBase Deployer V2.5.0
    • V2.4
      • OceanBase Deployer V2.4.0
    • V2.3
      • OceanBase Deployer V2.3.1
      • OceanBase Deployer V2.3.0
    • V2.2
      • OceanBase Deployer V2.2.0
    • V2.1
      • OceanBase Deployer V2.1.1
      • OceanBase Deployer V2.1.0
    • V2.0
      • OceanBase Deployer V2.0.1
      • OceanBase Deployer V2.0.0
    • V1.6
      • OceanBase Deployer V1.6.2
      • OceanBase Deployer V1.6.1
      • OceanBase Deployer V1.6.0
    • V1.5
      • OceanBase Deployer V1.5.0
    • V1.4
      • OceanBase Deployer V1.4.0
    • V1.3
      • OceanBase Deployer V1.3.3
      • OceanBase Deployer V1.3.2
      • OceanBase Deployer V1.3.0
    • V1.2
      • OceanBase Deployer V1.2.1
      • OceanBase Deployer V1.2.0

Download PDF

What is obd Install obd Quickly deploy OceanBase Database Quickly deploy OCP Quick deployment command Cluster commands Mirror and repository commands Testing commands Tool commands obdiag commands Binlog commands Host commands License commands Password commands Telemetry commands Overview GUI operation overview Mode configuration rules Deploy an OceanBase cluster on the GUI Deploy OCP through the GUI Modify components on the GUI Upgrade OCP on the GUI Configuration files Backup and restore Upgrade obd FAQ Error codes Version rules OceanBase Deployer V3.2.2 OceanBase Deployer V3.2.1 OceanBase Deployer V3.2.0 OceanBase Deployer V3.1.2 OceanBase Deployer V3.1.1 OceanBase Deployer V3.1.0 OceanBase Deployer V3.0.1 OceanBase Deployer V3.0.0 OceanBase Deployer V2.10.1 OceanBase Deployer V2.10.0 OceanBase Deployer V2.9.2 OceanBase Deployer V2.9.1 OceanBase Deployer V2.9.0 OceanBase Deployer V2.8.0 OceanBase Deployer V2.7.0 OceanBase Deployer V2.6.2 OceanBase Deployer V2.6.1 OceanBase Deployer V2.6.0 OceanBase Deployer V2.5.0 OceanBase Deployer V2.4.0 OceanBase Deployer V2.3.1 OceanBase Deployer V2.3.0 OceanBase Deployer V2.2.0 OceanBase Deployer V2.1.1 OceanBase Deployer V2.1.0 OceanBase Deployer V2.0.1 OceanBase Deployer V2.0.0 OceanBase Deployer V1.6.2 OceanBase Deployer V1.6.1 OceanBase Deployer V1.6.0 OceanBase Deployer V1.5.0 OceanBase Deployer V1.4.0 OceanBase Deployer V1.3.3 OceanBase Deployer V1.3.2 OceanBase Deployer V1.3.0 OceanBase Deployer V1.2.1 OceanBase Deployer V1.2.0
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 Deployer
  3. V3.2.1
iconOceanBase Deployer
V 3.2.1Community Edition
Community Edition
  • V 3.2.1
  • V 3.2.0
  • V 3.1.0
  • V 3.0.0
  • V 2.10.1
  • V 2.10.0
  • V 2.9.0
  • V 2.8.0
  • V 2.7.0
  • V 2.6.0
  • V 2.5.0
  • V 2.4.0
  • V 2.3.1
  • V 2.3.0
  • V 2.2.0
  • V 2.1.0
  • V 2.0.0
  • V 1.6.1

Upgrade obd

Last Updated:2026-04-10 13:31:02  Updated
share
What is on this page
Background information
Online upgrade
Offline upgrade

folded

share

You can upgrade OceanBase Deployer (obd) online or offline, depending on whether your obd server can connect to the Internet.

Background information

Generally, you can install obd by using the OceanBase All in One package or an RPM package. The upgrade method varies based on the installation method.

  • If obd is installed by using the OceanBase All in One package, we recommend that you upgrade obd by referring to the Upgrade the OceanBase All in One package section in Install obd.

  • If obd is installed by using an RPM package, we recommend that you upgrade obd by using the obd update command, which is described in this topic.

Online upgrade

If your obd server can connect to the Internet, you can perform the following steps to upgrade obd. An online upgrade automatically upgrades obd to the latest version. If you want to upgrade to a specific version, download the corresponding installation package and follow the steps in the Offline upgrade section.

  1. Enable remote image repositories.

    obd mirror enable remote
    

    After the preceding command is successfully executed, you can run the obd mirror list command to confirm whether the remote image repositories are enabled. The output is as follows, where if the values of the remote image repositories in the Enabled column are True, the remote image sources are enabled.

    +-----------------------------------------------------------------------------+
    |                            Mirror Repository List                           |
    +----------------------------+--------+---------+----------+------------------+
    | SectionName                | Type   | Enabled | Available| Update Time      |
    +----------------------------+--------+---------+----------+------------------+
    | local                      | local  | -       | True     | 2025-03-25 13:48 |
    | oceanbase.community.stable | remote | True    | True     | 2025-03-25 13:48 |
    | oceanbase.development-kit  | remote | True    | True     | 2025-03-25 13:48 |
    +----------------------------+--------+---------+----------+------------------+
    
  2. Upgrade obd.

    obd update
    
  3. Verify the obd version.

    obd --version
    

    The output is as follows, indicating that obd has been upgraded to V3.1.2.

    OceanBase Deploy: 3.1.2
    REVISION: 739be300c448342b2850c71087bee01091dd7cb7
    BUILD_BRANCH: HEAD
    BUILD_TIME: Feb 14 2025 14:43:32OURCE
    Copyright (C) 2025 OceanBase
    License Apache 2.0: Apache version 2 or later <https://www.apache.org/licenses/LICENSE-2.0>.
    This is free software: you are free to change and redistribute it.
    There is NO WARRANTY, to the extent permitted by law.
    

Offline upgrade

If your obd server cannot connect to the Internet, download the desired installation package of obd from OceanBase Download Center and upload it to the server. In the directory where the installation package is located, perform the following steps to upgrade obd:

  1. Upload the installation package to the local image repository.

    obd mirror clone ob-deploy-*.rpm
    

    After the preceding command is executed, you can run the obd mirror list local | grep ob-deploy command to query the installation package in the local image repository. The output is as follows:

    | ob-deploy  | 3.1.2   | 1.el7   | x86_64 | 75a9be0ab6bd723754febe30970a27fd52c5cdd7 |
    
  2. Disable remote image repositories.

    obd mirror disable remote
    

    After the preceding command is executed, you can run the obd mirror list command to confirm whether the remote image repositories are disabled. The output is as follows, where if the values of the remote image repositories in the Enabled column are False, the remote image sources are disabled.

    +-----------------------------------------------------------------------------+
    |                            Mirror Repository List                           |
    +----------------------------+--------+---------+----------+------------------+
    | SectionName                | Type   | Enabled | Available| Update Time      |
    +----------------------------+--------+---------+----------+------------------+
    | local                      | local  | -       | True     | 2025-03-25 14:04 |
    | oceanbase.community.stable | remote | False   | False    | 2025-03-25 13:53 |
    | oceanbase.development-kit  | remote | False   | False    | 2025-03-25 13:53 |
    +----------------------------+--------+---------+----------+------------------+
    
  3. Upgrade obd.

    obd update
    
  4. Verify the obd version.

    obd --version
    

    The output is as follows, indicating that obd has been upgraded to V3.1.2.

    OceanBase Deploy: 3.1.2
    REVISION: 739be300c448342b2850c71087bee01091dd7cb7
    BUILD_BRANCH: HEAD
    BUILD_TIME: Feb 14 2025 14:43:32OURCE
    Copyright (C) 2025 OceanBase
    License Apache 2.0: Apache version 2 or later <https://www.apache.org/licenses/LICENSE-2.0>.
    This is free software: you are free to change and redistribute it.
    There is NO WARRANTY, to the extent permitted by law.
    

Previous topic

Backup and restore
Last

Next topic

FAQ
Next
What is on this page
Background information
Online upgrade
Offline upgrade