トラブルシューティング
この記事では、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コマンドで実行できるさまざまなタスクについて説明します：
| Task | XDPing Command | Remarks |
|---|---|---|
| To back up the key data of a VDA | sudo /opt/Citrix/VDA/bin/xdping -b | Each time you run the backup command, a copy of the backup data is generated and saved in a directory under /var/ctxbackup. The backup data directories are named the current date and time in yyyy-mm-dd-hh_mm_ss format, for example, 2023-02-27-16_31_27. By default, the maximum number of backup data directories is 30 and the XDPing tool rotates or deletes old backup data directories when the number is exceeded. To customize the number for directory rotation, run the following command: sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent\Backup" -t "REG_DWORD" -v "MaxDirRotationCount" -d "0x0000005" --force
|
| To compare the latest two copies of VDA backup data | sudo /opt/Citrix/VDA/bin/xdping -diff | N/A |
| To compare two specific copies of VDA backup data | **sudo /opt/Citrix/VDA/bin/xdping -diff= |
N/A |
個別のテスト
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コマンドとの比較について説明します。
| Task | XDPing Command | Remarks |
|---|---|---|
| To back up the key data of a VDA | sudo /opt/Citrix/VDA/bin/xdping -b | Each time you run the backup command, a copy of the backup data is generated and saved in a directory under /var/ctxbackup. The backup data directories are named the current date and time in yyyy-mm-dd-hh_mm_ss format, for example, 2023-02-27-16_31_27. By default, the maximum number of backup data directories is 30 and the XDPing tool rotates or deletes old backup data directories when the number is exceeded. To customize the number for directory rotation, run the following command: sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent\Backup" -t "REG_DWORD" -v "MaxDirRotationCount" -d "0x0000005" --force
|
| To compare the latest two copies of VDA backup data | sudo /opt/Citrix/VDA/bin/xdping -diff | N/A |
| To compare two specific copies of VDA backup data | **sudo /opt/Citrix/VDA/bin/xdping -diff= |
N/A |
セッションメトリックのクエリユーティリティ
ctxsession
このユーティリティは、Windowsユーザーエクスペリエンスを提供します。 このユーティリティを使用すると、次のスクリーンショットに示すようにセッションメトリックにアクセスできます：
ctxqsession、ctxquser、ctxqfull、ctxquery
これらのユーティリティの使用方法については、helpコマンドを実行してください。例：
ユーザーは自分のセッションメトリックのみを照会できます。 他のユーザーのセッションメトリックを照会する権限を持つのは、ルートユーザーおよびctxadmグループのユーザーのみです。
ctxsdcutil
このユーティリティによって、VDAでホストされているすべてのセッションや特定のセッションについて以下のメトリックを照会できます。 このためには、/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]コマンドを実行します。 [-c]引数は、1秒おきにメトリックを照会することを意味します。
-
セッション入力帯域幅
-
セッション出力帯域幅
-
セッション出力速度
-
遅延 - 最新記録
-
往復時間
-
ThinWire出力帯域幅
-
オーディオ出力帯域幅
-
プリンター出力帯域幅
-
ドライブ入力帯域幅
-
ドライブ出力帯域幅