# 设置 数据移动网关

设置 数据移动网关 涉及需要在 Administration 和 数据移动网关 服务器上执行的步骤。

信息注释

* 所有 CLI 命令都必须在 数据移动网关 服务器上运行。

* 安装 (RPM) 和服务命令必须以 sudo 或 root 身份运行。

* 需要在 Administration 中执行的 数据移动网关 过程需要租户管理权限。

  另请参阅：[将数据网关与空间关联时的注意事项](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-setting-up.htm#Consider)

如果您想使用知识集市，请参阅 [设置知识集市的 Qlik 数据网关 - 数据移动](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/gateways-for-knowledge-mart.htm)。

## 阶段一：下载 数据移动网关

1. 要访问数据网关，请选择 管理 从启动器菜单 (the 数据网关 icon），然后是。

   所有现有的数据网关都将列在[一个表中，其中显示了每个网关的基本信息](https://help.qlik.com/zh-CN/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 和生成注册密钥。您需要将密钥复制到 Administration 中的 数据移动网关 设置（在下面的阶段三中）。密钥用于在 数据移动网关 和 Qlik Cloud 租户之间建立经过身份验证的连接。

警告注释在安装 数据移动网关 到启用了 SELinux 的系统上时，最佳实践是使用默认安装路径。如果您想使用不同的路径，请联系 [x](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 租户和代理服务器

   信息注释

   如果您需要通过代理连接到云数据仓库或存储，请确保在登录设置中打开了相关选项：

   * 使用代理连接到云数据仓库
   * 使用代理连接到存储

   如果这两个选项都未打开，则代理连接将仅指向 Qlik Cloud。

   有关这些选项的详细信息，请参阅[从数据源登陆数据](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/Landing-data-data-sources.htm)。

   运行以下命令以设置 Qlik Cloud 租户 URL，并且可选择设置您的代理服务器 URL：

   用于没有代理服务器时设置 Qlik Cloud 租户 URL 的命令：

   语法：

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

   示例：

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

   用于设置 Qlik Cloud 租户 URL 和代理服务器 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-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing.htm)

   ### 设置 CA 捆绑包

   CA 捆绑包验证 Qlik Cloud 租户的身份，从而确保可信连接。

   谁需要设置 CA 捆绑包？

   只有在以下情况下才需要设置 CA 捆绑包：

   * Qlik Cloud 政府 客户
   * 一个 Qlik Cloud 商业客户使用安全设备作为代理，并用其自己的 CA 根证书替换从互联网接收的证书信息

   我应该使用哪个捆绑包？

   客户应使用 Qlik CA 捆绑包或自带 CA 捆绑包，如下所示：

   * Qlik 提供 CA 捆绑： 应由拥有标准环境的 Qlik Cloud 政府 客户使用。标准环境是一种没有安全设备的环境，该安全设备充当代理，并将从互联网接收的证书信息替换为其自己的 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 捆绑包的命令

   某些环境使用安全设备作为代理，并用其自己的 CA 根证书替换从互联网接收的证书信息. 仅当安全设备本身使用自签名证书时，才需要运行此命令。在这种情况下，除非运行以下命令，否则 CA 捆绑包可能不受信任：

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

   信息注释如果您不确定您的环境是否使用此安全设备，请与 IT 管理员联系。

   ### 生成并显示注册密钥

   密钥用于在 Data Movement gateway 和 Qlik Cloud 租户之间建立经过身份验证的连接。

   运行以下命令以生成并显示密钥：

   ./agentctl qcs get\_registration

   显示密钥：

   ![数据移动注册密钥的图像](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/dm_reg_key.png)

5. 复制整个密钥，如上面的示例所示。您需要在下一阶段将其粘贴到 管理中。

## 阶段三：返回至 Administration 并注册 数据移动网关

1. 要访问数据网关，请选择 管理 从启动器菜单 (the 数据网关 icon），然后是。

   所有现有的数据网关都将列在[一个表中，其中显示了每个网关的基本信息](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing-console.htm#gateprop)。

2. 单击创建。

   创建数据网关对话框打开。

   ![创建数据网关的对话框图像](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_dm-gate-create.png)

3. 为 数据移动网关 指定一个名称。

4. （可选）为 数据移动网关 提供描述。

5. 从网关类型下拉列表中，选择数据移动。

6. 从关联空间下拉列表中，选择一个空间。另请参阅 [将数据网关与空间关联时的注意事项](https://help.qlik.com/zh-CN/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-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing-console.htm#gateprop)。

2. 刷新浏览器以确保 数据网关 表是最新的。

3. 在 数据网关 表中找到您的网关，并验证其状态是否为“已连接”。

一旦您在管理中验证了 数据移动网关“已连接”，您就可以使用它来访问您的数据源和支持的目标。

有关更多信息，请参阅[设置与数据源的连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-data-2.htm)和[建立与目标的连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/data-project-connections.htm#top)。

## 使用 数据移动网关

使用 Qlik 数据网关 - 数据移动 时，流程应如下：

1. 如上所述，在至少一台机器上设置 数据移动网关（取决于您的[用例](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common)），并配置与 Qlik Cloud 租户的连接。
2. 安装数据源所需的驱动程序并满足任何其他先决条件，如 [设置与数据源的连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-data-2.htm) 中所述。根据您的数据移动网关使用情况[，驱动程序可能需要安装在靠近源部署的](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common) 服务器上。
3. 安装目标平台所需的驱动程序并满足任何其他先决条件，如 [建立与目标的连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/data-project-connections.htm#top) 中所述。根据您的数据移动网关使用情况[，驱动程序可能还需要安装在靠近目标部署的](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common) 服务器上。
4. 为数据源配置连接器，如[设置与数据源的连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-data-2.htm)中所述。
5. 为您的目标平台配置连接器，如[建立与目标的连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/data-project-connections.htm#top)中所述。
6. 创建项目并运行所需任务，如[创建和管理数据管道项目](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Introduction/Data-projects.htm)中所述。

## 将数据网关与空间关联时的注意事项

将 Data Movement gateway 与空间关联时（请参阅上面的步骤 3），注意以下事项：

* 只能在数据空间中创建数据网关。

* 为了在一个空间中创建使用另一个空间的数据网关的连接，您必须在数据网关空间中具有可以使用数据角色。

* 要创建数据网关，您必须是空间所有者或具有可管理角色。对于基于用户的订阅，您还需要专业用户权限。有关更多信息，请参阅[管理用户使用权](https://help.qlik.com/zh-CN/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)