跳到主要內容 跳至補充內容

必要條件

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

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

    資訊備註

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

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

  • 設定資料來源連接器

在 z/OS 上安裝 R4Z 產品

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

  1. 移至 產品下載

  2. 選取 Qlik 資料整合

  3. 向下捲動產品清單並選取 Qlik Talend Data Integration

  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.yamlbinary-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. 資料移動 閘道機器上,將工作目錄變更為:

    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

  8. 等待安裝完成 (以「完成!」指示),然後開始 Data Movement gateway 服務:

    sudo systemctl start repagent

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

    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. 資料移動 閘道機器上,將工作目錄變更為:

    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

  8. 等待安裝完成 (以「完成!」指示),然後開始 Data Movement gateway 服務:

    sudo systemctl start repagent

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

    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」設定為「假」。

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

  7. 開始 Data Movement gateway 服務:

    sudo service repagent start
  8. 可自行選擇確認服務已開始:

    sudo service repagent status

    狀態應如下所示:

    Active: active (running) since <timestamp> ago

*-----------------------------------------------------
* 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 進行此動作,

此頁面是否對您有幫助?

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