# 必要條件 在您可以登陸或複寫資料之前，確認完成下列先決條件： * 在 資料移動閘道 伺服器安裝必要 driver 資訊備註 只有在您選擇使用 資料移動閘道 時，才需要此。如需關於 資料移動閘道 福利以及何時需要的資訊，請參閱 [Qlik Data Gateway - Data Movement](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm)。 * 在資料來源授予必要權限 * 設定資料來源連接器 ## 在 z/OS 上安裝 R4Z 產品 您必須先在 z/OS 上安裝並設定 R4Z 產品，才能使用 z/OS 版 IBM DB2 來源。 1. 移至 [產品下載](https://community.qlik.com/t5/Downloads/tkb-p/Downloads)。 2. 選取 Qlik 資料整合。 3. 在產品清單中，選取 Qlik Replicate。 4. 在版本清單中，選擇與您的 資料移動閘道 版本的發佈日期 (年份和月份) 相對應的 Qlik Replicate 版本。例如，如果您的 資料移動閘道 版本是 2024.5.54 (年份.月份.版本)，請選取 May 2024。 5. 在版本號碼清單中，選擇初始版本。 6. 在下載連結欄中，按一下 QlikReplicate\_<version>\_r4z.zip 連結以開始下載。 7. 下載後，安裝在 z/OS 資料來源。 如需安裝和設定說明，請參閱 [安裝並設定 R4Z](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/R4Z_Install_Config/concept-design.htm)。 ## 安裝並設定驅動程式 您可以使用驅動程式安裝公用程式 (建議) 或手動安裝 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. 停止 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。 將會安裝 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. 在 資料移動 閘道機器上，將工作目錄變更為： 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。 將會解除安裝舊版 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. 在 資料移動 閘道機器上，將工作目錄變更為： opt/qlik/gateway/movement/drivers/bin 3. 執行下列命令： 語法： ./uninstall db2 將會解除安裝 driver。 ### 手動安裝驅動程式 只有在自動驅動程式安裝無法成功完成時，才能嘗試手動安裝 driver。 #### Linux ODBC 用戶端套件 您可以在安裝完整 ODBC 用戶端套件或僅安裝資料伺服器用戶端之間選擇，如以下 [Linux 資料伺服器用戶端](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/IBM4DB2-zos/prerequisites-zos.htm#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 ` `/opt/ibm/db2/V11.5/instance/db2icrt ` 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](https://www.ibm.com/support/fixcentral/swg/downloadFixes?parent=ibm~Information%20Management&product=ibm/Information+Management/IBM+Data+Server+Client+Packages&release=11.5.*&platform=All&function=fixId&fixids=DSClients-115-linuxx64-RECOMMENDED&includeRequisites=0&includeSupersedes=0&downloadMethod=http) 下載 v11.5.9\_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 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 網站上的[設定開發人員和執行時間環境](https://www.ibm.com/support/knowledgecenter/en/SSEPGG_11.1.0/com.ibm.db2.luw.apdv.cli.doc/doc/r0007866.html)中描述了此動作。如需關於 DB2CLI 公用程式的資訊，包括繫結公用程式的範例，請參閱 IBM 網站上的 [db2cli - DB2 互動式 CLI 命令](https://www.ibm.com/support/knowledgecenter/en/SSEPGG_11.1.0/com.ibm.db2.luw.admin.cmd.doc/doc/r0002045.html)。 ## 必要權限 若要啟用 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](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/R4Z_Install_Config/concept-design.htm) 中描述了應由 DBA 執行的安裝程序。 此外，必須為每個您想要擷取其變更的表格設定資料擷取變更屬性。您可以手動進行此動作，或在 連接器 設定中啟用自動啟用資料擷取變更 (需要管理員權限) 選項 (預設)，以允許 Data Movement gateway 進行此動作，