ツールとユーティリティ
セッションデータクエリユーティリティ
-
各Linux VDAでセッションデータをクエリするために使用できるユーティリティ (ctxsdcutil) を提供しています。VDAでホストされているすべてのセッションまたは特定のセッションの次のデータをクエリするには、
/opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]コマンドを実行します。[-c]引数は、毎秒データをクエリすることを意味します。 -
入力セッション帯域幅
-
出力セッション帯域幅
-
出力セッション回線速度
-
遅延 - 最終記録
-
ラウンドトリップタイム
-
出力ThinWire帯域幅
-
出力オーディオ帯域幅
-
出力プリンター帯域幅
-
入力ドライブ帯域幅
-
出力ドライブ帯域幅
xdlcollect Bashスクリプト
ログを収集するために使用されるxdlcollect Bashスクリプトは、Linux VDAソフトウェアに統合されており、/opt/Citrix/VDA/binにあります。Linux VDAをインストールした後、bash /opt/Citrix/VDA/bin/xdlcollect.shコマンドを実行してログを収集できます。ログ収集が完了すると、スクリプトと同じフォルダーに圧縮されたログファイルが生成されます。xdlcollect Bashスクリプトは、圧縮されたログファイルをCitrix Insight Services (CIS) にアップロードするかどうかを尋ねることができます。同意すると、アップロード完了後にxdlcollectはupload_IDを返します。アップロードしても、圧縮されたログファイルがローカルマシンから削除されることはありません。他のユーザーはupload_IDを使用してCISのログファイルにアクセスできます。
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=<1つのバックアップデータディレクトリ>:<もう1つのバックアップデータディレクトリ>**もう1つのバックアップデータディレクトリ> 詳細については、この記事の後半にある「VDAデータのバックアップと比較」を参照してください。
-
-
Linux VDAパッケージをインストールする前の環境チェック sudo /opt/Citrix/VDA/bin/xdping —preflight N/A -
特定のテストカテゴリのみの実行（例：時刻とKerberosテスト） sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos N/A -
特定のDelivery Controllerのプローブ **sudo /opt/Citrix/VDA/bin/xdping -d ** N/A
個別テスト
- Linux **XDPing**ツールは、システム上で150を超える個別のテストを実行し、これらは大まかに次のように分類されます。
-
注：
-
-
Linux XDPingツールはSQLiteテストを実行しません。
- 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のバージョンが適切であるかどうかの確認
- 必要な依存関係がインストールされているかどうかの確認
出力例
以下は、Kerberosテストを実行したときの出力例です。
[[CODE_BLOCK_0]]
[[CODE_BLOCK_1]]
[[CODE_BLOCK_2]]
VDA登録ステータスチェックの範囲
Linux XDPingツールは、VDA登録ステータスをチェックおよび分析するのに役立つ分析モジュールも提供します。登録ステータスチェックの範囲については、次のスクリーンキャプチャを参照してください。
[[CODE_BLOCK_3]]
VDAデータのバックアップと比較
Linux VDA 2305以降、XDPingツールにVDAバックアップモジュールが導入されました。このモジュールを使用すると、構成、データベース、バイナリ権限データなど、VDAの主要データをいつでもバックアップできます。VDAが正常に動作しているときに、その主要データをバックアップできます。後でVDAに障害が発生した場合に備えて、データの別のコピーをバックアップし、2つのデータコピーを比較することで、トラブルシューティングを容易にすることができます。次の表に、VDAデータのバックアップと、対応するXDPingコマンドを使用した比較について説明します。
| タスク | 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= |
該当なし |