设置 数据移动 网关
设置 数据移动 网关涉及需要在Administration和 数据移动 网关服务器上执行的步骤。
- 所有 CLI 命令都必须在 数据移动 网关服务器上运行。
- 安装 (RPM) 和服务命令必须以 sudo 或 root 身份运行。
-
需要在 Administration 中执行的 数据移动 网关过程需要租户管理权限。
另请参阅: 将数据网关与空间关联时的注意事项
阶段一:下载 数据移动 网关
-
要访问数据网关,请从启动器菜单 () 中选择 管理,然后选择数据网关。
所有现有的数据网关都将列在一个表中,其中显示了每个网关的基本信息。
-
单击部署工具栏按钮。
部署数据网关对话框打开。
-
选择 数据网关 - 数据移动 并接受 Qlik 客户协议,然后单击下载。
数据移动 网关 (qlik-data-gateway-data-movement.rpm) 将被下载到您的计算机上。
阶段二:安装并设置 数据移动 网关
这个阶段包括 数据移动 网关、设置 Qlik Cloud URL 和生成注册密钥。您需要将密钥复制到 Administration 中的 数据移动 网关设置(在下面的阶段三中)。密钥用于在 数据移动 网关和 Qlik Cloud 租户之间建立经过身份验证的连接。
-
下载完成后,将 RPM 文件复制到要安装 数据移动 网关的 Linux 计算机上。确保计算机位于防火墙后面,并且可以与数据源和 Qlik Cloud 通信。
-
打开 shell 提示符并将工作目录更改为包含 RPM 的目录:
示例:
/qlik/GatewayRPM/
-
运行以下命令:以安装 数据移动 网关。
语法:
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 (仅提供英文版本)
-
安装完成后,将工作目录更改为:
/opt/qlik/gateway/movement/bin
然后运行以下命令:
设置 Qlik Cloud 租户和代理服务器
信息注释如果您需要通过代理连接到云数据仓库或存储,请确保在登录设置中打开了相关选项:
- 使用代理连接到云数据仓库
- 使用代理连接到存储
如果这两个选项都未打开,则代理连接将仅指向 Qlik Cloud。
有关这些选项的详细信息,请参阅从数据源登陆数据。
运行以下命令以设置 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@
另请参阅: 管理 数据移动网关 服务器
设置 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 管理员联系。生成并显示注册密钥
密钥用于在数据移动网关和 Qlik Cloud 租户之间建立经过身份验证的连接。
运行以下命令以生成并显示密钥:
./agentctl qcs get_registration
显示密钥:
-
复制整个密钥,如上面的示例所示。您需要在下一阶段将其粘贴到 管理中。
阶段三:返回至Administration并注册 数据移动 网关
-
要访问数据网关,请从启动器菜单 () 中选择 管理,然后选择数据网关。
所有现有的数据网关都将列在一个表中,其中显示了每个网关的基本信息。
-
单击创建。
创建数据网关对话框打开。
-
指定 数据移动 网关的名称。
-
(可选)提供 数据移动 网关的描述。
-
从网关类型下拉列表中,选择数据移动。
-
从关联空间 下拉列表中,选择一个空间。另请参阅将数据网关与空间关联时的注意事项。
-
将先前生成的注册密钥粘贴到密钥字段中。
-
单击创建。
数据移动 网关已添加到 数据网关 列表中并启用。
阶段四:在 数据移动 网关服务器上启动 数据移动 网关服务
-
然后运行以下命令:
sudo systemctl start repagent
-
通过运行以下命令检查服务是否已启动:
sudo systemctl status repagent
状态应如下所示:
Active: active (running) since <timestamp> ago
阶段五:在数据项目中使用 数据移动 网关数据源
-
要访问数据网关,请从启动器菜单 () 中选择 管理,然后选择数据网关。
所有现有的数据网关都将列在一个表中,其中显示了每个网关的基本信息。
-
刷新浏览器以确保 数据网关 表是最新的。
-
在 数据网关 中找到您的网关,并验证其状态是否为“已连接”。
一旦您在管理中验证了 数据移动 网关已“连接”,您就可以使用它来访问您的数据源和支持的目标。
使用 数据移动网关
使用 Qlik 数据网关 - 数据移动 时,流程应如下:
- 如上所述,安装一个或多个 数据移动网关(取决于您的用例)并配置与 Qlik Cloud 租户的连接。
- 安装数据源所需的驱动程序并满足任何其他先决条件,如 设置与数据源的连接 中所述。根据您的使用情况,驱动程序可能需要安装在靠近源部署的 数据移动网关 上。
- 安装目标平台所需的驱动程序并满足任何其他先决条件,如 建立与目标的连接 中所述。根据您的使用情况,驱动程序可能还需要安装在靠近目标部署的 数据移动网关 上。
- 为数据源配置连接器,如设置与数据源的连接中所述。
- 为您的目标平台配置连接器,如建立与目标的连接中所述。
- 创建项目并运行所需任务,如创建数据管道中所述。
将数据网关与空间关联时的注意事项
将数据移动网关与空间关联时(请参阅上面的步骤 3),您应该注意以下事项:
- 只能在数据空间中创建数据网关。
- 为了能够在一个空间中创建使用另一个空间的数据网关的连接,您必须在数据网关空间中具有可以使用数据角色。
-
要创建数据网关,用户需要是空间所有者或具有可以管理角色。此外,用户需要 专业或 Full User 授权。手动分配 专业授权,或在 Administration 中开启启用 Professional 用户的动态分配。
有关用户权限和 Professional 访问授权动态分配的更多信息,请参阅管理用户权利
- 数据网关只能与单个空间关联。