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をコンパイルします。

   • Debugモード

     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>はコンパイルディレクトリを表し、Debugモードの場合、デフォルトはbuild_debugです。

   • Releaseモード

     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>はコンパイルディレクトリを表し、Releaseモードではデフォルトでbuild_releaseです。

4. oblogminerのヘルプを確認する

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

   [admin@test001 ~]$ oblogminer -h
   

よくある質問

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コマンドの詳細については、コマンドラインパラメータを参照してください。