OceanBase
English日本語简体中文
Docs Home
Products
Integrations
Release Notes

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service
OceanBase DatabaseOceanBase Cloud ToolsConnectors and MiddlewareLifecycle Support Policy

OceanBase Diagnostic Tool

V2.3.0
  • Overview
  • Install obdiag
  • Configure obdiag
  • One-click Cluster Inspection
    • Use obdiag to inspect an OceanBase cluster
    • Inspection metrics
  • One-click Information Gathering
    • Use obdiag to collect information
    • Use obdiag to collect information for specific scenarios
  • Use obdiag for Diagnostic Analysis
  • Use obdiag for Root Cause Analysis
  • Upgrade obdiag by Using add-on Files
  • Upgrade and Uninstall obdiag
  • Telemetry Mode
  • FAQ
  • Release Notes
    • obdiag V2.3.0
    • obdiag V2.2.0
    • obdiag V2.1.0
    • obdiag V2.0.0
    • obdiag V1.6.2
    • obdiag V1.6.1
    • obdiag V1.6.0
    • obdiag V1.5.2
    • obdiag V1.5.1
    • obdiag V1.5.0
    • obdiag V1.4.0
    • obdiag V1.3.0

Download PDF

Document Feedback
  1. Documentation Center
  2. OceanBase Diagnostic Tool
  3. V2.3.0

Upgrade and Uninstall obdiag

Last Updated:2026-09-04 08:22:11

Upgrade the software
Method 1: Upgrade obdiag that is independently deployed
Method 2: Upgrade obdiag by deploying it using OBD
Uninstall the software
Uninstall obdiag that is independently deployed

This topic describes how to upgrade and uninstall OceanBase Diagnostic Tool (obdiag).

Upgrade the software

Method 1: Upgrade obdiag that is independently deployed

If obdiag is independently deployed, you can upgrade its version based on the description in this section.

  • Online upgrade (when Internet access is available)

    sudo yum update -y oceanbase-diagnostic-tool
    source /usr/local/oceanbase-diagnostic-tool/init.sh
    

    Note

    The online upgrade method is supported on CentOS 7 and 8. If you use CentOS 9, perform the following operations for offline upgrade.

  • Offline upgrade (when Internet access is unavailable) Download the obdiag package of the latest version from OceanBase Download Center.

    yum update -y oceanbase-diagnostic-tool*.rpm
    source /usr/local/oceanbase-diagnostic-tool/init.sh
    
  • Upgrade obdiag in a Debian-based system, such as Ubuntu Download the obdiag package of the latest version of the latest version from OceanBase Download Center.

    apt-get update
    apt-get install alien -y
    alien --scripts --to-deb  oceanbase-diagnostic-tool*.rpm # Convert the RPM package to a DEB package.
    dpkg -i oceanbase-diagnostic-tool*.deb
    source /usr/local/oceanbase-diagnostic-tool/init.sh
    

Method 2: Upgrade obdiag by deploying it using OBD

If the cluster to be diagnosed is deployed by using OceanBase Deployer (OBD), we recommend that you upgrade OBD to V2.5.0 or later. Then, you can directly run obdiag commands on OBD without the need to configure the ~/.obdiag/config.yml file. For more information about the commands, see obdiag commands.

  • Online upgrade (when Internet access is available)

    # Enable OBD to pull remote images.
    obd mirror enable remote
    # Upgrade obdiag by deploying it using OBD
    obd obdiag deploy
    
  • Offline upgrade (when Internet access is unavailable)

    Download the obdiag package of the latest version from OceanBase Download Center.

    # Copy the offline obdiag package to the image repository of OBD.
    obd mirror clone oceanbase-diagnostic-tool-xxxxxxxx.rpm
    # Upgrade obdiag by deploying it using OBD
    obd obdiag deploy
    

Uninstall the software

You can uninstall obdiag only if it is independently deployed.

Uninstall obdiag that is independently deployed

If obdiag is independently deployed, you can uninstall it based on the description in this section.

sudo yum remove oceanbase-diagnostic-tool
sudo rm -rf /usr/local/oceanbase-diagnostic-tool
rm -rf ~/.obdiag/

For obdiag that runs on a system based on Advanced Packaging Tools (APT), such as Ubuntu or Debian, and that is installed by using a .deb package converted by using Alien, run the following command to uninstall it:

sudo dpkg -r oceanbase-diagnostic-tool
sudo rm -rf /usr/local/oceanbase-diagnostic-tool
rm -rf ~/.obdiag/

Previous topic

Upgrade obdiag by Using add-on Files
Last

Next topic

Telemetry Mode
Next
on this page
Upgrade the software
Method 1: Upgrade obdiag that is independently deployed
Method 2: Upgrade obdiag by deploying it using OBD
Uninstall the software
Uninstall obdiag that is independently deployed