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™ をプローブし、Broker Service が到達可能で、動作しており、応答性があることをテスト
  • マシンが Delivery Controller ファームに登録されているかを確認
  • アクティブまたは切断された各 HDX セッションの状態を確認
  • Linux VDA 関連のエラーと警告についてログファイルをスキャン
  • Xorg のバージョンが適切であるかを確認

Linux XDPing ツールの使用

注:

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

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® Controller をプローブするには:
-  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] 引数は、毎秒データをクエリすることを意味します。

  • 入力セッション帯域幅

  • 出力セッション帯域幅

  • 出力セッション回線速度

  • 遅延 - 最終記録

  • ラウンドトリップタイム

  • 出力 ThinWire 帯域幅

  • 出力オーディオ帯域幅

  • 出力プリンター帯域幅

  • 入力ドライブ帯域幅

  • 出力ドライブ帯域幅

トラブルシューティング