ツールとユーティリティ

最終公開日 : Nov 13, 2026

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

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

xdlcollect Bashスクリプト

ログの収集に使用される xdlcollect Bashスクリプトは、Linux VDAソフトウェアに統合されており、/opt/Citrix/VDA/bin にあります。Linux VDAをインストールした後、bash /opt/Citrix/VDA/bin/xdlcollect.sh コマンドを実行してログを収集できます。ログ収集が完了すると、スクリプトと同じフォルダーに圧縮ログファイルが生成されます。xdlcollect Bashスクリプトは、圧縮ログファイルをCitrix Insight Services (CIS) にアップロードするかどうかを尋ねることができます。同意すると、アップロード完了後に xdlcollect がupload\_IDを返します。アップロードによって、ローカルマシンから圧縮ログファイルが削除されることはありません。他のユーザーは、upload\_IDを使用してCISのログファイルにアクセスできます。

エックスディーピング

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™構成の整合性を確認します。
  • Probe each configured Delivery Controller™ to test that the Broker Service is reachable, operational, and responsive
  • Check whether the machine is registered with the Delivery Controller farm
  • 各アクティブまたは切断されたHDXセッションの状態を確認します。
  • Linux VDA関連のエラーと警告についてログファイルをスキャンします。
  • Xorgのバージョンが適切であるかを確認します。

Linux XDPingツールを使用する

注:
ctxsetup.shを実行してもXDPingはインストールされません。XDPingをインストールするには、sudo /opt/Citrix/VDA/bin/xdpingを実行します。 このコマンドは、XDPingに必要なPython3仮想環境も作成します。このコマンドがPython3仮想環境の作成に失敗した場合は、「Create a Python3 virtual environment」の手順に従って手動で作成してください。
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/2212/media/kerberos-test-sample-output-1.png)
Kerberosテストのサンプル出力の2番目の部分(/en-us/linux-virtual-delivery-agent/2212/media/kerberos-test-sample-output-2.png)
Kerberosテストのサンプル出力の3番目の部分(/en-us/linux-virtual-delivery-agent/2212/media/kerberos-test-sample-output-3.png)