トラブルシューティング

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

エックスディーピング

Linux XDPing ツールは、コマンドラインアプリケーションです。Linux VDA 環境における一般的な構成の問題を自動的にチェックします。

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 には、コマンドシェルから実行される xdping という単一の実行可能ファイルが付属しています。
次の表は、対応する XDPing コマンドで実行できるさまざまなタスクについて説明しています。
タスク XDPing コマンド 備考
コマンドラインオプションを表示するには sudo /opt/Citrix/VDA/bin/xdping -h 該当なし
テストスイート全体を実行するには sudo /opt/Citrix/VDA/bin/xdping （コマンドラインオプションなしで XDPing を実行） Linux XDPing ツールは、システム上で150を超える個別のテストを実行します。詳細については、この記事の後半にある「個別のテスト」を参照してください。
VDA登録ステータスチェックを実行するには sudo /opt/Citrix/VDA/bin/xdping -a 詳細については、この記事の後半にある「登録ステータスチェックの範囲」を参照してください。
VDAの主要データをバックアップするには sudo /opt/Citrix/VDA/bin/xdping -b 詳細については、この記事の後半にある「VDAデータのバックアップと比較」を参照してください。
VDAバックアップデータの最新の2つのコピーを比較するには sudo /opt/Citrix/VDA/bin/xdping -diff 詳細については、この記事の後半にある「VDAデータのバックアップと比較」を参照してください。
VDAバックアップデータの特定の2つのコピーを比較するには sudo /opt/Citrix/VDA/bin/xdping -diff=<one backup data directory>:<the other backup data directory> 詳細については、この記事の後半にある「VDAデータのバックアップと比較」を参照してください。
Linux VDAパッケージをインストールする前に環境を確認するには sudo /opt/Citrix/VDA/bin/xdping --preflight 該当なし
特定のテストカテゴリのみを実行する場合。例えば、時間、Kerberos、データベースのテスト。 sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos,database 該当なし
特定のDelivery Controllerをプローブする場合 sudo /opt/Citrix/VDA/bin/xdping -d <Delivery Controller の FQDN> 該当なし
VDAにインストールされている依存関係を表示する場合 sudo /opt/Citrix/VDA/bin/xdping --query-pkgs または sudo /opt/Citrix/VDA/bin/xdping -q 該当なし
VDAにインストールされている依存関係を表示し、クエリ結果を特定のパスに保存する場合 sudo /opt/Citrix/VDA/bin/xdping -f <クエリ結果を保存する特定のパス> または sudo /opt/Citrix/VDA/bin/xdping --query-pkgs-to <クエリ結果を保存する特定のパス> 該当なし

個別テスト

Linux XDPing ツールは、システム上で150を超える個別テストを実行し、それらは大まかに次のように分類されます。
  • Linux VDAのシステム要件が満たされているかを確認します。
  • Linuxディストリビューションを含むマシン情報を識別して表示します。
  • Linuxカーネルの互換性を確認します。
  • Linux VDAの動作に影響を与える可能性のある既知のLinuxディストリビューションの問題がないか確認します。
  • Security-Enhanced Linux (SELinux) のモードと互換性を確認します。
  • ネットワークインターフェイスを特定し、ネットワーク設定を確認します。
  • ストレージのパーティション分割と利用可能なディスク領域を確認します。
  • マシンのホストおよびドメイン名の構成を確認します。
  • DNS構成を確認し、ルックアップテストを実行します。
  • 基盤となるハイパーバイザーを特定し、仮想マシンの構成を確認します。サポート対象:
    • ゼノサーバー (旧 シトリックス ハイパーバイザー™)
    • マイクロソフト HyperV
    • ヴイエムウェア ブイスフィア
  • 時刻設定を確認し、ネットワーク時刻同期が動作しているか確認します。
  • PostgreSQLサービスが適切に構成され、動作しているか確認します。
  • SQLiteが適切に構成され、動作しているか確認します。
  • ファイアウォールが有効になっており、必要なポートが開いているか確認します。
  • 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 のバージョンが適切かどうかを確認します。
  • 必要な依存関係がインストールされているかどうかを確認します。

出力例

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

VDA登録ステータスチェックの範囲

Linux の XDPing ツールには、VDA 登録ステータスを確認および分析するのに役立つ分析モジュールも用意されています。登録ステータスチェックの範囲については、次のスクリーンショットを参照してください。
登録ステータスチェック(/en-us/linux-virtual-delivery-agent/2402-ltsr/media/registration-status-checks.png)

VDAデータのバックアップと比較

Linux VDA 2305 以降、XDPing ツールに VDA バックアップモジュールが導入されました。このモジュールを使用すると、構成、データベース、バイナリ権限データなど、VDA の主要データをいつでもバックアップできます。VDA が正常に動作しているときに、VDA の主要データをバックアップできます。後で VDA に障害が発生した場合に備えて、データの別のコピーをバックアップし、2つのデータコピーを比較してトラブルシューティングを容易にすることができます。次の表に、対応する XDPing コマンドを使用した VDA データのバックアップと比較について説明します。
タスク XDPing コマンド 備考
VDA の主要データをバックアップするには sudo /opt/Citrix/VDA/bin/xdping -b バックアップコマンドを実行するたびに、バックアップデータのコピーが生成され、/var/ctxbackup の下のディレクトリに保存されます。バックアップデータディレクトリは、現在の年月日と時刻を yyyy-mm-dd-hh_mm_ss 形式で名付けられます（例: 2023-02-27-16_31_27）。デフォルトでは、バックアップデータディレクトリの最大数は30であり、この数を超えると XDPing ツールは古いバックアップデータディレクトリをローテーションまたは削除します。ディレクトリローテーションの数をカスタマイズするには、次のコマンドを実行します: sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent\Backup" -t "REG_DWORD" -v "MaxDirRotationCount" -d "0x0000005" --force
VDAバックアップデータの最新の2つのコピーを比較するには sudo /opt/Citrix/VDA/bin/xdping -diff 該当なし
VDAバックアップデータの特定の2つのコピーを比較するには sudo /opt/Citrix/VDA/bin/xdping -diff=<あるバックアップデータディレクトリ>:<もう一方のバックアップデータディレクトリ> 該当なし

セッションメトリッククエリユーティリティ

ctxsession

このユーティリティは、Windowsのユーザーエクスペリエンスを提供します。このユーティリティを使用すると、次のスクリーンショットに示すようにセッションメトリックにアクセスできます。
ctxsession を介したセッションメトリックのクエリ

ctxqsession, ctxquser, ctxqfull, ctxquery

これらのユーティリティの使用方法については、ヘルプコマンドを実行してください（例:）。
ユーティリティのヘルプ情報
ユーザーは自分のセッションメトリックのみを照会できます。ルートユーザーと ctxadm グループのユーザーのみが、他のユーザーのセッションメトリックを照会する権限を持っています。

シーティーエックスエスディーシーユーティル

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