トラブルシューティング
この記事では、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 該当なし -
テストスイート全体の実行 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 該当なし -
特定のテストカテゴリのみの実行（例：時間、Kerberos、データベーステスト） sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos,database 該当なし -
特定の Delivery Controller のプローブ **sudo /opt/Citrix/VDA/bin/xdping -d ** 該当なし
個別のテスト
- 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™ をプローブして、Broker Service が到達可能で、動作しており、応答性があることをテストします。
- マシンが Delivery Controller ファームに登録されているかを確認します。
- アクティブまたは切断された各 HDX セッションの状態を確認します。
- Linux VDA 関連のエラーと警告についてログファイルをスキャンします。
- Xorg のバージョンが適切であるかを確認します。
- 必要な依存関係がインストールされているかを確認します。
出力例
Linux XDPing ツールは、VDA 登録ステータスをチェックおよび分析するのに役立つ分析モジュールも提供します。登録ステータスチェックの範囲については、次のスクリーンショットを参照してください。
VDA データのバックアップと比較
Linux VDA 2305 以降、XDPing ツールに 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= |
N/A |
セッションデータクエリユーティリティ
各Linux VDAでセッションデータをクエリするために使用できるユーティリティ（ctxsdcutil）を提供しています。VDAでホストされているすべてのセッションまたは特定のセッションの以下のデータをクエリするには、/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]コマンドを実行します。[-c]引数は、データを毎秒クエリすることを意味します。
-
入力セッション帯域幅
-
出力セッション帯域幅
-
出力セッション回線速度
-
遅延 - 最終記録
-
ラウンドトリップタイム
-
出力ThinWire帯域幅
-
出力オーディオ帯域幅
-
出力プリンター帯域幅
-
入力ドライブ帯域幅
-
出力ドライブ帯域幅