トラブルシューティング
この記事では、XDPing を使用したトラブルシューティングと、ctxsdcutil ユーティリティを使用したセッションメトリックのクエリ方法について説明します。
エックスディーピング
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の主要データをバックアップするには | 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データのバックアップと比較」(#backup-and-comparison-of-vda-data)をこの記事の後半で参照してください。 |
| Linux VDAパッケージをインストールする前に環境を確認する | sudo /opt/Citrix/VDA/bin/xdping –preflight | 該当なし |
| 特定のテストカテゴリのみを実行する（例：時間、Kerberos、データベースのテスト） | sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos,database | 該当なし |
| 特定のデリバリーコントローラーをプローブするには | **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 ** or **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™ という名称で提供されていた製品として知られています)
- マイクロソフト ハイパーV
- ヴイエムウェア vSphere
- 時刻設定を確認し、ネットワーク時刻同期が動作しているか確認します。
- PostgreSQLサービスが適切に構成され、動作しているか確認します。
- SQLiteが適切に構成され、動作しているか確認します。
- ファイアウォールが有効になっており、必要なポートが開いているか確認します。
- Kerberos構成を確認し、認証テストを実行します。
- グループポリシーサービスエンジン用のLDAP検索環境を確認します。
- Active Directory統合が適切に設定され、現在のマシンがドメインに参加しているか確認します。サポート対象：
- サンバ ウィンバインド
- デル クエスト 認証サービス
- セントリファイ ダイレクトコントロール
- エスエスエスディー
- Active Directory内のLinuxコンピューターオブジェクトの整合性を確認します。
- プラガブル認証モジュール (PAM) の構成を確認します。
- コアダンプパターンを確認します。
- Linux VDA に必要なパッケージがインストールされているか確認します。
- Linux VDA パッケージを特定し、インストールの整合性を確認します。
- PostgreSQL レジストリデータベースの整合性を確認します。
- Linux VDA サービスが適切に構成され、動作しているか確認します。
- VDA および HDX™ 構成の整合性を確認します。
- 各構成済み Delivery Controller™ をプローブして、Broker Service が到達可能で、動作しており、応答性があることをテストします。
- マシンが Delivery Controller ファームに登録されているか確認します。
- アクティブまたは切断された各 HDX セッションの状態を確認します。
- Linux VDA 関連のエラーと警告についてログファイルをスキャンします。
- Xorg のバージョンが適切であるか確認します。
- 必要な依存関係がインストールされているか確認します。
サンプル出力
以下は、Kerberos テストを実行したときの出力例です。
Kerberos テストの出力例の最初の部分(/ja-jp/linux-virtual-delivery-agent/2511/media/kerberos-test-sample-output-1.png)
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 | N/A |
| VDAバックアップデータの特定の2つのコピーを比較するには | **sudo /opt/Citrix/VDA/bin/xdping -diff=<1つ目のバックアップデータディレクトリ>:<もう1つのバックアップデータディレクトリ>**もう1つのバックアップデータディレクトリ> | N/A |
セッションメトリッククエリユーティリティ
ctxセッション
このユーティリティは、Windowsのユーザーエクスペリエンスを提供します。このユーティリティを使用すると、次のスクリーンショットに示すようにセッションメトリックにアクセスできます。
ctxqセッション、ctxqユーザー、ctxqフル、ctxqクエリ
これらのユーティリティの使用方法については、ヘルプコマンドを実行してください。例:
ユーザーは自分のセッションメトリックのみを照会できます。rootユーザーとctxadmグループのユーザーのみが、他のユーザーのセッションメトリックを照会する権限を持っています。
ctxsdcutil
このユーティリティは、VDAでホストされているすべてのセッションまたは特定のセッションの次のメトリックを照会するのに役立ちます。そのためには、/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]コマンドを実行します。[-c]引数は、1秒ごとにメトリックを照会することを意味します。
-
入力セッション帯域幅
-
セッション出力帯域幅
-
セッション出力回線速度
-
遅延 - 最終記録
-
ラウンドトリップ時間
-
シンワイヤー出力帯域幅
-
オーディオ出力帯域幅
-
プリンター出力帯域幅
-
ドライブ入力帯域幅
-
ドライブ出力帯域幅