Linux Virtual Delivery Agent

トラブルシューティング

この記事では、XDPingを使用してトラブルシューティングを行う方法と、ctxsdcutilユーティリティを使用してセッションデータを照会する方法について説明します。

XDPing

Linux XDPingツールはコマンドラインアプリケーションです。Linux VDA環境での一般的な構成の問題をチェックするプロセスを自動化します。

Linux XDPingツールは、システム上で150を超える個別のテストを実行します。これらのテストは、大きく次のように分類されます:

  • Linux VDAのシステム要件が満たされているかどうかを確認します。
  • Linuxディストリビューションを含むマシン情報を識別して表示します。
  • Linuxカーネルの互換性を確認します。
  • Linux VDAの動作に影響を与える可能性のある既知のLinuxディストリビューションの問題を確認します。
  • Security-Enhanced Linux(SELinux)のモードと互換性を確認します。
  • ネットワークインターフェイスを識別し、ネットワーク設定を確認します。
  • ストレージのパーティション分割と使用可能なディスク容量を確認します。
  • マシンのホストとドメイン名の構成を確認します。
  • DNS構成を確認し、参照テストを実行します。
  • 基盤となるハイパーバイザーを特定し、仮想マシンの構成を確認します。サポート対象:
    • Citrix Hypervisor
    • Microsoft HyperV
    • VMware vSphere
  • 時刻設定を確認し、ネットワークの時刻同期が機能しているかを確認します。
  • PostgreSQLサービスが適切に構成され動作しているかを確認します。
  • ファイアウォールが有効になっていて、必要なポートが開いているかを確認します。
  • 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のバージョンが適切かを確認します。

Linux XDPingツールの使用

注:

ctxsetup.shを実行しても、XDPingはインストールされません。sudo /opt/Citrix/VDA/bin/xdpingを実行してXDPingをインストールできます。 このコマンドでは、XDPingに必要なPython3仮想環境も作成されます。このコマンドでPython 3仮想環境の作成に失敗した場合は、「Python 3仮想環境の作成」の手順に従って手動で作成してください。

pipツールの使用時に発生する可能性のあるSSL接続エラーに対処するには、次の信頼済みホストを/etc/pip.confファイルに追加することを検討してください:
[global]
trusted-host =
pypi.org
files.pythonhosted.org

XDPingには、コマンドシェルから実行されるxdpingという名前の単一の実行可能ファイルが付属しています。

コマンドラインオプションを表示するには、-hオプションを使用します:

sudo /opt/Citrix/VDA/bin/xdping -h
<!--NeedCopy-->

テストの完全なスイートを実行するには、コマンドラインオプションなしでxdpingを実行します:

sudo /opt/Citrix/VDA/bin/xdping
<!--NeedCopy-->

Linux VDAパッケージをインストールする前に環境を確認するには、pre-flightテストを実行します:

sudo /opt/Citrix/VDA/bin/xdping --preflight
<!--NeedCopy-->

時刻テストやKerberosテストなど、特定のテストカテゴリのみを実行するには、-Tオプションを使用します:

sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos
<!--NeedCopy-->

特定のXenDesktopコントローラーをプローブするには:

sudo /opt/Citrix/VDA/bin/xdping -d myddc.domain.net
<!--NeedCopy-->

出力例

以下は、Kerberosテストを実行した場合の出力例です:

Kerberosテスト出力例の最初の部分

Kerberosテスト出力例の2番目の部分

Kerberosテスト出力例の3番目の部分

セッションデータの照会ユーティリティ

各Linux VDAのセッションデータの照会に使用できるユーティリティ(ctxsdcutil)が提供されます。VDAでホストされているすべてのセッションや特定のセッションについて次のデータを照会するには、/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]コマンドを実行します。引数[-c]は、1秒おきにデータを照会することを意味します。

  • セッション入力帯域幅

  • セッション出力帯域幅

  • セッション出力速度

  • 遅延 - 最新記録

  • 往復時間

  • ThinWire出力帯域幅

  • オーディオ出力帯域幅

  • プリンター出力帯域幅

  • ドライブ入力帯域幅

  • ドライブ出力帯域幅

トラブルシューティング