トラブルシューティング
この記事では、XDPingを使用してトラブルシューティングを行う方法と、ctxsdcutilユーティリティを使用してセッションメトリックを照会する方法について説明します。
XDPing
Linux XDPingツールはコマンドラインアプリケーションです。Linux VDA環境での一般的な構成の問題をチェックするプロセスを自動化します。
Linux XDPingツールのインストール
ctxsetup.shを実行しても、XDPingはインストールされません。XDPingをインストールするには、sudo /opt/Citrix/VDA/bin/xdpingを実行します。
このコマンドでは、XDPingに必要なPython3仮想環境も作成されます。このコマンドでPython 3仮想環境の作成に失敗した場合は、「Python 3仮想環境の作成」の手順に従って手動で作成してください。
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,database | - |
| 特定のDelivery Controllerをプローブするには | **sudo /opt/Citrix/VDA/bin/xdping -d |
- |
| VDAにインストールされている依存関係を表示するには | sudo /opt/Citrix/VDA/bin/xdping –query-pkgs or 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構成を確認し、参照テストを実行します。
- 基盤となるハイパーバイザーを特定し、仮想マシンの構成を確認します。サポート対象：
- XenServer（旧称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をプローブして、ブローカーサービスが到達可能、操作可能で、応答性があることをテストします。
- マシンが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=<特定のバックアップデータのディレクトリ>:<別のバックアップデータのディレクトリ>\*\*別のバックアップデータのディレクトリ>特定のバックアップデータのディレクトリ>別のバックアップデータのディレクトリ>特定のバックアップデータのディレクトリ> | - |
セッションメトリックのクエリユーティリティ
ctxsession
このユーティリティは、Windowsユーザーエクスペリエンスを提供します。このユーティリティを使用すると、次のスクリーンショットに示すようにセッションメトリックにアクセスできます：
ctxqsession、ctxquser、ctxqfull、ctxquery
これらのユーティリティの使用方法については、helpコマンドを実行してください。例：
ユーザーは自分のセッションメトリックのみを照会できます。他のユーザーのセッションメトリックを照会する権限を持つのは、ルートユーザーおよびctxadmグループのユーザーのみです。
ctxsdcutil
このユーティリティによって、VDAでホストされているすべてのセッションや特定のセッションについて以下のメトリックを照会できます。このためには、/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]コマンドを実行します。[-c]引数は、1秒おきにメトリックを照会することを意味します。
-
セッション入力帯域幅
-
セッション出力帯域幅
-
セッション出力速度
-
遅延 - 最新記録
-
往復時間
-
ThinWire出力帯域幅
-
オーディオ出力帯域幅
-
プリンター出力帯域幅
-
ドライブ入力帯域幅
-
ドライブ出力帯域幅