トラブルシューティング
この記事では、XDPingを使用したトラブルシューティングの方法と、ctxsdcutilユーティリティを使用したセッションメトリックのクエリ方法について説明します。
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=<1つのバックアップデータディレクトリ>:<もう1つのバックアップデータディレクトリ>**もう1つのバックアップデータディレクトリ> 詳細については、この記事の後半にある「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 -
VDAにインストールされている依存関係の表示 sudo /opt/Citrix/VDA/bin/xdping –query-pkgs または sudo /opt/Citrix/VDA/bin/xdping -q N/A -
VDAにインストールされている依存関係を表示し、クエリ結果を特定のパスに保存 **sudo /opt/Citrix/VDA/bin/xdping -f <クエリ結果を保存する特定のパス>** または **sudo /opt/Citrix/VDA/bin/xdping –query-pkgs-to <クエリ結果を保存する特定のパス>**クエリ結果を保存する特定のパス>クエリ結果を保存する特定のパス> N/A
個別のテスト
- Linux XDPingツールは、システム上で150を超える個別のテストを実行し、以下のカテゴリに大別されます。
- Linux VDAのシステム要件が満たされているかを確認します。
- Linuxディストリビューションを含むマシン情報を特定して表示します。
- Linuxカーネルの互換性を確認します。
- Linux VDAの動作に影響を与える可能性のある既知のLinuxディストリビューションの問題を確認します。
- Security-Enhanced Linux（SELinux）モードと互換性を確認します。
- ネットワークインターフェイスを特定し、ネットワーク設定を確認します。
- ストレージパーティションと利用可能なディスク容量を確認します。
- マシンのホスト名とドメイン名の構成を確認します。
- DNS構成を確認し、ルックアップテストを実行します。
- 基盤となるハイパーバイザーを特定し、仮想マシンの構成を確認します。サポート対象：
- XenServer（旧Citrix Hypervisor™）
- Microsoft Hyper-V
- 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つのデータコピーを比較してトラブルシューティングを容易にすることができます。次の表に、対応する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=<1つ目のバックアップデータディレクトリ>:<2つ目のバックアップデータディレクトリ> | 該当なし |
セッションメトリッククエリユーティリティ
ctxsession
このユーティリティは、Windowsユーザーエクスペリエンスを提供します。このユーティリティを使用すると、次のスクリーンショットに示すようにセッションメトリックにアクセスできます。
ctxqsession、ctxquser、ctxqfull、ctxquery
これらのユーティリティの使用方法については、例えば、ヘルプコマンドを実行してください。
ユーザーは自身のセッションメトリックのみをクエリできます。他のユーザーのセッションメトリックをクエリする権限を持つのは、rootユーザーとctxadmグループのユーザーのみです。
ctxsdcutil
このユーティリティは、VDAでホストされているすべてのセッションまたは特定のセッションの次のメトリックをクエリするのに役立ちます。これを行うには、/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c] コマンドを実行します。[-c] 引数は、メトリックを毎秒クエリすることを意味します。
-
入力セッション帯域幅
-
出力セッション帯域幅
-
出力セッション回線速度
-
遅延 - 最終記録
-
ラウンドトリップタイム
-
出力ThinWire帯域幅
-
出力オーディオ帯域幅
-
出力プリンター帯域幅
-
入力ドライブ帯域幅
-
出力ドライブ帯域幅