跳到主要内容

故障排除 Qlik DataTransfer

本节介绍使用 Qlik DataTransfer 时可能会发生的问题。

Qlik DataTransfer 转到白色屏幕

我打开了 Qlik DataTransfer,但是仅显示白色屏幕。在检查 Windows 中的服务时,Qlik DataTransfer 显示为在运行。

可能的原因  

可能存在以下一个或多个问题。

  • 客户端证书不可从该位置获得:C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate

  • 服务器证书不可从该位置获得:C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate

  • 证书和无效。

  • 证书链无效。

  • Windows 证书存储区中不存在证书。

建议的操作  

如果仅 Qlik DataTransfer 安装在计算机上,进行以下操作:

  1. 在 Windows 服务中,停止 Qlik DataTransfer 服务。

  2. 导航至 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 并删除其中的证书。
  3. 导航至 C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils

  4. 在 PowerShell 中运行 Remove-Certificate.ps1

  5. 启动 Qlik DataTransfer 服务。

  6. 导航至 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 并确认以下文件存在:

    • client.pfx

    • server.pfx

如果仅 Qlik DataTransferQlik Sense Enterprise on Windows 安装在计算机上,进行以下操作:

  1. 在 Windows 服务中,停止 Qlik DataTransfer 服务。

  2. 导航至 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 并删除文件夹中的证书。
  3. 在 Windows Certificate Store 中,删除以下证书:

    • 本地计算机 > 个人 > QdtClient

    • 本地计算机 > 受信任的根证书颁发机构 > <hostname.domain> 或 <hostname>

    • 当前用户 > 个人 > QdtClient

    也可以在 PowerShell 中作为管理员运行 Remove-Certificate.ps1

  4. 作为 Qlik Sense 服务用户,在 PowerShell 中运行 Configure-Service.ps1

    1. 对于第一个输入 dataTransferCertificatePath,输入 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate

    2. 对于第二个输入 qsefwPresent,输入 Yes

  5. 导航至 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 并确认以下文件存在:

    • root.pfx

    • client.pfx

    • server.pfx

  6. 重启 Qlik DataTransfer 服务。

Qlik DataTransfer 转到白色屏幕并且 https://localhost:5505/ 显示错误 err_ssl_version_or_cipher_mismatch

我打开了 Qlik DataTransfer,但是仅显示白色屏幕。在检查 Windows 中的服务时,Qlik DataTransfer 显示为在运行。如果转到浏览器中的 https://localhost:5505/,就会遇到错误 err_ssl_version_or_cipher_mismatch

可能的原因  

Qlik DataTransfer 不支持服务器上的 TLS 密码套件。

建议的操作  

按照以下支持文章中的步骤在服务器组策略中添加 TLS 密码套件:https://support.qlik.com/articles/000038570

Qlik DataTransfer 未运行,日志显示执行 PowerShell 脚本命令时出错

Qlik DataTransfer 未运行。日志显示以下错误信息:

Error while executing powershell script command,Command failed: & "C:\Program
Files\Qlik\DataTransfer\DataUploadService\install-utils\Remove-Certificate.ps1"
& : File C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils\Remove-Certificate.ps1 cannot be loaded
because running scripts is disabled on this system. For more information, see about_Execution_Policies at
https:/go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:3
+ & "C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : SecurityError: (:) [], PSSecurityException
+ FullyQualifiedErrorId : UnauthorizedAccess"

可能的原因  

已为该用户禁用或限制 ExecutionPolicy。

建议的操作  

通过向用户提供 RemoteSigned 执行策略,启用或授予执行 PowerShell 脚本的权限。您可以在管理员模式下从 PowerShell 执行此操作,方法是在 PowerShell 中运行 PS C:\> Set-ExecutionPolicy RemoteSigned 并选择 Y。您可以与系统管理员联系以执行相同的操作。

我遇到 Qlik DataTransfer 的 CPU 占用率过高的情况

Qlik DataTransfer 大量占用 CPU。

可能的原因  

可能有一个共享文件夹被配置为数据文件夹,Qlik DataTransfer 可能正在对该文件夹进行轮询,从而占用更多 CPU。

建议的操作  

执行以下操作之一:

  • 要停止轮询,可导航至 services.conf 文件,该文件位于 %Program Files%\Qlik\DataTransfer。打开文件并删除 --usePolling。由此将在服务重新启动后停止监视共享文件夹。

  • 要以更大的间隔轮询,可以将默认轮询间隔从 100 毫秒更改为更大的值,例如 3000 毫秒。导航至 services.conf 文件,该文件位于 %Program Files%\Qlik\DataTransfer。打开文件并将 --pollingInterval 添加在 --usePolling 之后。以毫秒为单位设置轮询间隔,例如 --pollingInterval 3000