安装 Qlik DataTransfer

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

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

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

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

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

Qlik DataTransfer 系统要求

在开始之前

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

• 您具有对于 Qlik Cloud 租户的访问权限。
• 您是一个在该租户上具有 专业或 Full User 授权的用户。
• 您被分配给该租户的开发人员角色。
• 您可以访问向其上传来自 Qlik DataTransfer 的数据的所有空间。有关更多信息，请参阅管理空间。
• 您对有权访问本地数据源的 Windows 计算机具有管理员权限。
• 您的 Windows 计算机满足以下系统要求：Qlik DataTransfer 的系统要求 （仅提供英文版本）。
• 在 Administration 活动中心中启用了 API 密钥。有关启用 API 密钥的信息，请参阅管理 API 密钥。

• 策略 SSL 配置设置必须设置为仅支持正在安装 Qlik DataTransfer 的计算机上的 IANA 格式的密码。

  如果要在 Windows Server 2012 R2 上安装或升级到 Qlik DataTransfer May 2021 或更高版本，则必须更新 TLS 密码套件。Qlik DataTransfer May 2021 或更高版本不支持 Windows Server 2012 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 Windows 或 QlikView Server 不同的服务器上安装 Qlik DataTransfer。如果 Qlik DataTransfer 安装在 Qlik Sense Enterprise on Windows 服务器 或 QlikView Server 上，则 Qlik DataTransfer 使用本地系统用户帐户运行。如果更改服务用户帐户，它将停止 Qlik DataTransfer 或停止 Qlik Sense 服务调度器。

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

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

执行以下操作：

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

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

3. 运行Set-ExecutionPolicy RemoteSigned。

4. 选择 Y。

下载并运行安装程序

执行以下操作：

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

   • 产品下载
     有关更多信息，请参阅下载工具和安装文件。

   • Qlik Cloud
     在右上角单击您的配置文件图标，然后单击配置文件设置。在其他下，单击工具。

     Qlik Cloud Government 注释该选项在 Qlik Cloud 政府 中不可用。

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

   信息注释

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

   信息注释

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

   

   一旦安装，按以下顺序重新启动 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 服务的帐户的用户名和密码。

4. 请参阅配置 Qlik DataTransfer以自定义 services.config 文件中的其他设置。

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

生成 API 密钥

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

执行以下操作：

1. 登录您的 Qlik Cloud 租户。
2. 在活动中心内，在右上角单击您的个人资料图标，然后单击配置文件设置。
3. 选择 API 密钥。

4. 选择生成新的密钥。

   
5. 输入API 密钥的名称并选择到期剩余时间。

6. 单击生成。

   

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

   信息注释务必保存 API 密钥。您需要该密钥来验证 Qlik DataTransfer。
   

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

验证 Qlik DataTransfer

执行以下操作：

1. 打开 Qlik DataTransfer。

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

   
2. 输入连接的名称。
3. 输入指向 Qlik Cloud 租户的 URL。

4. 粘贴从租户生成的 API 密钥。

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

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

   

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

升级 Qlik DataTransfer

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

执行以下操作：

1. 从应用程序中横幅或 产品下载 下载 Qlik DataTransfer 的新版本。
2. 关闭 Qlik DataTransfer 的当前版本。

3. 运行 Qlik DataTransfer 安装程序。

   信息注释

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

4. 单击升级。

   

卸载 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 中存储配置文件，则需要手动删除所选文件夹中的文件。

• 如果使用代理，则必须使用 Qlik Cloud 租户 URL为 Qlik DataTransfer 向防火墙添加一个旁路。如果没有旁路，Qlik DataTransferQlik DataTransfer 将无法连接到 Qlik Cloud。

• Qlik DataTransfer 应按照 Qlik DataTransfer 系统要求 中的规定安装在专用的 Window Server 上。请勿将其安装在实际的数据源服务器上或已安装 Qlik Data Gateway - Direct Access 的服务器上。