# 設定 資料移動閘道

設定 資料移動閘道 涉及在 管理 和 資料移動閘道 伺服器都需要執行的程序。

資訊備註

* 所有 CLI 命令都必須在 資料移動閘道 伺服器上執行。

* 安裝 (RPM) 和服務命令必須以 sudo 或做為根執行。

* 需要在 資料移動閘道 中執行的 管理 程序需要租用戶管理員權限。

  另請參閱：[聯結資料閘道與空間時的考慮事項](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-setting-up.htm#Consider)

如果您想使用知識市集，請參閱[設定知識超市的 Qlik 資料閘道 - 資料移動](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/gateways-for-knowledge-mart.htm)。

## 階段一：下載 資料移動閘道

1. 若要存取資料閘道，從啟動器功能表 (選取 管理the 資料閘道 icon)，然後是。

   所有現有資料閘道將列於[顯示關於每個閘道基本資訊的表格](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing-console.htm#gateprop)。

2. 按一下部署工具列按鈕。

3. 選取 資料閘道 - 資料移動，接受 Qlik 客戶協議，並按一下下載。

   資料移動閘道 RPM (qlik-data-gateway-data-movement.rpm) 會下載到您的機器。

## 階段二：安裝並設定 資料移動閘道

此階段涉及安裝 資料移動閘道、設定 Qlik Cloud URL，以及產生註冊金鑰。您將需要將金鑰複製到 管理 中的 資料移動閘道 設定 (在以下的階段三)。金鑰用來建立 資料移動閘道 和 Qlik Cloud 租用戶之間的已驗證連線。

警告備註在啟用 SELinux 的系統上安裝 資料移動閘道 時，最佳實務是使用預設安裝路徑。如果您想使用不同的路徑，請聯絡 [Qlik 支援](https://community.qlik.com/t5/Support/ct-p/qlikSupport)。

1. 一旦下載完畢，將 RPM 檔案複製到您想安裝 資料移動閘道 的 Linux 機器。確定機器在防火牆後方，並且能與資料來源和 Qlik Cloud 通訊。

2. 開啟 shell 提示，將任務目錄變更為含有 RPM 的目錄：

   範例：

   /qlik/GatewayRPM/

3. 執行以下命令，以安裝 資料移動閘道。

   語法：

   QLIK\_CUSTOMER\_AGREEMENT\_ACCEPT=yes rpm -ivh gateway-rpm

   範例：

   sudo QLIK\_CUSTOMER\_AGREEMENT\_ACCEPT=yes rpm -ivh qlik-data-gateway-data-movement.rpm

   如要檢閱 Qlik 客戶協議，請至https://www.qlik.com/us/-/media/files/legal/license-agreements/qlik/qlik-customer-agreement-english.pdf （僅提供英文版）

4. 安裝完成後，將任務目錄變更至：

   /opt/qlik/gateway/movement/bin

   然後執行下列命令：

   ### 設定 Qlik Cloud 租用戶和 Proxy 伺服器

   資訊備註

   若您需要透過 Proxy 連線至雲端資料倉庫或儲存空間，請確認在登陸設定中開啟相關選項：

   * 使用 Proxy 連線至雲端資料倉庫
   * 使用 Proxy 連線至儲存空間

   若沒有開啟這些選項，Proxy 連線只會連線至 Qlik Cloud。

   如需更多關於這些選項的資訊，請參閱 [從資料來源登陸資料](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/Landing-data-data-sources.htm)。

   執行以下命令，以設定 Qlik Cloud 租用戶 URL 和 Proxy 伺服器 URL (選用)：

   在沒有 Proxy 伺服器的情況下設定 Qlik Cloud 租用戶 URL 的命令：

   語法：

   ./agentctl qcs set\_config --tenant\_url URL

   範例：

   ./agentctl qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

   設定 Qlik Cloud 租用戶 URL 和 Proxy 伺服器 URL 的命令：

   語法：

   ./agentctl qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url https|http://host:port --proxy\_username username --proxy\_password password

   範例：

   ./agentctl qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url https://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

   另請參閱：[管理 資料移動閘道 伺服器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing.htm)

   ### 設定 CA 搭售

   CA 搭售驗證 Qlik Cloud 租用戶的身分，藉此確保受信任的連線。

   誰需要設定 CA 搭售？

   只有在您是下列身分時，才需要設定 CA 搭售：

   * Qlik Cloud 政府 客戶
   * 使用作為 Proxy 運作的安全性設備並以自己的 CA 根憑證取代從網際網路收到的憑證資訊的 Qlik Cloud 商務客戶

   我應該使用哪個搭售？

   客戶應使用 Qlik CA 搭售或攜帶自己的 CA 搭售，如下所示：

   * Qlik 提供 CA 搭售： 應由具有標準環境的 Qlik Cloud 政府 客戶使用。標準環境沒有作為 Proxy 運作的安全性設備，並以自己的 CA 根憑證取代從網際網路收到的憑證資訊。

     資訊備註您可以重新命名 CA 搭售檔案，但請確認這具有 .pem 副檔名 (例如 qlikcerts.pem)。然後執行以下描述的命令。

   * 客戶自備 CA 搭售：若客戶的環境所使用的安全性設備充當代理，並以其自有的 CA 根憑證取代從網際網路接收到的憑證資訊，則應使用此選項。若這些憑證是自行簽署，則除了設定 CA 搭售的命令，您也需要執行命令以允許 CA 搭售。以下描述這兩種命令。這適用於 Qlik Cloud 政府 客戶和 Qlik Cloud 商務客戶等。

   設定 CA 搭售的命令

   執行下列命令以設定 CA 憑證搭售：

   語法：

   ./agentctl qcs set\_config --ca\_bundle\_path path-to-ca-bundle-file

   範例：

   ./agentctl qcs set\_config --ca\_bundle\_path /etc/ssl/certs/cacerts.pem

   允許 CA 搭售的命令

   有些環境使用作為 Proxy 運作的安全性設備，並以自己的 CA 根憑證取代從網際網路收到的憑證資訊. 只有在安全性設備本身使用自行簽署的憑證時，才需要執行此命令。在此情況下，CA 搭售可能不受信任，除非您執行下列命令：

   ./agentctl qcs set\_config --ca\_bundle\_allow\_invalid\_certs true

   資訊備註若您不確定您的環境是否使用這種安全性設備，請聯絡 IT 管理員。

   ### 產生並顯示註冊金鑰

   金鑰用來建立資料移動閘道和 Qlik Cloud 租用戶之間的已驗證連線。

   執行以下命令，以產生並顯示金鑰：

   ./agentctl qcs get\_registration

   就會顯示金鑰：

   ![資料移動註冊金鑰影像](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/dm_reg_key.png)

5. 複製整個金鑰，如上面範例所示。您將需要在下一階段的 管理中貼上。

## 階段三：返回 管理 並註冊 資料移動閘道

1. 若要存取資料閘道，從啟動器功能表 (選取 管理the 資料閘道 icon)，然後是。

   所有現有資料閘道將列於[顯示關於每個閘道基本資訊的表格](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing-console.htm#gateprop)。

2. 按一下建立。

   就會開啟建立資料閘道對話方塊。

   ![建立資料閘道的對話方塊影像](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_dm-gate-create.png)

3. 為 資料移動閘道指定名稱。

4. 或者可選擇提供 資料移動閘道 的描述。

5. 從閘道類型下拉式清單中，選取資料移動。

6. 從相關空間下拉式清單中，選取空間。另請參閱 [聯結資料閘道與空間時的考慮事項](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-setting-up.htm#Consider)。

7. 在金鑰欄位中貼上您之前產生的註冊金鑰。

8. 按一下建立。

   可將 資料移動閘道 在啟用狀態下新增至 資料閘道 清單。

## 階段四：在 資料移動閘道 伺服器上啟動 資料移動閘道 服務

1. 執行下列命令：

   sudo systemctl start repagent

2. 執行以下命令，檢查該服務是否啟動：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: active (running) since <timestamp> ago

   警告備註啟動閘道服務後，您必須重新整理瀏覽器，以檢視 管理中更新的資料閘道狀態 (已連線)。

## 階段五：在資料專案中使用 資料移動閘道 資料來源

1. 若要存取資料閘道，從啟動器功能表 (選取 管理the 資料閘道 icon)，然後是。

   所有現有資料閘道將列於[顯示關於每個閘道基本資訊的表格](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing-console.htm#gateprop)。

2. 重新整理瀏覽器，以確定 資料閘道 表格為最新狀態。

3. 在 資料閘道 表格中找到您的閘道，確認其狀態為「已連線」。

在管理中驗證 資料移動閘道 為「已連線」後，您可以用來存取資料來源和支援的目標。

如需更多資訊，請參閱 [設定前往資料來源的連線](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-data-2.htm) 和 [設定前往目標的連線](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/data-project-connections.htm#top)。

## 使用 資料移動閘道

使用 Qlik 資料閘道 - 資料移動 的流程如下：

1. 在至少一個機器上設定 資料移動閘道 (根據您的[使用情況](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common))，並設定與 Qlik Cloud 租用戶的連線功能。
2. 依[設定前往資料來源的連線](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-data-2.htm)所述，安裝資料來源所需的驅動程式，並滿足任何其他必要條件。可能需要在靠近您來源部署的 資料移動閘道 伺服器安裝驅動程式，視您的[使用情況](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common)而定。
3. 依[設定前往目標的連線](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/data-project-connections.htm#top)所述，安裝目標平台所需的驅動程式，並滿足任何其他必要條件。可能也需要在靠近您目標部署的 資料移動閘道 伺服器安裝驅動程式，視您的[使用情況](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common)而定。
4. 依[設定前往資料來源的連線](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-data-2.htm)所述，設定資料來源的連接器。
5. 依[設定前往目標的連線](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/data-project-connections.htm#top)所述，設定目標平台的連接器。
6. 依[建立與管理資料管道專案](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Introduction/Data-projects.htm)所述，建立專案並執行所需任務。

## 聯結資料閘道與空間時的考慮事項

聯結 Data Movement gateway 與空間 (請參閱上面的步驟 3) 時，請注意下列事項：

* 只能在資料空間中建立資料閘道。

* 若要在一個使用另一個空間中資料閘道的空間中建立連線，您在資料閘道空間中必須有可以取用資料角色。

* 若要建立資料閘道，您必須是空間擁有者或擁有可以管理角色。對於基於使用者的訂閱，您也需要專業使用者權利。如需詳細資訊，請參閱 [管理使用者權利](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/SaaS-user-allocations.htm)。

* 資料閘道只能與單一空間聯結。

相關學習內容：

* [Qlik 資料閘道 - 資料移動概述](https://help.qlik.com/lnk/Introduction_data_gateway_movement)

## 瞭解更多資訊

* [Qlik 資料閘道 - 資料移動概述](https://help.qlik.com/lnk/Introduction_data_gateway_movement)