必要條件

在您可以登陸或複寫資料之前，確認完成下列先決條件：

• 在 資料移動閘道 伺服器安裝必要 driver

  資訊備註

  只有在您選擇使用 資料移動閘道 時，才需要此。如需關於 資料移動閘道 福利以及何時需要的資訊，請參閱 Qlik 資料閘道 - 資料移動。

• 在資料來源授予必要權限

• 設定資料來源連接器

驅動程式的設定

您可以使用驅動程式安裝公用程式 (建議) 或手動安裝 driver。只能在不太可能發生的事件 (您在使用驅動程式安裝公用程式時遇到問題) 中嘗試手動安裝。

使用驅動程式安裝公用程式來安裝驅動程式

此區段描述如何安裝所需的 driver。該流程涉及下載 driver、複製到所需的資料夾 (見下文)，以及執行將會自動安裝並設定該驅動程式的指令碼。您也可以執行指令碼，以根據需求更新並解除安裝 driver。

準備安裝

• 確認 Python 3.6 或更高版本安裝於 資料移動 閘道伺服器。

  Python 會預先安裝在大部分的 Linux 發行版。您可以執行下列命令，以查看哪個 Python 版本安裝在您的系統上：

  python3 --version

• 從 IBM 網站下載 IBM i Access Client 解決方案 Linux 應用程式套件「ibm-iaccess-<version>.x86_64.rpm」。您可以在 /opt/qlik/gateway/movement/drivers/manifests/db2iseries.yaml 的 binary-artifacts 之下找到支援的版本。下載完成後，將檔案複製到：

  /opt/qlik/gateway/movement/drivers/db2i

安裝 driver

若要安裝 driver：

1. 在 資料移動 閘道機器上，將工作目錄變更為：

   opt/qlik/gateway/movement/drivers/bin

2. 執行下列命令：

   語法：

   ./install db2iseries

   否則，就會顯示 driver 的 EULA。

3. 執行下列其中一個動作：

   • 重複按下 [Enter] 以緩慢瀏覽 EULA。
   • 重複按下空格鍵以快速瀏覽 EULA。
   • 按下 q 以結束授權文字並呈現 EULA 接受選項。

4. 執行下列其中一個動作：

   • 輸入「y」並按下 [Enter] 以接受 EULA 並開始安裝。
   • 輸入「n」並按下 [Enter] 以拒絕 EULA 並退出安裝。

   • 輸入「v」並按下 [Enter] 以再次檢視 EULA。

將會安裝 driver。

更新 driver

若您想要在安裝提供的 driver 之前解除安裝先前的 driver 版本，請執行更新命令。

若要更新 driver：

1. 在 資料移動 閘道機器上，將工作目錄變更為：

   opt/qlik/gateway/movement/drivers/bin

2. 執行下列命令：

   語法：

   ./update db2iseries

   否則，就會顯示 driver 的 EULA。

3. 執行下列其中一個動作：

   • 重複按下 [Enter] 以緩慢瀏覽 EULA。
   • 重複按下空格鍵以快速瀏覽 EULA。
   • 按下 q 以結束授權文字並呈現 EULA 接受選項。

4. 執行下列其中一個動作：

   • 輸入「y」並按下 [Enter] 以接受 EULA 並開始安裝。
   • 輸入「n」並按下 [Enter] 以拒絕 EULA 並退出安裝。
   • 輸入「v」並按下 [Enter] 以從頭檢閱 EULA。

將會解除安裝舊版 driver，並安裝新版 driver。

解除安裝 driver

若您想要解除安裝 driver，請執行解除安裝命令。

若要解除安裝 driver：

1. 停止設定為使用此連接器的所有任務。

2. 在 資料移動 閘道機器上，將工作目錄變更為：

   opt/qlik/gateway/movement/drivers/bin

3. 執行下列命令：

   語法：

   ./uninstall db2iseries

   將會解除安裝 driver。

手動驅動程式設定

只有在自動驅動程式安裝無法成功完成時，才能嘗試手動安裝 driver。

從 IBM 網站下載 IBM i Access Client Solutions Linux Application Package。

如需更多資訊資訊，請參閱 https://www.ibm.com/docs/en/i/7.2?topic=packages-linux-application-package

接著在 Data Movement gateway 機器上，開啟 shell prompt 並進行以下項目：

1. 停止 Data Movement gateway 服務：

   sudo systemctl stop repagent

2. 可自選，確認服務已停止：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 安裝下載套裝中包含的 RPM。

   範例：

   rpm -i ibm-iaccess-1.1.0.26-1.0.x86_64

   資訊備註

   所顯示驅動程式版本將與 Data Movement gateway 記錄中的不同。舉例來說，假設驅動程式版本與上述範例一樣，在 Data Movement gateway 記錄中將顯示為 ODBC 驅動程式版本：'07.01.026'

   如需關於檢視記錄的資訊，請參閱 疑難排解資料任務。

4. 變更任務目錄至 <Data Movement gateway_Install_Dir>/bin。

5. 新增 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

6. 可自選，確認已複製驅動程式位置：

   cat site_arep_login.sh

7. 在完成安裝後，開啟 /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

8. 開始 Data Movement gateway 服務：

   sudo systemctl start repagent

9. 可自行選擇確認服務已開始：

   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。

MINENTDTA 參數

MINENTDTA 參數必須設定為 *NONE，因為不支援 *FILE (最小記錄)。