トラブルシューティング - QMC リソースの管理

このセクションでは、QMC リソースを管理するときに発生する可能性のある問題について説明しています。

エラー メッセージ: [400 不正な要求]

エラー メッセージ [400 不正な要求] が表示される場合、原因の可能性は複数あります。

QMC へのアプリのインポートに失敗

ログには、次のエラー メッセージが表示されます: Server:ImportApp_impl caught extended exception 400: Bad Request

考えられる原因  

アプリに、URL が 1024 文字を超えるウェブ接続が含まれています。

提案されたアクション  

1. Qlik Sense Desktop でアプリを開き、アプリに URL が 1024 文字を超えるウェブ接続が含まれているかどうか確認します。
2. bit.ly などのサービスを使用し、URL を短くします。

REST HTTP 要求が正しくありません

考えられる原因  

プロキシまたはリポジトリへの REST HTTP 要求が不正に書式設定されています。

提案されたアクション  

REST HTTP 要求の書式設定を修正してください。

エラー メッセージ: [401 Unauthorized] (401 権限がありません)

パスワードに特殊文字が含まれている場合、REST コネクターの認証は失敗します。

考えられる原因  

QMC で、REST コネクタのパスワードを編集して特殊文字「%」および/または「=」および/または「;」を追加しています。

提案されたアクション  

データ ロード エディターを使用してパスワードを編集します。

エラーメッセージ: [403 Forbidden]

考えられる原因  

• コンピュータのルート 証明書が多すぎる (300 以上) ため、Qlik Sense サービスの通信は認められません。
• リポジトリのルール エンジンによって、アクセスが許可されていないリソースにアクセスしようとしています。

提案されたアクション  

使用されていないルート証明書を削除してください。以下の Microsoft ヘルプ ドキュメントも参照してください。

KB 931125 をインストール後の SSL/TLS 通信の問題

エラーメッセージ: [405 Method not allowed]

考えられる原因  

URL は存在しない REST 機能を指しています。

提案されたアクション  

URL を修正してください。

エラー メッセージ: [Internal server error 500]

エラー 500 が発生する場合、複数の原因が考えられます。

アプリのインポートに失敗しました

考えられる原因  

2,500 文字を超える名前のアプリをインポートしようとしました。

提案されたアクション  

アプリの名前を最大値の 2,500 文字以下にしてください。

不明なエラー

考えられる原因  

不明のエラーが発生しました。

提案されたアクション  

次の場所にあるシステム ログ ファイルをチェックします。

• %ProgramData%\Qlik\Sense\Log\Proxy
• %ProgramData%\Qlik\Sense\Log\Repository

エラー メッセージ:Qlik Sense ハブに接続しようとすると [Connection lost (接続が切断されました)] と表示される 

考えられる原因  

Qlik Senseハブへのアクセス時に使用されるアドレスは、Qlik Sense Proxy Serviceのホスト許可リストに表示されません。

[Connection lost (接続が切断されました)] というエラー メッセージは一般的に次のようなケースで表示されます。

• Qlik Senseハブへのアクセスはホスト名「https://myhost/hub」やfully qualified name (FQN)「https://myhost.company.com/hub」ではなく「https://192.168.0.25/hub」などのIPアドレスを使って行われます。
• Qlik Senseハブへのアクセスはコンピュータの既定のDomain Name System (DNS) 名やFQNとして登録されているものとは違うアドレスを使って行われます。例えば、Amazon Web Service や類似の環境を使っている場合、内部に登録されている DNS 名は外部向けのアドレスと同一ではありません。

提案されたアクション  

次の手順を実行します。

1. QMCから、[ 仮想プロキシ] を開きます。

2. 仮想プロキシを選択して、[Edit (編集)] をクリックします。

3. [Properties (プロパティ)] リストで、[Advanced (詳細設定)] をクリックします。

4. [ホスト許可リスト] を見付けます。

5. [Add new value (新しい値の追加)] をクリックして、クライアントからQlik Senseハブに接続するために使用されるアドレスを追加します。

   IPアドレス: 192.168.0.10、FQN: myqlikserver.company.com。

6. [適用] をクリックします。

   プロキシ再起動メッセージが表示されます。

7. [OK] をクリックします。

エラー メッセージ: [ODBC connection failed (ODBC 接続に失敗しました)]

予定されたリロードが失敗して、エラー メッセージ [ODBC connection failed (ODBC 接続に失敗しました)] が表示されました。

考えられる原因  

データ接続にはシングル サインオン (SSO) が採用されているため、接続が実際のユーザーによって使用されることやアプリが「SQL SELECT…」を使ってデータをロードすることが必要です。

この問題に対して考えられるソリューションは複数あります。

提案されたアクション (データ接続を変更して SSO を使わないようにする)

使用される必要のあるユーザー名とパスワードを指定してください。

提案されたアクション (手動でリロードを実行する)

データ接続への変更を行わないようにする場合、タスクを使うのではなく手動でもリロードを実行できます。

提案されたアクション (SQL からDirect Discoveryテーブルに変更する)

SSO と併用でDirect Discoveryテーブルを使用する場合、タスクを使ってアプリをリロードできます。

ユーザー アカウントで REST データ接続を使用するとユーザーがロックアウトされる

考えられる原因  

REST データ接続を、AD/LDAP/ユーザー ディレクトリで利用可能なサービス アカウントではなく通常のアカウントで設定した場合、単一ユーザー アカウントの並列接続セッションの最大数 (5) が使用され、このユーザーは一時的にロック アウトされます。

提案されたアクション  

ユーザー アカウントの代わりにサービス アカウントを使用し、ユーザー/プロフェッショナル/アナライザー アクセスはそのユーザー アカウントに一切割り当てないようにしてください。

タスクが実行されない

考えられる原因  

タスクの状態は [Success (成功)] ではありません。

提案されたアクション  

QMC のタスク概要ページで、状態列の をクリックして実行ステップの概要を表示します。

%ProgramData%\Qlik\Sense\Log\Scheduler の下にあるログ ファイルを確認します。

リロードが機能しない

リロードが機能しない場合に考えられる原因は複数あります。

リロードに失敗した

アプリで [Reload now (すぐにリロード)] をクリックしましたが、リロードが起動しません。

考えられる原因  

タスクの状態は [Success (成功)] ではありません。

提案されたアクション  

次の場所でログ ファイルを確認してください: %ProgramData%\Qlik\Sense\Log\Script。

マルチノード環境でリロードに失敗した

マルチノードの環境でアプリを選択して [More actions (その他のアクション)] > [Reload now (今すぐリロード)] をクリックしましたが、リロードは失敗し、次のメッセージが表示されました。[タスクを実行するワーカー ノードが見つかりませんでした]

考えられる原因  

セントラル スケジューラーが [Manager only (マネージャーのみ)] に設定されています。

提案されたアクション  

タスク実行を再トリガーします。

[Edit scheduler (スケジューラーの編集)] ページの [詳細] で、[Type (タイプ)] を [マネージャーおよびワーカー] に変更します。

スタート ページで、エンジン、リポジトリ、プロキシ、スケジューラの横に数字が表示される

考えられる原因  

サービスが停止しています。

提案されたアクション  

次の場所にあるログ ファイルを確認します: %ProgramData%\Qlik\Sense\Log\<サービス>

必須の SAML 属性名が分からない

考えられる原因  

必須の属性名 (userID, userDirectory、または追加された必須の属性名) は利用できません。

提案されたアクション  

次の手順を実行します。

1. 属性名として任意の名前を入力します。

2. 認証を試行します。

   属性名が間違っているため、試行は失敗します。

3. Proxy Audit ログで、「Existing SAML attributes:」を含む行を探します。

   利用できるすべての属性の name か friendlyName と Value を見つけます。

4. 使用する属性名を探し、最初に入力した任意の名前の代わりにその属性名を使用します。

次はログで検索できる例です。

既存の SAML 属性: [Name='uid', Value='jod'] [Name='givenName', Value='John'] [Name='sn', Value='Davidson'] [Name='cn', Value='John Davidson'] [Name='mail', Value='john.davidson@domain.com']

ユーザーのプロパティを変更できない

考えられる原因  

アクティブ ディレクトリ (AD) からインポートされたユーザー プロパティは、QMC では変更できません。

提案されたアクション  

AD でプロパティを変更してから再び同期します。

ユーザー ディレクトリの同期

ユーザー同期が動作しない

• [ユーザー ディレクトリ コネクタ] の概要で [Sync all selected user directories (選択したユーザー ディレクトリをすべて同期)] をクリックしても、ユーザーを同期できません。
• 予定したユーザー同期のタスクが成功しません。

UDC が設定されない

考えられる原因  

ユーザー ディレクトリ コネクタが [設定] されていません。

提案されたアクション  

[User directory (ユーザー ディレクトリ)] の名前が一意のもので、空白になっていないことを確認します。

UDC が機能しない

考えられる原因  

ユーザー ディレクトリ コネクタが [機能] していません。

提案されたアクション  

この場所で UserManagement_Repository ログを確認します: %ProgramData%\Qlik\Sense\Log\Repository\Trace ユーザー ディレクトリ コネクタの基になっているソース ファイルを削除すると、機能しません。

UDC のプロパティ [Page size of search (検索のページ サイズ)] が正しくない

考えられる原因  

ユーザー ディレクトリ コネクタのプロパティ [Page size of search (検索のページ サイズ)] が正しくありません。

提案されたアクション  

ユーザー ディレクトリ コネクターのプロパティ [Page size of search (検索のページ サイズ)] を「0」(ゼロ) に設定します。

PostgreSQL データベースでテーブル名の大文字が認識されない

考えられる原因  

PostgreSQL データベースにおいて大文字または特殊文字 ("." など) を含むテーブル名は、検証時にエラーとなります。

提案されたアクション  

大文字または特殊文字を含むテーブル名には引用符を使用してください。

 

"table.Name", public."Table" (または "Table"), testschema."Table"

拡張機能をインポートできない

考えられる原因  

• 拡張機能が圧縮されていません。
• 圧縮ファイルの形式が間違っています。
• zip ファイルに無効なファイルが含まれています。
• 拡張機能のパスワードが正しくありません。
• 拡張機能が既存の拡張機能と重複しています。

提案されたアクション  

• 拡張ファイルが正しく圧縮されていることを確認してください。圧縮には、zip ファイル以外の他のファイル形式は使用できません。

• zip ファイルに含まれているのが関連の拡張ファイルのみであることを確認してください。

• 警告メモQMCにすでに存在する拡張子をインポートする場合は、プロンプトが表示されたら、[Replace] (置き換え) をクリックして既存のファイルを新しいファイルに置き換えるか、 [] をクリックしてキャンセルします。
  拡張機能名

.lock ファイルを削除したらアプリを開けなくなった

考えられる原因  

...\Sense\Apps フォルダーの各アプリには .lock ファイルが付属しており、このファイルが削除されると、アプリを開くことができなくなります。

提案されたアクション  

Qlik Sense Repository Service を再起動します。新しい .lock ファイルがアプリに生成されます。

マルチノード環境のノードがオンラインにならない

QMC でノードを再作成しましたが (作成、削除して、もう一度作成)、ノードがオンラインになりません。 ログには次の警告メッセージが記録されています。「ノードは無効です (最も考えられる原因はクラスタからの登録解除になります)。スタートアップを中止します...」が表示されています。

考えられる原因  

削除されたノードを複数ノードの環境で再起動や再利用することはできません。

提案されたアクション  

次の手順を実行します。

1. QMC でノードを削除してください。

2. ノードからソフトウェアをアンインストールします。

   Qlik Sense のアンインストール

3. ノードでソフトウェアを再インストールします。

4. QMC でノードを再び作成します。

マルチノード サイト: ドメイン外にあるリム ノードとの通信が不可

考えられる原因  

通常、Qlik Senseのマルチノード サイトにあるノードはすべて、同じ Windows のドメイン内にあります。リム ノードの 1 つがドメイン外にあり、ホスト名検索で DNS を利用できない場合、各ノードの Windows ホスト ファイルが更新されていない限り、ドメイン内のノードはドメイン外のノードと通信できません。

提案されたアクション  

次の手順を実行します。

• ドメイン内にあるすべてのノード: ドメイン外のリム ノードを特定するための情報を用いて、Windows ホスト ファイル (通常は C:\Windows\System32\drivers\etc\hosts) を更新します。

例: <ドメイン外にあるリム ノードの IP アドレス> <リム ノードのホスト名>

• ドメイン外にあるリム ノード:
  • ドメイン内のすべてのノードを特定するための情報を用いて、Windowsホスト ファイルを更新します。

   

  <ドメイン内にあるノード 1 の IP アドレス> <完全な記述によるノード 1 のドメイン名>

  <ドメイン内にあるノード 2 の IP アドレス> <完全な記述によるノード 2 のドメイン名>

  • リム ノード自体のホスト名に関する情報を用いて、Windowsホスト ファイルを更新し、リム ノードにあるQlik Senseサービス間の通信を可能にします。

  例: <ドメイン外にあるリム ノードの IP アドレス> <リム ノードのホスト名>