前提条件
データのランディングまたはレプリケートをする前に、次の前提条件を満たすようにします。
-
Data Movement gateway サーバーに、必要な driver をインストールする
情報メモこれは、Data Movement gateway を使用することを選択した場合のみ必要です。Data Movement gateway の利点と必要なタイミングについては、Qlik Data Gateway - データ移動 を参照してください。
-
データ ソースに必要な権限を付与する
-
データ ソースのコネクタを構成する
ドライバーのセットアップ
driver のインストールは、ドライバー インストール ユーティリティを使用する (推奨) か、手動で実行できます。手動インストールは、ドライバー インストール ユーティリティで問題が発生した場合にのみ実行するようにしてください。
ドライバー インストール ユーティリティを使用したドライバーのインストール
このセクションでは、必要な driver のインストール方法を説明しました。このプロセスでは、driver をダウンロードし、必要なフォルダー (以下を参照) にコピーし、自動的にインストールして設定するスクリプトを実行します。また、必要に応じて driver の更新やアンインストールを行うスクリプトを実行することもできます。
インストールの準備
-
データ移動 ゲートウェイ サーバーに Python 3.6.x 以降 がインストールされていることを確認します。
Python は、ほとんどの Linux 配布に前もってインストールされています。お使いのシステムにインストールされている Python のバージョンは、次のコマンドを実行することで確認できます。
python3 --version
-
IBM Web サイトから、IBM i Access Client Solutions Linux Application Package 「ibm-iaccess-<version>.x86_64.rpm」をダウンロードします。サポートされているバージョンは、/opt/qlik/gateway/movement/drivers/manifests/db2iseries.yaml の binary-artifacts にあります。ダウンロードが完了したら、ファイルを次の場所にコピーします。
/opt/qlik/gateway/movement/drivers/db2i
driver のインストール
driver をするには:
-
データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:
opt/qlik/gateway/movement/drivers/bin
-
次のコマンドを実行します。
構文:
./install db2iseries
それ以外の場合は、driver の EULA が表示されます。
-
以下のいずれかを行います。
- 何度も [Enter] を押すと、EULA 全体をスクロールできます。
- 何度もスペースバーを押すと、EULA 全体をスピーディにスクロールできます。
- q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。
-
以下のいずれかを行います。
- 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。
- 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。
-
「v」を入力して [Enter] を押すと、EULA が再表示されます。
driver がインストールされます。
driver の更新
提供された driver をインストールする前に前のバージョンの driver をアンインストールしたい場合は、更新コマンドを実行します。
driver を更新するには:
-
データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:
opt/qlik/gateway/movement/drivers/bin
-
次のコマンドを実行します。
構文:
./update db2iseries
それ以外の場合は、driver の EULA が表示されます。
-
以下のいずれかを行います。
- 何度も [Enter] を押すと、EULA 全体をスクロールできます。
- 何度もスペースバーを押して、EULA 全体をスピーディにスクロールします。
- q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。
-
以下のいずれかを行います。
- 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。
- 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。
- 「v」を入力して [Enter] を押すと、最初から EULA をレビューできます。
古い driver がアンインストールされ、新しい driver がインストールされます。
driver のアンインストール
driver をアンインストールする場合は、アンインストール コマンドを実行します。
driver をアンインストールするには:
-
このコネクタを使用するように構成されているすべてのタスクを停止します。
-
データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:
opt/qlik/gateway/movement/drivers/bin
-
次のコマンドを実行します。
構文:
./uninstall db2iseries
driver がアンインストールされます。
ドライバーの手動セットアップ
自動ドライバーのインストールが正常に完了しなかった場合にのみ、driver を手動でインストールするようにしてください。
IBM Web サイトから IBM i Access Client Solutions Linux Application Package をダウンロードします。
iAccess ODBC driver 7.1.0. はサポートされていません。
詳細については、「https://www.ibm.com/docs/en/i/7.2?topic=packages-linux-application-package」を参照してください
次に、Data Movement gateway マシンで、シェル プロンプトを開き、次の手順を実行します。
-
Data Movement gateway サービスを停止します。
sudo systemctl stop repagent
-
必要に応じて、サービスが停止されたことを確認します。
sudo systemctl status repagent
ステータスは次のようになっているはずです。
Active: inactive (dead) since <timestamp> ago
-
ダウンロードされたパッケージに含まれる RPM をインストールします。
例:
rpm -i ibm-iaccess-1.1.0.26-1.0.x86_64
情報メモ表示されるドライバー バージョンは Data Movement gateway ログと異なります。例えば、ドライバー バージョンが上記の例と同じ場合、Data Movement gateway ログには ODBC driver version: '07.01.026' と表示されます。
ログ表示に関する詳細については、「データ タスクのトラブルシューティング」を参照してください。
-
作業ディレクトリを <Data Movement gateway_Install_Dir>/bin に変更します。
-
DB2 ドライバーの場所を Linux ライブラリ パスに追加します。
これを行うには、次のパスを site_ arep_login.sh ファイル (<install_dir>/replicate/bin: 内) に追加します。
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib64
ここでの path は、ドライバーへのパスです。
例:
echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/ibm/iaccess/lib64" >> site_arep_login.sh
-
必要に応じて、ドライバーの場所がコピーされていることを確認します。
cat site_arep_login.sh
-
インストールが完了した後、/etc/odbcinst.ini ファイルを開いて、次のセクションを含むことを確認します。
[IBM i Access ODBC Driver 64-bit]
Description = IBM i Access for Linux 64-bit ODBC Driver Driver = /opt/ibm/iaccess/lib64/libcwbodbc.so Setup = /opt/ibm/iaccess/lib64/libcwbodbcs.so Threading = 0 DontDLClose = 1 UsageCount = 1 -
Data Movement gateway サービスを起動します。
sudo systemctl start repagent
-
必要に応じて、サービスが開始されたことを確認します。
sudo systemctl status repagent
ステータスは次のようになっているはずです。
Active: active (running) since <timestamp> ago
CDC 前提条件
ジャーナルの前提条件
特定の 移動 タスクのソース テーブルはすべて、同じジャーナルにジャーナリングされる必要があります。ジャーナルの名前と配置されるライブラリを、コネクタ 設定で指定する必要があります。タスクの実行中、Data Movement gateway はこのジャーナルをポーリングして、ソース テーブルへの変更を確認します。
ソース テーブルのジャーナリングを開始するとき、Record images パラメーターを *BOTH (前後のイメージをキャプチャする場合) または *AFTER に設定できます。
Record images パラメーターが *AFTER に設定されている場合、 削除されたレコードのデータ フィールドには NULL 値が含まれます。削除されたレコードのコピーを削除されたレコード ジャーナルに保存するには、Record images パラメーター セットを *BOTH に設定する必要があります。
複数の 移動 タスク (IBM DB2 for iSeries からデータを 移動) を実行する必要がある場合は、タスクごとに個別のジャーナルを作成する方が効率的です (必須ではありません)。コネクタ ごとに 1 つのジャーナルしか指定できないため、各タスクに個別の コネクタ を定義する必要があります。
MINENTDTA パラメーター
*FILE (最小ロギング) はサポートされていないため、MINENTDTA パラメーターは *NONE に設定する必要があります。