ツールとユーティリティ
セッションデータクエリユーティリティ
-
各Linux VDAでセッションデータを照会するために使用できるユーティリティ（ctxsdcutil）を提供しています。VDAでホストされているすべてのセッションまたは特定のセッションの以下のデータを照会するには、
/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]コマンドを実行します。[-c]引数は、毎秒データを照会することを意味します。 -
入力セッション帯域幅
-
出力セッション帯域幅
-
出力セッション回線速度
-
遅延 - 最終記録
-
ラウンドトリップタイム
-
出力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内のログファイルにアクセスできます。
XDPing
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 N/A -
テストスイート全体を実行する sudo /opt/Citrix/VDA/bin/xdping（コマンドラインオプションなしでXDPingを実行） Linux XDPingツールは、システム上で150を超える個別のテストを実行します。詳細については、この記事の後半にある個別のテストを参照してください。 -
VDA登録ステータスチェックを実行する sudo /opt/Citrix/VDA/bin/xdping -a 詳細については、この記事の後半にあるVDA登録ステータスチェックの範囲を参照してください。
-
-
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 N/A -
特定のテストカテゴリのみを実行する（例：時間、Kerberos、データベーステスト） sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos,database N/A -
特定のDelivery Controllerをプローブする **sudo /opt/Citrix/VDA/bin/xdping -d ** N/A
-
個別のテスト
- Linux XDPingツールは、システム上で150を超える個別のテストを実行します。これらは大まかに次のように分類されます。
- Linux VDAのシステム要件が満たされているかを確認します。
- Linuxディストリビューションを含むマシン情報を識別して表示します。
- Linuxカーネルの互換性を確認します。
- Linux VDAの動作に影響を与える可能性のある既知のLinuxディストリビューションの問題を確認します。
- Security-Enhanced Linux (SELinux)モードと互換性を確認します。
- ネットワークインターフェイスを識別し、ネットワーク設定を確認します。
- ストレージパーティションと利用可能なディスク容量を確認します。
- マシンホストとドメイン名の構成を確認します。
- DNS構成を確認し、ルックアップテストを実行します。
- 基盤となるハイパーバイザーを識別し、仮想マシン構成を確認します。サポート対象：
- Citrix Hypervisor™
- Microsoft HyperV
- VMware vSphere
- 時間設定を確認し、ネットワーク時刻同期が動作しているかを確認します。
- PostgreSQLサービスが適切に構成され、動作しているかを確認します。
- SQLiteが適切に構成され、動作しているかを確認します。
- ファイアウォールが有効になっており、必要なポートが開いているかを確認します。
- Kerberos構成を確認し、認証テストを実行します。
- グループポリシーサービスエンジンのLDAP検索環境を確認します。
- Active Directory統合が適切に設定されており、現在のマシンがドメインに参加しているかを確認します。サポート対象：
- Samba Winbind
- Dell Quest Authentication Services
- Centrify DirectControl
- 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テストを実行したときの出力例です。
VDA登録ステータスチェックの範囲
Linux XDPingツールは、VDA登録ステータスを確認および分析するのに役立つ分析モジュールも提供します。登録ステータスチェックの範囲については、次のスクリーンショットを参照してください。
VDAデータのバックアップと比較
Linux VDA 2305 以降、XDPing ツールに VDA バックアップモジュールが導入されました。このモジュールを使用すると、構成、データベース、バイナリ権限データなど、VDA の主要データをいつでもバックアップできます。VDA が正常に動作しているときに、VDA の主要データをバックアップできます。後で VDA に障害が発生した場合に備えて、データの別のコピーをバックアップし、2 つのデータコピーを比較してトラブルシューティングを容易にすることができます。次の表に、VDA データバックアップと、対応する XDPing コマンドを使用した比較について説明します。
| タスク | 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= |
該当なし |