# 疑難排解 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 DataTransfer 和 Qlik Sense Enterprise on Windows 安裝在機器上，請進行下列事項：

1. 在 Windows 服務中，停止 Qlik DataTransfer 服務。

2. 前往 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 並刪除資料夾中的憑證。

3. 在 Windows 憑證商店，刪除下列憑證：

   * 本機電腦 > 個人 > 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 密碼套件：[在 Qlik Sense 應用程式中停用 TLS 1.2 的弱密碼套件](https://community.qlik.com/t5/Knowledge/Disabling-Weak-Cipher-suites-for-TLS-1-2-in-QlikSense/ta-p/1716891)。

## 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 loadedbecause 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 中執行 `PS C:\> Set-ExecutionPolicy RemoteSigned` 並選取 `Y`，以在管理員模式下從 PowerShell 這麼做。您可以聯絡系統管理員以進行相同事項。

## 我從 Qlik DataTransfer 遇到了很高的 CPU 使用量

Qlik DataTransfer 正在使用大量的 CPU。

可能的原因

可能有共用資料夾設定為資料資料夾，Qlik DataTransfer 可能在輪詢資料夾，這會使用較多 CPU。

建議的行動

執行下列其中一個動作：

* 若要停止輪詢，前往 services.conf 檔案，這位於 %Program Files%\Qlik\DataTransfer。開啟檔案並移除 `--usePolling`。這將會在重新啟動服務後，中斷監視共用資料夾。

* 若要以較大的間隔時間輪詢，您可以將預設輪詢間隔從 100 毫秒變更為較大的值，例如 3000 毫秒。前往 services.conf 檔案，這位於 %Program Files%\Qlik\DataTransfer。開啟檔案並在 `--usePolling` 之後新增 -`-pollingInterval`。以毫秒設定輪詢間隔，例如 `--pollingInterval 3000`。

## Qlik DataTransfer 於安裝在 Qlik Sense Enterprise on Windows 叢集的次要節點時顯示空白頁面。

Qlik DataTransfer 有空白頁面。Qlik Sense 憑證在開發人員節點中不可匯出。

可能的原因

Qlik DataTransfer 未安裝在中央節點。

建議的行動

按照這些步驟：

1. 執行一般[安裝](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/QlikDataTransfer/install-Qlik-DataTransfer.htm)步驟。

2. 在 Windows 服務中，停止 Qlik DataTransfer 服務。

3. 前往 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 並刪除資料夾中的憑證。

4. 在 Windows 憑證商店，刪除下列憑證 (如可用)：

   * 本機電腦 > 個人 > QdtClient

   * 本機電腦 &gt; 受信任的根憑證授權 &gt; `<hostname.domain>` 或 `<hostname>`

   * 目前使用者 &gt; 個人 &gt; QdtClient

   或者，您能以管理員身分在 PowerShell 中執行 Remove-Certificate.ps1 (C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils)。

5. 前往 C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils。

6. 複製 Configure-Service.ps1。

7. 使用 Qlik Sense Enterprise on Windows 服務使用者帳戶登入中央節點。

8. 在中央節點的任何位置貼上此檔案。

9. 以 Qlik Sense 服務使用者的身分在 PowerShell 中執行 Configure-Service.ps1。

   1. 對於第一項輸入 dataTransferCertificatePath，輸入機器的任何資料夾位置。這會將憑證匯出至此位置。

   2. 對於第二個輸入項目 qsefwPresent，輸入 Yes。

10. 前往憑證匯出位置並確認存在下列檔案：

    1. root.pfx

    2. client.pfx

    3. server.pfx

11. 複製全部三個憑證。

12. 前往 Qlik DataTransfer 安裝的機器。

13. 前往 C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate 並貼上所有憑證。

14. 重新啟動 Qlik DataTransfer 服務。