トラブルシューティング Qlik DataTransfer
このセクションでは、Qlik DataTransfer の使用時に発生する可能性のある問題について説明します。
Qlik DataTransfer を開くと画面が白くなる
Qlik DataTransfer を開くと、白い画面しか表示されません。Windows でサービスを確認すると、Qlik DataTransfer は実行中と表示されます。
考えられる原因
以下の問題が 1 つ以上発生している可能性があります。
-
クライアント証明書を 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 証明書ストアで以下の証明書を削除します。
-
[ローカル コンピューター] > [個人用] > [QdtClient]
-
[ローカル コンピューター] > [信頼されたルート証明機関] > <hostname.domain> または <hostname>
-
[現在のユーザー] > [個人用] > [QdtClient]
または、PowerShell で管理者として Remove-Certificate.ps1 を実行することもできます。
-
-
PowerShell で Qlik Sense サービスユーザーとして Configure-Service.ps1 を実行します。
-
最初の入力の dataTransferCertificatePath で、C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate と入力します。
-
2 つ目の入力の 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 で、PS C:\> Set-ExecutionPolicy RemoteSigned をPowerShell で実行して、Y を選択します。システム管理者に連絡して同じことを行うことができます。
Qlik DataTransfer からの CPU 使用率が高い
Qlik DataTransfer が大量のCPUを使用しています。
考えられる原因
データフォルダとして設定された共有フォルダがあり、Qlik DataTransfer がそのフォルダをポーリングしている可能性があります。これにより、より多くのCPUが使用されます。
提案されたアクション
以下のいずれかを行います。
-
ポーリングを停止するには、 %Program Files%\Qlik\DataTransfer にある services.conf ファイルへ移動します。ファイルを開き、--usePolling を削除します。これにより、サービスの再起動後に共有フォルダの監視が停止されます。
-
ポーリングの間隔を長くするために、デフォルトのポーリング間隔を 100 ミリ秒から 3000 ミリ秒などの大きい値に変更します。%Program Files%\Qlik\DataTransfer にある services.conf ファイルへ移動します。ファイルを開き、--usePolling の後に --pollingInterval を追加します。ポーリング間隔をミリ秒単位で設定します (例: --pollingInterval 3000) 。
Qlik Sense Enterprise on Windows クラスターのセカンダリ ノードにインストールすると、Qlik DataTransfer が空白のページを表示します
Qlik DataTransfer には空白のページがあります。Qlik Sense 証明書は、開発者ノードではエクスポートできません。
考えられる原因
セントラル ノードに Qlik DataTransfer がインストールされていません。
提案されたアクション
次の手順に従ってください。
-
通常のインストール手順を実行します。
-
Windows サービスで、Qlik DataTransfer サービスを停止します。
-
C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate へ移動し、フォルダ内の証明書を削除します。
-
Windows 証明書ストアで、次の証明書がある場合は削除します。
-
[ローカル コンピューター] > [個人用] > [QdtClient]
-
[ローカル コンピューター] > [信頼されたルート証明機関] > <hostname.domain> または <hostname>
-
[現在のユーザー] > [個人用] > [QdtClient]
-
-
C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils へ移動します。
-
Configure-Service.ps1 をコピーします。
-
Qlik Sense Enterprise on Windows サービス ユーザー アカウントを使用して、セントラル ノードにログインします。
-
このファイルをセントラル ノードの任意の場所に貼り付けます。
-
PowerShell で Qlik Sense サービス ユーザーとして Configure-Service.ps1 を実行します。
-
最初の入力の dataTransferCertificatePath において、マシン上の任意のフォルダーの場所を入力します。そうすることで、その場所に証明書がエクスポートされます。
-
2 つ目の入力の qsefwPresent において、Yes と入力します。
-
証明書をエクスポートした場所に移動し、次のファイルがあることを確認します。
-
root.pfx
-
client.pfx
-
server.pfx
-
-
3 つのすべての証明書をコピーします。
-
Qlik DataTransfer がインストールされたマシンに移動します。
-
C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate に移動し、すべての証明書を貼り付けます。
-
Qlik DataTransfer サービスを再起動します。
または、PowerShell で管理者として Remove-Certificate.ps1 (C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils) を実行できます。