故障排除 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 安装在计算机上,进行以下操作:
-
在 Windows 服务中,停止 Qlik DataTransfer 服务。
- 导航至 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 并删除其中的证书。
-
导航至 C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils。
-
在 PowerShell 中运行 Remove-Certificate.ps1。
-
启动 Qlik DataTransfer 服务。
-
导航至 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 并确认以下文件存在:
-
client.pfx
-
server.pfx
-
如果仅 Qlik DataTransfer 和 Qlik Sense Enterprise on Windows 安装在计算机上,进行以下操作:
-
在 Windows 服务中,停止 Qlik DataTransfer 服务。
- 导航至 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 并删除文件夹中的证书。
-
在 Windows Certificate Store 中,删除以下证书:
-
本地计算机 > 个人 > QdtClient
-
本地计算机 > 受信任的根证书颁发机构 > <hostname.domain> 或 <hostname>
-
当前用户 > 个人 > QdtClient
也可以在 PowerShell 中作为管理员运行 Remove-Certificate.ps1。
-
-
作为 Qlik Sense 服务用户,在 PowerShell 中运行 Configure-Service.ps1。
-
对于第一个输入 dataTransferCertificatePath,输入 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate。
-
对于第二个输入 qsefwPresent,输入 Yes。
-
-
导航至 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 并确认以下文件存在:
-
root.pfx
-
client.pfx
-
server.pfx
-
-
重启 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 密码套件:在 Qlik Sense 应用程序中禁用 TLS 1.2 的弱密码套件。
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。
Qlik DataTransfer 在 Qlik Sense Enterprise on Windows 群集的次要节点上安装时显示空白页
Qlik DataTransfer 具有空白页。Qlik Sense 证书不能在开发人员节点中导出。
可能的原因
Qlik DataTransfer 未安装在中心节点上。
建议的操作
遵循以下步骤:
-
执行常规安装步骤。
-
在 Windows 服务中,停止 Qlik DataTransfer 服务。
-
导航至 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 并删除文件夹中的证书。
-
在 Windows Certificate Store 中,删除以下证书(如果有):
-
本地计算机 > 个人 > QdtClient
-
本地计算机 > 受信任的根证书颁发机构 > <hostname.domain> 或 <hostname>
-
当前用户 > 个人 > QdtClient
-
-
导航至 C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils。
-
复制 Configure-Service.ps1。
-
使用 Qlik Sense Enterprise on Windows 服务用户帐户登录中心节点。
-
将此文件粘贴到任意位置的中心节点。
-
作为 Qlik Sense 服务用户,在 PowerShell 中运行 Configure-Service.ps1。
-
对于第一个输入 dataTransferCertificatePath,输入计算机上的任何文件夹位置。这将把证书导出到此位置。
-
对于第二个输入 qsefwPresent,输入 Yes。
-
导航到导出证书的位置,并确认存在以下文件:
-
root.pfx
-
client.pfx
-
server.pfx
-
-
复制所有三个证书。
-
转到已安装 Qlik DataTransfer 的机器。
-
导航至 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 并粘贴所有证书。
-
重启 Qlik DataTransfer 服务。
或者,您可以在 PowerShell 中作为管理员运行 Remove-Certificate.ps1 (C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils)。