ツールとユーティリティ

最終公開日 : 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統合が適切に設定され、現在のマシンがドメインに参加しているかを確認する。サポート対象:
    • サンバ Winbind
    • Dell Quest 認証サービス
    • セントリファイ ダイレクトコントロール
    • 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/2207/media/kerberos-test-sample-output-1.png)
Kerberosテストのサンプル出力の2番目の部分(/en-us/linux-virtual-delivery-agent/2207/media/kerberos-test-sample-output-2.png)
Kerberosテストのサンプル出力の3番目の部分(/en-us/linux-virtual-delivery-agent/2207/media/kerberos-test-sample-output-3.png)