ob_adminの概要

ob_adminは、OceanBaseデータベースの付随する運用保守ツールの一つです。本記事では、ob_adminのインストール手順と機能紹介を解説します。

ob_adminのインストール

YUMコマンドによるインストール

YUMコマンドを使用してツール統合パッケージ（OceanBase Utils）を直接インストールし、ob_adminを使用できます。

1. YUMコマンドを使用してOceanBase Utilsをインストールします。

   yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo
   yum install oceanbase-ce-utils
   

2. インストールが成功すると、ob_adminに含まれる関連機能を使用できます。

   dumpsstのヘルプを表示する例を挙げると、コマンドは次のとおりです：

   ob_admin dumpsst -h
   

ob_utilsインストールパッケージ

ツール統合パッケージ（OceanBase Utils）をインストールすることで、ob_adminを使用できます。

1. OceanBaseソフトウェアダウンロードセンター ページにアクセスし、OceanBase Utils を検索して、必要なバージョンをローカルにダウンロードします。

2. ファイルディレクトリで以下のコマンドを実行してOceanBase Utilsをインストールします。

   rpm -ivh  oceanbase-ce-utils-<version>
   

   ob_admin のみが必要な場合は、rpm2cpio コマンドを使用して ob_admin を取得できます。

   rpm2cpio oceanbase-ce-utils-<version> | cpio -idmv ./usr/bin/ob_admin
   cp usr/bin/ob_admin /usr/local/bin
   

3. インストールが成功すると、ob_adminに含まれる関連機能を使用できます。

   dumpsstのヘルプを表示する例を挙げると、コマンドは次のとおりです：

   ob_admin dumpsst -h
   

ソースコードからのコンパイル

OceanBaseデータベースのソースコードから自らコンパイルできます。

1. OceanBaseデータベース のオープンソースコードをローカルにクローンします。

   git clone https://github.com/oceanbase/oceanbase
   

2. 二つのモードでob_adminをコンパイルします。

   • Debugモード

     bash build.sh debug --init
     cd build_debug
     make ob_admin
     cp tools/ob_admin/src/ob_admin /usr/local/bin
     

     ob_admin のコンパイル生成物は、デフォルトで DEBUG_BUILD_DIR/tools/ob_admin/src/ob_admin に保存されます。ここで、DEBUG_BUILD_DIR はコンパイルディレクトリを表し、この例では build_debug です。

   • Releaseモード

     bash build.sh release --init
     cd build_release
     make ob_admin
     cp tools/ob_admin/src/ob_admin /usr/local/bin
     

     ob_admin のコンパイル生成物は、デフォルトで RELEASE_BUILD_DIR/tools/ob_admin/src/ob_admin に保存されます。ここで、RELEASE_BUILD_DIRR はコンパイルディレクトリを表し、この例では build_release です。

3. インストールが成功すると、ob_adminに含まれる関連機能を使用できます。

   dumpsstのヘルプを表示する例を挙げると、コマンドは次のとおりです：

   ob_admin dumpsst -h
   

よくある質問

ob_adminの使用中に動的ライブラリlibmariadb.so.3が欠けている場合、以下の方法で解決できます。

1. エラー例。

   $ ob_admin dumpsst -h
   ob_admin: error while loading shared libraries: libmariadb.so.3: cannot open shared object file: No such file or directory
   

2. OceanBaseデータベースにはlibmariadb.so.3が組み込まれています。findコマンドを使用してそのパスを特定します。

   この例では、OceanBaseデータベースのインストールパスは/home/admin/observerです。

   $ find / -name libmariadb.so.3
   /home/admin/observer/lib/libmariadb.so.3
   

3. 環境変数LD_LIBRARY_PATHに指定された動的ライブラリの検索パス。

   $ export LD_LIBRARY_PATH=/home/admin/observer/lib
   

4. その後、ob_adminの関連機能を使用します。

   $ ob_admin dumpsst -h
   

ob_adminの機能紹介

ob_adminはslog_tool、log_tool、dumpsst、dump_backupの機能を提供しており、主にデータの不整合、データ欠落、誤ったデータなどの問題の調査に使用されます。以下では、各サブ機能について簡潔に紹介します。

slog_tool

slog_toolには現在、slogファイル内のログ内容を表示するという1つの機能しかありません。コマンド形式は以下のとおりです：

$./ob_admin slog_tool -f ../store/slog/1

clogログ

通常、clogファイルにはさまざまな種類のログが含まれていますが、その中でもOB_LOG_SUBMITが主要なログタイプです。これは、他のモジュール（clogモジュール以外）がコミットしたログレコードを表し、トランザクションモジュールからclogにコミットされたトランザクションログを含みます。

log_tool

log_toolには主に以下の機能があります：

• dump clog ファイル内のログ内容を提供します。
• clogファイル内の各モジュールの割合を統計します。
• 指定フィールドでログを検索します。

具体的な使い方については、clog_toolを参照してください。

dumpsst

dumpsstは、Super Block、macro block、macro block meta、SSTable、SSTable metaなどの block_file ファイルの内容を表示するために使用されます。通常、オンラインでの問題調査やデータ問題の特定などに用いられます。具体的な使い方については、dumpsstを参照してください。

dump_backup

dump_backup機能は、物理バックアップに使用されるデータバックアップ内容を解析できます。具体的な使い方については、dump_backupを参照してください。