ツールとユーティリティ

最終公開日 : Nov 13, 2026
Related information
管理

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

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

The 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 ツールをインストールする

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=<あるバックアップデータディレクトリ>:<もう一方のバックアップデータディレクトリ> 詳細については、この記事の後半にある「VDAデータのバックアップと比較」を参照してください。
Linux VDAパッケージをインストールする前に環境を確認するには sudo /opt/Citrix/VDA/bin/xdping --preflight 該当なし
特定のテストカテゴリのみを実行する場合、たとえば、時間テストとKerberosテスト sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos 該当なし
特定のDelivery Controllerをプローブする場合 sudo /opt/Citrix/VDA/bin/xdping -d <FQDN of the Delivery Controller> 該当なし

個別テスト

Linux XDPing ツールは、システム上で150を超える個別テストを実行します。これらは大まかに次のように分類されます。
注:
Linux XDPing ツールはSQLiteテストを実行しません。
  • Linux VDAのシステム要件が満たされているかを確認する
  • Linuxディストリビューションを含むマシン情報を特定して表示する
  • Linuxカーネルの互換性を確認する
  • Linux VDAの動作に影響を与える可能性のある既知のLinuxディストリビューションの問題を確認する
  • Security-Enhanced Linux (SELinux) のモードと互換性を確認する
  • ネットワークインターフェイスを特定し、ネットワーク設定を確認する
  • ストレージのパーティション分割と利用可能なディスク容量を確認する
  • マシンのホスト名とドメイン名の構成を確認する
  • DNS構成を確認し、ルックアップテストを実行します。
  • 基盤となるハイパーバイザーを特定し、仮想マシンの構成を確認します。サポート対象:
    • シトリックス ハイパーバイザー™
    • マイクロソフト Hyper-V
    • ヴイエムウェア ブイスフィア
  • 時刻設定を確認し、ネットワーク時刻同期が動作しているかを確認します。
  • PostgreSQLサービスが適切に構成され、動作しているかを確認します。
  • ファイアウォールが有効になっており、必要なポートが開いているかを確認します。
  • Kerberos構成を確認し、認証テストを実行します。
  • グループポリシーサービスエンジンのLDAP検索環境を確認します。
  • Active Directory統合が適切に設定され、現在のマシンがドメインに参加しているかを確認します。サポート対象:
    • サンバ Winbind
    • デル クエスト 認証サービス
    • セントリファイ ダイレクトコントロール
    • 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/2305/media/kerberos-test-sample-output-1.png)
Kerberos テストのサンプル出力の 2 番目の部分Kerberos テストのサンプル出力の 3 番目の部分

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

Linux XDPingツールは、VDA登録ステータスを確認および分析するのに役立つ分析モジュールも提供します。登録ステータスチェックの範囲については、次のスクリーンショットを参照してください。
登録ステータスチェック

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=<あるバックアップデータディレクトリ>:<もう一方のバックアップデータディレクトリ> 該当なし