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

必要條件

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

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

    資訊備註

    只有在您選擇使用 Data Movement gateway 時，才需要此。如需關於 Data Movement gateway 福利以及何時需要的資訊，請參閱 Qlik Data Gateway - Data Movement。

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

  • 設定資料來源連接器

在 z/OS 上安裝 R4Z 產品

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

  1. 移至 產品下載。

  2. 選取 Qlik 資料整合。

  3. 在產品清單中，選取 Qlik Replicate。

  4. 在版本清單中，選擇與您的 Data Movement gateway 版本的發佈日期 (年份和月份) 相對應的 Qlik Replicate 版本。例如，如果您的 Data Movement gateway 版本是 2024.5.54 (年份.月份.版本)，請選取 May 2024。

  5. 在版本號碼清單中，選擇初始版本。

  6. 在下載連結欄中，按一下 QlikReplicate_<version>_r4z.zip 連結以開始下載。

  7. 下載後，安裝在 z/OS 資料來源。

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

安裝並設定驅動程式

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

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

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

準備安裝

  • 確認 Python 3.6 或更高版本安裝於 Data Movement 閘道伺服器。

    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. 停止 Data Movement gateway 服務：

    sudo systemctl stop repagent

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

    sudo systemctl status repagent

    狀態應如下所示：

    Active: inactive (dead) since <timestamp> ago

  3. 在 Data Movement 閘道機器上，將工作目錄變更為：

    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. 等待安裝完成 (以「完成！」指示)，然後開始 Data Movement gateway 服務：

    sudo systemctl start repagent

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

    sudo systemctl status repagent

    狀態應如下所示：

    Active: active (running) since <timestamp> ago

更新 driver

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

若要更新 driver：

  1. 停止 Data Movement gateway 服務：

    sudo systemctl stop repagent

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

    sudo systemctl status repagent

    狀態應如下所示：

    Active: inactive (dead) since <timestamp> ago

  3. 在 Data Movement 閘道機器上，將工作目錄變更為：

    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. 等待安裝完成 (以「完成！」指示)，然後開始 Data Movement gateway 服務：

    sudo systemctl start repagent

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

    sudo systemctl status repagent

    狀態應如下所示：

    Active: active (running) since <timestamp> ago

解除安裝 driver

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

若要解除安裝 driver：

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

  2. 在 Data Movement 閘道機器上，將工作目錄變更為：

    opt/qlik/gateway/movement/drivers/bin

  3. 執行下列命令：

    語法：

    ./uninstall db2

    將會解除安裝 driver。

手動安裝驅動程式

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

Linux ODBC 用戶端套件

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

資訊備註

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

在 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. 安裝 v11.5.8_linuxx64_server_dec.tar.gz 並選擇「用戶端」選項。

  4. 舉例來說，如果 Data Movement gateway 機器沒有 DB2，透過進行以下指令建立 DB2：

    adduser <db2_instance_name>

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

  5. 變更任務目錄至 <Data Movement gateway_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. 開始 Data Movement gateway 服務：

    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. 停止 Data Movement gateway 服務：

    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. 開始 Data Movement gateway 服務：

    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 命令。

必要權限

若要啟用 Data Movement gateway 以從來源表格擷取資料 (完整載入和變更資料擷取)，必須向 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 擷取變更，Data Movement gateway 會使用特殊程式 (作為外部例行事項叫用)，這是使用者定義的表格函數 (UDTF)。需要先在 z/OS 系統上安裝並設定此程式 (載入模組) 以及 UDTF，才能擷取變更。安裝並設定 R4Z 中描述了應由 DBA 執行的安裝程序。

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

此頁面是否對您有幫助？

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

在此留下意見回饋