oblogminerのインストール

本記事では、oblogminerをインストールする2つの方法を紹介します：YUMコマンドによるインストールとインストールパッケージによるインストールです。実際の状況に応じて、どちらかの方法を選択してインストールしてください。

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

YUMコマンドを使用して、OceanBaseのツールパッケージ(OceanBase Utils)をインストールすることで、oblogminerのインストールを完了できます。YUMコマンドによるインストールでは、oblogminerは/usr/bin/ディレクトリにインストールされます。

1. リポジトリを追加します。

   [admin@test001 ~]$ sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo
   

2. OceanBase Utilsをインストールします。

   [admin@test001 ~]$ sudo yum install oceanbase-ce-utils
   

3. oblogminerのヘルプを確認します。

   インストールが成功した場合、以下のコマンドを実行してoblogminerのヘルプを確認できます。

   [admin@test001 ~]$ oblogminer -h
   

OceanBase Utilsパッケージによるインストール

OceanBaseのツールパッケージ(OceanBase Utils)をインストールすることで、oblogminerのインストールを完了できます。

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

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

   [admin@test001 ~]$ sudo rpm -ivh oceanbase-ce-utils-<version>.rpm
   

   oblogminerのみ使用する場合、以下のrpm2cpioコマンドを実行してoblogminerを取得できます。

   [admin@test001 ~]$ rpm2cpio oceanbase-ce-utils-<version> | cpio -idmv ./usr/bin/oblogminer
   

   rpm2cpioコマンドを使用する場合、デプロイが完了したら、以下のコマンドを実行してoblogminerを/usr/local/binディレクトリにコピーします。

   [admin@test001 ~]$ sudo cp usr/bin/oblogminer /usr/local/bin
   

3. oblogminerのヘルプを確認します。

   インストールが成功した場合、以下のコマンドを実行してoblogminerのヘルプを確認できます。

   [admin@test001 ~]$ oblogminer -h
   

ソースコードからビルドする

OceanBaseデータベースのソースコードから独自にビルドすることも可能です。

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

   [admin@test001 ~]$ git clone https://github.com/oceanbase/oceanbase.git
   

2. コードディレクトリで、4.2.xブランチに切り替えます。

   [admin@test001 oceanbase]$ git checkout 4.2.x
   

3. 必要に応じて、コンパイルモードを選択してoblogminerをコンパイルします。

   • デバッグモード

     build.shスクリプトを実行し、デバッグモードをdebugモードに指定します。

     [admin@test001 oceanbase]$ bash build.sh debug --init
     

     コンパイルディレクトリに移動します。

     [admin@test001 oceanbase]$ cd build_debug
     

     oblogminerをコンパイルします。

     [admin@test001 build_debug]$ make oblogminer
     

     コンパイル結果を/usr/local/binディレクトリにコピーします。

     [admin@test001 build_debug]$ sudo cp src/logservice/logminer/oblogminer /usr/local/bin
     

     oblogminerのコンパイル結果は、デフォルトで<DEBUG_BUILD_DIR>/src/logservice/logminerディレクトリに保存されます。ここで、<DEBUG_BUILD_DIR>はコンパイルディレクトリを表し、デバッグモードではbuild_debugがデフォルトです。

   • リリースモード

     build.shスクリプトを実行し、デバッグモードをreleaseモードに指定します。

     [admin@test001 oceanbase]$ bash build.sh release --init
     

     コンパイルディレクトリに移動します。

     [admin@test001 oceanbase]$ cd build_release
     

     oblogminerをコンパイルします。

     [admin@test001 build_release]$ make oblogminer
     

     コンパイル結果を/usr/local/binディレクトリにコピーします。

     [admin@test001 build_release]$ sudo cp src/logservice/logminer/oblogminer /usr/local/bin
     

     oblogminerのコンパイル結果は、デフォルトで<DEBUG_BUILD_DIR>/src/logservice/logminerディレクトリに保存されます。ここで、<DEBUG_BUILD_DIR>はコンパイルディレクトリを表し、リリースモードではbuild_releaseがデフォルトです。

4. oblogminerのヘルプ情報を確認します。

   コンパイルが成功すると、以下のコマンドを実行してoblogminerのヘルプ情報を確認できます。

   [admin@test001 ~]$ oblogminer -h
   

FAQ

oblogminerを使用する際、動的ライブラリlibmariadb.so.3が不足していると、以下のエラーが発生します。

oblogminer: error while loading shared libraries: libmariadb.so.3: cannot open shared object file: No such file or directory

OceanBaseデータベースにはlibmariadb.so.3が標準搭載されています。findコマンドでlibmariadb.so.3のパスを確認し、環境変数に動的ライブラリの検索パスを指定できます。具体的な操作手順は以下のとおりです。

1. findコマンドを実行してlibmariadb.so.3のパスを確認します。

   [admin@test001 ~]$ find / -name libmariadb.so.3
   

   環境に動的ライブラリlibmariadb.so.3が存在する場合、そのパスが出力されます。例：

   /home/admin/observer/lib/libmariadb.so.3
   

2. 環境変数LD_LIBRARY_PATHに動的ライブラリの検索パスを指定します。

   [admin@test001 ~]$ export LD_LIBRARY_PATH=/home/admin/observer/lib
   

操作を完了すると、oblogminerのコマンドを使用できます。oblogminerのコマンドの詳細については、コマンドライン引数の紹介を参照してください。