トラブルシューティング

最終公開日 : Nov 13, 2026
この記事では、XDPing を使用したトラブルシューティングと、ctxsdcutil ユーティリティを使用したセッションデータのクエリ方法について説明します。
Related information
管理

エックスディーピング

Linux XDPing ツールはコマンドラインアプリケーションです。これは、Linux VDA 環境における一般的な構成の問題を自動的にチェックします。
Linux XDPing ツールは、システム上で150を超える個別のテストを実行し、それらは大まかに次のように分類されます。
  • Linux VDA のシステム要件が満たされているかを確認します。
  • Linux ディストリビューションを含むマシン情報を特定して表示します。
  • Linux カーネルの互換性を確認します。
  • Linux VDA の動作に影響を与える可能性のある既知の Linux ディストリビューションの問題がないか確認します。
  • Security-Enhanced Linux (SELinux) のモードと互換性を確認します。
  • ネットワークインターフェイスを特定し、ネットワーク設定を確認します。
  • ストレージのパーティション分割と利用可能なディスク容量を確認します。
  • マシンのホスト名とドメイン名の構成を確認します。
  • DNS 構成を確認し、ルックアップテストを実行します。
  • 基盤となるハイパーバイザーを特定し、仮想マシンの構成を確認します。サポート対象:
    • シトリックス ハイパーバイザー™
    • マイクロソフト HyperV
    • ヴイエムウェア ブイスフィア
  • タイム設定を確認し、ネットワーク時刻同期が動作しているか確認します。
  • PostgreSQLサービスが適切に構成され、動作しているか確認します。
  • ファイアウォールが有効になっており、必要なポートが開いているか確認します。
  • Kerberos構成を確認し、認証テストを実行します。
  • グループポリシーサービスエンジン用のLDAP検索環境を確認します。
  • Active Directory統合が適切に設定され、現在のマシンがドメインに参加しているか確認します。サポート対象:
    • サンバ・ウィンバインド
    • デル・クエスト・オーセンティケーション・サービス
    • セントリファイ・ダイレクトコントロール
    • SSSD
  • Active Directory内のLinuxコンピューターオブジェクトの整合性を確認します。
  • Pluggable Authentication Module (PAM) の構成を確認します。
  • コアダンプパターンを確認します。
  • Linux VDAに必要なパッケージがインストールされているか確認します。
  • Linux VDAパッケージを特定し、インストールの整合性を確認します。
  • PostgreSQLレジストリデータベースの整合性を確認します。
  • Linux VDAサービスが適切に構成され、動作しているかを確認します。
  • VDAおよびHDX™構成の整合性を確認します。
  • 各構成済みDelivery Controller™をプローブして、Broker Serviceが到達可能で、動作しており、応答性があることをテストします。
  • マシンがDelivery Controllerファームに登録されているかを確認します。
  • アクティブまたは切断された各HDXセッションの状態を確認します。
  • Linux VDA関連のエラーと警告についてログファイルをスキャンします。
  • Xorgのバージョンが適切であるかを確認します。

Linux XDPing ツールを使用する

注:
ctxsetup.shを実行してもXDPingはインストールされません。XDPingをインストールするにはsudo /opt/Citrix/VDA/bin/xdpingを実行します。 このコマンドは、XDPingに必要なPython3仮想環境も作成します。このコマンドでPython3仮想環境の作成に失敗した場合は、Python3仮想環境を作成するの手順に従って手動で作成してください。
pipツールを使用する際に発生する可能性のあるSSL接続エラーに対処するには、次の信頼済みホストを/etc/pip.confファイルに追加することを検討してください:
[global] trusted-host =
pypi.org files.pythonhosted.org
XDPingには、コマンドシェルから実行されるxdpingという単一の実行可能ファイルが付属しています。
コマンドラインオプションを表示するには、-hオプションを使用します。
sudo /opt/Citrix/VDA/bin/xdping -h
全てのテストスイートを実行するには、コマンドラインオプションなしでxdpingを実行します。
sudo /opt/Citrix/VDA/bin/xdping
Linux VDAパッケージをインストールする前に環境を確認するには、pre-flightテストを実行します。
sudo /opt/Citrix/VDA/bin/xdping --preflight
特定のテストカテゴリのみを実行するには、たとえば、時間テストとKerberosテストなど、-Tオプションを使用します。
sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos
特定のXenDesktop® Controllerをプローブするには:
sudo /opt/Citrix/VDA/bin/xdping -d myddc.domain.net

出力例

以下は、Kerberosテストを実行したときの出力例です。
Kerberosテストの出力例の最初の部分(/en-us/linux-virtual-delivery-agent/2203-ltsr/media/kerberos-test-sample-output-1.png)
Kerberosテストの出力例の2番目の部分(/en-us/linux-virtual-delivery-agent/2203-ltsr/media/kerberos-test-sample-output-2.png)
Kerberosテストの出力例の3番目の部分(/en-us/linux-virtual-delivery-agent/2203-ltsr/media/kerberos-test-sample-output-3.png)

セッションデータクエリユーティリティ

各Linux VDAでセッションデータをクエリするために使用できるユーティリティ (ctxsdcutil) を提供しています。VDAでホストされているすべてのセッションまたは特定のセッションの次のデータをクエリするには、/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]コマンドを実行します。[-c]引数は、1秒ごとにデータをクエリすることを意味します。
  • 入力セッション帯域幅
  • 出力セッション帯域幅
  • 出力セッション回線速度
  • 待機時間 - 最終記録
  • ラウンドトリップタイム
  • 出力 ThinWire 帯域幅
  • 出力オーディオ帯域幅
  • 出力プリンター帯域幅
  • 入力ドライブ帯域幅
  • 出力ドライブ帯域幅