跳到主要内容

安装 Qlik DataTransfer

Qlik DataTransfer是一个轻量级 Windows 应用程序,它允许您将本地数据源中的数据上传到 Qlik Sense SaaS 租户,而无需防火墙隧道。服务帐户所有者 (SAO) 或租户管理员从租户生成一个 API 密钥,然后该密钥用于验证 Qlik DataTransfer。经过身份验证后,您可以计划自动重新加载数据或手动上传数据。

备注: Qlik DataTransfer 支持加密通信,但不符合 FIPS(联邦信息处理标准)。Qlik Sense Enterprise SaaS - Government (US) 用户可以在实施过程中使用它,等待自己的风险审查。

Qlik DataTransfer 可用于以下类型的数据源:

  • 应用程序数据
  • 连接数据
  • 文件夹

有关对于 Qlik DataTransfer 可用的数据类型的信息,请参阅通过 Qlik DataTransfer 上传本地数据

Qlik DataTransfer 的安装只能分配给单个 Qlik Sense SaaS 租户。

在开始之前

下载并运行 Qlik DataTransfer 安装程序之前,请确保满足以下要求:

  • 您具有对于 Qlik Sense SaaS 租户的访问权限。
  • 您必须在自己的租户上拥有 Professional 访问权限。
  • 您在该租户上分配了 Developer 角色。
  • 您可以访问向其上传来自 Qlik DataTransfer 的数据的所有空间。有关更多信息,请参阅管理空间
  • 您对有权访问本地数据源的 Windows 计算机具有管理员权限。
  • 您的 Windows 计算机满足以下系统要求: Qlik DataTransfer 的系统要求 (仅提供英文版本)
  • Management Console 禁用了 API 密钥。有关启用 API 密钥的信息,请参阅管理 API 密钥
  • 策略 SSL 配置设置必须设置为仅支持正在安装 Qlik DataTransfer 的计算机上的 IANA 格式的密码。

    如果要在 Windows Server 2012 R2 上安装或升级到 Qlik DataTransfer May 2021 或更高版本,则必须更新 TLS 密码套件。Qlik DataTransfer May 2021 或更高版本不支持 Windows Server 2021 R2 默认安全策略中包含的默认密码。必须提供以下密码套件:

    • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

    • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256

    • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

    • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

    • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

    有关在系统中更新 TLS 密码套件或在 Qlik DataTransfer 环境中禁用弱密码的说明,请参阅以下社区文章:https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406

  • Qlik DataTransfer 需要 Windows 用户帐户。建议您使用专用用户帐户来运行 Qlik DataTransfer 服务。如果专用用户是管理员,则可以作为该用户登录来安装 Qlik DataTransfer。如果专用用户不是本地管理员,则必须使用管理员帐户才能安装 Qlik DataTransfer

    如果要在已安装 Qlik Sense Enterprise on Windows 的Windows服务器上安装或升级 Qlik DataTransfer,则 Qlik DataTransfer 必须与 Qlik Sense 安装中使用的 Qlik Sense服务用户一起安装。

  • 安装 Qlik DataTransfer 的用户帐户必须具有使用 RemoteSigned 执行策略执行 PowerShell 脚本的权限

  • 如果在使用租户配置 Qlik DataTransfer 后更改服务登录帐户,则必须重新配置租户和连接。然后在 %ProgramData%/Qlik/DataTransfer/DataUpload/storage 中,删除 token.json。重启 Qlik DataTransfer 服务。

  • 对于 February 2021 SR1,建议在与 Qlik Sense Enterprise on WindowsQlikView Server 不同的服务器上安装 Qlik DataTransfer。如果 Qlik DataTransfer 安装在 Qlik Sense Enterprise on Windows 服务器 或 QlikView Server 上,则 Qlik DataTransfer 使用本地系统用户帐户运行。如果更改服务用户帐户,它将停止 Qlik DataTransfer 或停止 Qlik Sense 服务调度器

提示: Qlik DataTransfer 安装程序包括 Qlik associative engine、Simba ODBC 连接器和 Qlik DataTransfer 代理的实例。启动时,它会消耗额外的内存和处理资源,如果您的服务器正在与其他应用程序共享资源,则必须考虑这些资源。对于生产环境,建议您在其自己的服务器上安装 Qlik DataTransfer

正在确认安装用户帐户执行策略

安装 Qlik DataTransfer 的用户帐户必须具有使用 RemoteSigned 执行策略执行 PowerShell 脚本的权限。如果您没有权限分配用户帐户权限,请与管理员联系,为安装用户帐户授予这些权限。

  1. 以管理员模式打开 PowerShell。

  2. 运行Get-ExecutionPolicy。它应当为 RemoteSigned。如果为 Restricted Disabled,则继续下个步骤。

  3. 运行Set-ExecutionPolicy RemoteSigned

  4. 选择 Y

下载并运行安装程序

备注:

如果要在已安装 Qlik Sense Enterprise on Windows 的Windows服务器上安装或升级 Qlik DataTransfer,则 Qlik DataTransfer 必须与 Qlik Sense 安装中使用的 Qlik Sense服务用户一起安装。

  1. 从以下任一位置下载 Qlik DataTransfer.exe 文件:

    1. Qlik 下载站点。

    2. 云应用中心。在右上角单击您的个人资料图标,然后单击个人资料设置。该选项在 Qlik Sense Enterprise SaaS - Government (US) 中不可用。

  2. 运行安装程序并接受 Qlik 用户许可协议。默认安装路径为 %Program Files%\Qlik\DataTransfer。输入服务凭据时,用户名的格式必须为 domain\username。

    备注:

    如果输入的用户名长度超过 20 个字符,则必须采用用户主体名称 (UPN) 格式,并且必须包含完整的域名。例如,longusername@full.domain.name

    备注:

    如果您在同一服务器上安装了 Qlik Sense Desktop 或另一个 Qlik 平台,则必须关闭它们,并在您安装 Qlik DataTransfer 之前停止 Qlik 服务。

    Qlik dataTransfer installer screen

    一旦安装,按以下顺序重新启动 Qlik 服务:

    1. Qlik Sense 服务调度器

    2. Qlik Logging Service

    3. Qlik Sense 存储库服务

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense 排程器服务

    7. Qlik Sense 打印服务

  3. 服务凭据窗口中,输入要用于运行 Qlik DataTransfer 服务的帐户的用户名和密码。

安装程序创建了桌面快捷方式,用于启动 Qlik DataTransfer 应用程序。

端口

Qlik DataTransfer 使用以下端口:

服务 端口: 方向

安全 Web 浏览器通信 (HTTPS)

备注: 您必须在自己的防火墙中打开该端口。
443 出站
Data Upload service 5505 内部
Engine service 5506 内部
Connector Registry proxy 5507 内部

如果您与某个默认服务端口发生端口冲突,可以在 services.conf 文件中对其进行更改,该文件位于 %Program Files%\Qlik\DataTransfer

[globals] LogPath="${ALLUSERSPROFILE}\Qlik\DataTransfer\Log" StoragePath="${ALLUSERSPROFILE}\Qlik\DataTransfer" DataUploadServicePort=5505 EnginePort=5506 ConnectorRegistryPort=5507

日志和数据文件存储

Qlik DataTransfer 日志文件位于此处:%ProgramData%\Qlik\DataTransfer\Log

Qlik DataTransfer 数据连接位于此处:%ProgramData%\Qlik\DataTransfer\DataUpload

可以在 services.conf 文件中更改默认存储路径,该文件位于 %Program Files%\Qlik\DataTransfer

[globals] LogPath="${ALLUSERSPROFILE}\Qlik\DataTransfer\Log" StoragePath="${ALLUSERSPROFILE}\Qlik\DataTransfer" DataUploadServicePort=5505 EnginePort=5506 ConnectorRegistryPort=5507
备注: 建议您将存储文件夹中的文件备份到安全位置。

生成 API 密钥

API 密钥过期。默认过期时间可能不适合您的业务需要。在生成 API 密钥之前,请考虑更改 Management Console 设置中的最大令牌过期时间。相关信息,请参阅在租户中启用 API 密钥

执行以下操作:

  1. 登录您的 Qlik Sense SaaS 租户。
  2. 在云应用中心内,于右上角单击您的个人资料图标,然后单击个人资料设置
  3. 选择 API 密钥
  4. 选择生成新的密钥

    Cloud hub settings menu, generate API key
  5. 输入API 密钥的名称并选择到期剩余时间
  6. 单击生成

    Generate new API key screen

  7. 单击复制并关闭将 API 复制到剪贴板。

    备注: 务必保存 API 密钥。您需要该密钥来验证 Qlik DataTransfer
    API key summary screen

    现在您有了 API 密钥,可以在 Qlik DataTransferQlik Sense SaaS 租户之间创建安全连接。API 密钥用于在向租户上传数据时验证 Qlik DataTransfer。由于 API 有过期时间,因此您需要创建一个新的 API 密钥,并在该密钥过期时重新验证 Qlik DataTransfer。如果 API 密钥过期,则不需要重新创建数据连接。

验证 Qlik DataTransfer

执行以下操作:

  1. 打开 Qlik DataTransfer

    第一次打开 Qlik DataTransfer 时,将显示设置 Qlik DataTransfer 验证屏幕。

    Qlik dataTransfer API key connection screen
  2. 输入连接的名称。
  3. 输入指向 Qlik Sense SaaS 租户的 URL。
  4. 粘贴从租户生成的 API 密钥。

  5. 单击应用以验证租户。

  6. 当 API 密钥过期或对另一租户验证 Qlik DataTransfer 时,单击 以输入新的 API 密钥,然后单击确认

一旦验证了 Qlik DataTransfer,可以将本地数据上传至 Qlik Sense SaaS 租户。有关如何使用 Qlik DataTransfer 的信息,请参阅 通过 Qlik DataTransfer 上传本地数据

备注: 如果在使用租户配置 Qlik DataTransfer 后更改服务登录帐户,则必须重新配置租户和到 ODBC 数据源的连接。

升级 Qlik DataTransfer

Qlik DataTransfer 在有新版本可用时显示通知横幅。Qlik DataTransfer 未自动升级至较新的版本。

警告:

如果您为存储配置文件选择了不同的位置,或者从配置文件 Service.conf 选择了运行 Qlik DataTransfer 的不同端口,则升级将覆盖它。在升级之前备份 Service.conf 文件,并在升级完成后将其复制到默认配置文件夹以保留设置。

如果 Qlik DataTransfer 正在使用本地系统帐户,则不会提示您输入服务用户凭据并继续使用本地系统。

Qlik DataTransfer upgrade banner

执行以下操作:

  1. 从应用程序中横幅或 Qlik 下载站点下载 Qlik DataTransfer 的新版本。
  2. 关闭 Qlik DataTransfer 的当前版本。
  3. 运行 Qlik DataTransfer 安装程序。

    备注:

    如果要在已安装 Qlik Sense Enterprise on Windows 的 Windows 服务器上安装 Qlik DataTransfer,则 Qlik DataTransfer 必须用 Qlik Sense 安装中使用的 Qlik Sense服务用户升级。

  4. 单击升级

    Upgrade QlikDataTransfer window

卸载 Qlik DataTransfer

备注: 当卸载 Qlik DataTransfer 时,安装程序会移除所有 Qlik DataTransfer 文件和文件夹。您应当保存自己希望保存到新位置的任何文件或文件夹。

执行以下操作:

  1. 运行 Qlik DataTransfer 安装程序。

    备注:

    如果您在同一服务器上安装了 Qlik 平台,则必须停止其他 Qlik 服务,然后才能卸载 Qlik DataTransfer

  2. 单击卸载
  3. 一旦卸载,如果适用,按以下顺序重新启动 Qlik 服务:

    1. Qlik Sense 服务调度器

    2. Qlik Logging Service

    3. Qlik Sense 存储库服务

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense 排程器服务

    7. Qlik Sense 打印服务

限制

Qlik DataTransfer 存在以下限制:

  • 从 October 2020 或更高版本升级时,存储配置文件的位置和用于运行 Qlik DataTransfer 的端口在配置文件 Service.conf 中更改为默认位置。如果未使用存储配置文件的默认位置或用于运行 Qlik DataTransfer 的默认端口,则将丢失这些设置。要保留您的设置,请在升级之前备份 Service.conf,并在升级完成后从备份文件中重做 Service.conf 中的设置。

  • 如果未使用默认位置在 Service.conf 中存储配置文件,则需要手动删除所选文件夹中的文件。