跳到主要內容 跳至補充內容
Qlik 資源

必要條件

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

  • 在 Data Movement 閘道伺服器安裝必要 driver

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

  • 設定資料來源連接器

在 z/OS 上安裝 R4Z 產品

您必須先在 z/OS 上安裝並設定 R4Z 產品，才能使用 z/OS 版 IBM DB2 來源。

  1. 移至 產品下載。

  2. 選取 Qlik 資料整合。

  3. 向下捲動產品清單並選取 Qlik Cloud 資料整合。

  4. 在下載連結欄中，按一下 QlikReplicate_2023.5.0.191_r4z.zip 連結以開始下載。

  5. 下載 R4Z 並安裝在 z/OS 資料來源。

如需安裝和設定說明，請參閱 安裝並設定 R4Z。

安裝並設定驅動程式

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

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

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

準備安裝

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

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

    python3 --version

  • 從 IBM 網站下載 IBM Data Server Client「<version>_linuxx64_client.tar.gz」。您可以在 /opt/qlik/gateway/movement/drivers/manifests/db2.yaml 的 binary-artifacts 之下找到支援的版本。下載完成後，將檔案複製到：

    /opt/qlik/gateway/movement/drivers/db2

安裝 driver

若要安裝 driver：

  1. 停止 資料移動閘道 服務：

    sudo systemctl stop repagent

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

    sudo systemctl status repagent

    狀態應如下所示：

    Active: inactive (dead) since <timestamp> ago

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

    opt/qlik/gateway/movement/drivers/bin

  4. 執行下列命令：

    語法：

    ./install db2

    否則，就會顯示 driver 的 EULA。

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

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

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

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

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

    7. 將會安裝 driver。

  7. 等待安裝完成 (以「完成！」指示)，然後開始 資料移動閘道 服務：

    sudo systemctl start repagent

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

    sudo systemctl status repagent

    狀態應如下所示：

    Active: active (running) since <timestamp> ago

更新 driver

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

若要更新 driver：

  1. 停止 資料移動閘道 服務：

    sudo systemctl stop repagent

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

    sudo systemctl status repagent

    狀態應如下所示：

    Active: inactive (dead) since <timestamp> ago

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

    opt/qlik/gateway/movement/drivers/bin

  4. 執行下列命令：

    語法：

    ./update db2

    否則，就會顯示 driver 的 EULA。

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

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

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

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

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

  7. 等待安裝完成 (以「完成！」指示)，然後開始 資料移動閘道 服務：

    sudo systemctl start repagent

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

    sudo systemctl status repagent

    狀態應如下所示：

    Active: active (running) since <timestamp> ago

解除安裝 driver

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

若要解除安裝 driver：

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

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

    opt/qlik/gateway/movement/drivers/bin

  3. 執行下列命令：

    語法：

    ./uninstall db2

    將會解除安裝 driver。

手動安裝驅動程式

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

Linux ODBC 用戶端套件

您可以在安裝完整 ODBC 用戶端套件或僅安裝資料伺服器用戶端之間選擇，如以下 Linux 資料伺服器用戶端 中所述。

資訊備註

不支援「enableWLB」驅動程式選項。要施行連線於並行 sysplex 自動切換至另一個 LPAR（如「容錯移轉」），在驅動程式設定中將「enableACR」設定為「真」，「enableWLB」設定為「假」。

在 資料移動閘道 機器上，開啟 shell prompt 並進行以下項目：

  1. 停止 資料移動閘道 服務：

    sudo systemctl stop repagent

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

    sudo systemctl status repagent

    狀態應如下所示：

    Active: inactive (dead) since <timestamp> ago

  3. 安裝 v11.5.8_linuxx64_server_dec.tar.gz 並選擇「用戶端」選項。

  4. 舉例來說，如果 資料移動閘道 機器沒有 DB2，透過進行以下指令建立 DB2：

    adduser <db2_instance_name>

    /opt/ibm/db2/V11.5/instance/db2icrt <db2_instance_name>

  5. 變更任務目錄至 <資料移動閘道_Install_Dir>/bin。

  6. 新增 DB2 驅動程式位置至 Linux 物件庫路徑。

    要這麼做，請新增以下行至 site_ arep_login.sh 檔案如下：

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib

    其中 path 為驅動程式的用戶端路徑。

    範例 (以 db2clnt1 作為執行個體名稱)：

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/db2clnt1/sqllib/lib:/home/db2clnt1/sqllib/lib64/gskit

    export DB2INSTANCE=db2clnt1

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

    cat site_arep_login.sh

  8. 新增以下輸入至 /etc: 底下的 odbcinst.ini 檔案：

    [IBM DB2 ODBC DRIVER]

    Driver = /home/db2clnt1/sqllib/lib/libdb2o.so

    fileusage=1

    dontdlclose=1

  9. 開始 資料移動閘道 服務：

    sudo systemctl start repagent

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

    sudo systemctl status repagent

    狀態應如下所示：

    Active: active (running) since <timestamp> ago

Linux 資料伺服器用戶端

  1. 從 IBM Fix Central 下載 v11.5.8_linuxx64_client.tar.gz 並解壓縮檔案。

  2. 停止 資料移動閘道 服務：

    sudo service repagent stop

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

    sudo service repagent status

    狀態應如下所示：

    Active: inactive (dead) since <timestamp> ago

  4. 將工作目錄變更為 /opt/client 並執行 db2_install。

  5. 建立 RSP 檔案 (請參閱下面的 RSP 檔案範例) 然後執行下列命令 (從 /opt/client)：

    ./db2setup -r /file-path/client.rsp

  6. 新增以下輸入至 /etc 底下的 odbcinst.ini 檔案：

    [IBM DB2 ODBC DRIVER]

    Driver = /opt/ibm/db2/V11.5/lib64/libdb2o.so

    fileusage=1

    dontdlclose=1

  9. 開始 資料移動閘道 服務：

    sudo service repagent start

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

    sudo service repagent status

    狀態應如下所示：

    Active: active (running) since <timestamp> ago

RSP 檔案範例

*-----------------------------------------------------
* Generated response file used by the DB2 Setup wizard
* generation time: 2/18/22 4:10 PM
*-----------------------------------------------------
*  Product Installation
LIC_AGREEMENT       = ACCEPT
PROD       = CLIENT
FILE       = /opt/ibm/db2/V11.5
INSTALL_TYPE       = TYPICAL
* ----------------------------------------------
*  Instance properties
* ----------------------------------------------
INSTANCE       = inst1
inst1.TYPE       = client
*  Instance-owning user
inst1.NAME       = qlik
inst1.UID       = 1000
inst1.GROUP_NAME       = qlik
inst1.HOME_DIRECTORY       = /home/qlik
inst1.AUTOSTART       = NO
*-----------------------------------------------
*  Installed Languages
*-----------------------------------------------
LANG       = EN

伺服器端 ODBC 設定

繫結要用於 ODBC 的計畫，如 ODBC 初始化檔案中的 PLANNAME= 值所指定。預設名稱是 DSNACLI。BIND 工作可見於成員 DSNTIJCL，這在來源 DB2 安裝的 SDSNSAMP 物件庫中。

使用 DB2CLI 繫結命令將 ODBC 提供的套件繫結至預期的來源 z/OS DB2 子系統。IBM 網站上的設定開發人員和執行時間環境中描述了此動作。如需關於 DB2CLI 公用程式的資訊，包括繫結公用程式的範例，請參閱 IBM 網站上的 db2cli - DB2 互動式 CLI 命令。

必要權限

若要啟用 資料移動閘道 以從來源表格擷取資料 (完整載入和變更資料擷取)，必須向 z/OS 版 IBM DB2 連接器設定中指定的使用者授予下列權限：

  • 讀取 UDTF 之 IFI 的 EXECUTE (僅變更資料擷取需要)
  • 來源表格和下列系統目錄表格上的 SELECT：
    • SYSIBM.SYSDUMMY1
    • SYSIBM.SYSTABLES
    • SYSIBM.SYSTABLESPACE
    • SYSIBM.SYSPARMS
    • SYSIBM.SYSROUTINES
    • SYSIBM.SYSCOLUMNS
    • SYSIBM.SYSLGRNX
    • SYSIBM.SYSTABLEPART
  • 用來開始 IFI 工作階段的 MONITOR2 (僅變更資料擷取需要)

擷取資料變更

若要從 z/OS 版 IBM DB2 擷取變更，資料移動閘道 會使用特殊程式 (作為外部例行事項叫用)，這是使用者定義的表格函數 (UDTF)。需要先在 z/OS 系統上安裝並設定此程式 (載入模組) 以及 UDTF，才能擷取變更。安裝並設定 R4Z 中描述了應由 DBA 執行的安裝程序。

此外，必須為每個您想要擷取其變更的表格設定資料擷取變更屬性。您可以手動進行此動作，或在 連接器 設定中啟用自動啟用資料擷取變更 (需要管理員權限) 選項 (預設)，以允許 資料移動閘道 進行此動作，

此頁面是否對您有幫助？

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們可以如何改善！

在此留下意見回饋