Citrix Virtual Apps and Desktops

トラブルシューティング

HDX Direct が直接接続を正常に確立したことを確認するには、VDA マシンで CtxSession.exe ユーティリティを使用します。

CtxSession.exe ユーティリティを使用するには、セッション内でコマンドプロンプトまたは PowerShell を起動し、ctxsession.exe -v を実行します。HDX Direct 接続が正常に確立されると、HDX Direct StatusConnected と表示されます。

HDX Direct のトラブルシューティング

セッションホストのイベントログで、HDX™ Direct 接続が正常に確立されたか、または失敗したかに関する情報を確認することもできます。詳細については、「イベントログ」セクションを参照してください。

注:

環境およびセッションホストで利用可能な IP アドレスの数によっては、HDX Direct 接続が確立されるまでに最大 5 分かかる場合があります。

HDX Direct が直接接続の確立に失敗した場合

HDX Direct が直接接続の確立に失敗する場合は、次の手順を確認してください。

  1. 使用している VDA バージョンと Workspace アプリバージョンが、システム要件に従ってこの機能をサポートしていることを確認します。
  2. HDX Direct を有効にするポリシーが VDA に適用されており、この機能を無効にする優先度の高い他のポリシーがないことを確認します。
  3. 目的の HDX Direct モードを設定するポリシーが VDA に適用されており、この構成を上書きする優先度の高い他のポリシーがないことを確認します。
  4. Citrix ClxMtp Service がセッションホストで実行されていることを確認します。
  5. Citrix Certificate Manager Service がセッションホストで実行されていることを確認します。実行されていない場合は、手動で起動してみてください。HDX Direct が無効になっている場合、このサービスは自動的に停止します。
  6. セッションホストに自己署名ルート CA 証明書があるかどうかを確認します。
    1. 発行先: CA-Citrix-Certificate-Manager
    2. 発行元: CA-Citrix-Certificate-Manager
    3. 発行者の詳細: 組織は Citrix Systems, Inc.
  7. セッションホストに自己署名サーバー証明書があるかどうかを確認します。
    1. 発行先: <ホストの FQDN> (例: FTLW11-001.ctxlab.net)
    2. 発行元: CA-Citrix-Certificate-Manager
    3. 発行者の詳細: 組織は Citrix Systems, Inc.
  8. 証明書が見つからない場合は、Citrix テクニカルサポートにお問い合わせください。
  9. 証明書が存在する場合:
    1. セッションホストで Citrix Certificate Manager Service を停止します。
    2. 自己署名ルート CA 証明書と自己署名サーバー証明書の両方を削除します。
    3. セッションホストで Citrix Certificate Manager Service を起動します。サービスは起動すると新しい証明書を作成します。
  10. 内部ユーザーの場合:
    1. セッションホストのファイアウォールが、HDX over EDT および HDX over TCP のそれぞれについて、UDP 443 または TCP 443 の受信トラフィックをブロックしていないことを確認します。
    2. ネットワークファイアウォールが、クライアントネットワークとセッションホストネットワーク間の UDP 443 および TCP 443 のトラフィックをブロックしていないことを確認します。
  11. 外部ユーザーの場合:
    1. セッションホストに STUN サーバーのリストが含まれていることを確認します。
      • キー: HKLM\SOFTWARE\Citrix\HDX-Direct
      • 値の型: REG_MULTI_SZ
      • 値の名前: STUNServers
      • データ: stun.cloud.com:3478 stun.cloudflare.com:3478 stun.l.google.com:19302
    2. クライアントとセッションホストの NAT タイプを確認し、その組み合わせが機能すると予想されることを確認します。詳細については、「NAT 互換性」セクションを参照してください。
    3. クライアントまたはセッションホストのいずれかで NAT テストが失敗した場合:
      1. システムでファイアウォールが実行されている場合は、UDP 3478 の送信トラフィックをブロックしていないことを確認します。
      2. ネットワークファイアウォールが UDP 3478 の送信トラフィックをブロックしていないことを確認します。
      3. ファイアウォールが STUN サーバーからの応答をブロックしていないことを確認します。
    4. ネットワークファイアウォールに、必要なすべてのトラフィックを許可するように適切なルールが構成されていることを確認します。詳細については、「ネットワーク要件」セクションを参照してください。
    5. HDX Direct ポート範囲ポリシー設定を使用してデフォルトのポート範囲を変更する場合は、ファイアウォールルールがカスタムポート範囲に設定されていることを確認します。

イベントログ

VDA マシンのイベントログには、次のイベントが記録されます。

ログ ID ソース レベル 説明
アプリケーションとサービスログ > Citrix-HostCore-HDX Direct/Operational 1 HDX Direct 情報 内部ユーザー <username> の HDX Direct 接続が確立されました。
アプリケーションとサービスログ > Citrix-HostCore-HDX Direct/Operational 2 HDX Direct 情報 外部ユーザー <username> の HDX Direct 接続が確立されました。
アプリケーションとサービスログ > Citrix-HostCore-HDX Direct/Operational 3 HDX Direct 情報 ユーザー <username> の HDX Direct 接続に失敗しました。
アプリケーションとサービスログ > Citrix-HostCore-HDX Direct/Operational 4 HDX Direct 情報 STUN サーバー <URL:PORT> は、ユーザー <username> のセッションホスト IP およびポートマッピングとして <IP>:<PORT> を提供しました。
アプリケーションとサービスログ > Citrix-HostCore-HDX Direct/Operational 5 HDX Direct 情報 ユーザー <username> の構成済み STUN サーバーのいずれからも、セッションホストによって応答が受信されませんでした。
アプリケーションとサービスログ > Citrix-HostCore-HDX Direct/Operational 6 HDX Direct 情報 クライアントは、ユーザー <username> の外部マッピングとして <IP>:<PORT> を提供しました。
アプリケーションとサービスログ > Citrix-HostCore-HDX Direct/Operational 7 HDX Direct 情報 クライアントによってユーザー <username> の外部マッピングが提供されませんでした。

既知の問題

  • Rendezvous が無効になっている場合、Gateway Service を使用する Workspace 環境では、外部ユーザー向けの HDX Direct が失敗することがあります。この問題を解決するには、Rendezvous が有効になっていることを確認してください。
  • HDX Direct がすでに有効になっているマシンで VDA のインプレースアップグレードを実行すると、HDX Direct が動作しなくなることがあります。この問題を解決するには、次の手順を実行します。

    1. セッションホストで Citrix Certificate Manager Service を停止します。
    2. 自己署名ルート CA 証明書と自己署名サーバー証明書を削除します。
    3. レジストリを開きます。
    4. HKLM\Software\Citrix\HDX-Direct キーを削除します。
    5. HKLM\SYSTEM\CurrentControlSet\Control\TerminalServer\Wds\icawd に移動します。
    6. SSLEnabled の値を 0 に設定します。
    7. SSLThumbprint の内容を削除します。
    8. Citrix Certificate Manager Service を起動します。
トラブルシューティング