トラブルシューティング
この記事では、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= : ** 詳細については、この記事の後半の「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 or sudo /opt/Citrix/VDA/bin/xdping -q N/A -
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™)
- 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 のバージョンの適切性の確認
- 必要な依存関係のインストール状況の確認
出力例
以下は、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= |
該当なし |
セッションメトリッククエリユーティリティ
ctxsession
このユーティリティは、Windowsのユーザーエクスペリエンスを提供します。このユーティリティを使用すると、次のスクリーンショットに示すようにセッションメトリックにアクセスできます。
ctxqsession, ctxquser, ctxqfull, ctxquery
これらのユーティリティの使用方法については、たとえば、ヘルプコマンドを実行してください。
ユーザーは自分のセッションメトリックのみをクエリできます。他のユーザーのセッションメトリックをクエリする権限を持つのは、rootユーザーとctxadmグループのユーザーのみです。
ctxsdcutil
このユーティリティは、VDAでホストされているすべてのセッションまたは特定のセッションの次のメトリックをクエリするのに役立ちます。これを行うには、/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]コマンドを実行します。[-c]引数は、1秒ごとにメトリックをクエリすることを意味します。
-
入力セッション帯域幅
-
出力セッション帯域幅
-
出力セッション回線速度
-
遅延 - 最終記録
-
ラウンドトリップタイム
-
出力ThinWire帯域幅
-
出力オーディオ帯域幅
-
出力プリンター帯域幅
-
入力ドライブ帯域幅
-
出力ドライブ帯域幅