Citrix テレメトリーサービスとの統合
Citrix テレメトリーサービス (ctxtelemetry) が Linux VDA ソフトウェアに統合されている場合、Citrix Scout を実行し、その後 /opt/Citrix/VDA/bin/xdlcollect.sh スクリプトを使用して Linux VDA に関するログを収集できます。
シトリックス テレメトリー サービスの有効化と無効化
- サービスを有効にするには、sudo systemctl enable ctxtelemetry.socket というコマンドを実行してください。
- サービスを無効にするには、sudo systemctl disable ctxtelemetry.socket というコマンドを実行してください。
ポート
Citrix テレメトリーサービス (ctxtelemetry) は、デフォルトで TCP/IP ポート 7503 を使用して Citrix Scout をリッスンします。デリバリーコントローラーでは、TCP/IP ポート 7502 を使用して Citrix Scout と通信します。
VDA のインストール後にポートを変更するには、次の手順を実行します。
-
Scout と通信するためのポートを変更するには、次のコマンドを実行します。
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t REG_DWORD -v "TelemetryServicePort" -d <port number> --force <!--NeedCopy--> -
Scout をリッスンするためのソケットポートを変更するには、次のコマンドを実行して ctxtelemetry.socket ファイルを開いて編集します。
sudo vi /etc/systemd/system/ctxtelemetry.socket <!--NeedCopy-->ソケットポートの画像(/ja-jp/linux-virtual-delivery-agent/2511/media/socket-port.png)
-
ソケットポートを再起動するには、次のコマンドを実行します。
sudo systemctl daemon-reload sudo systemctl stop ctxtelemetry.socket sudo systemctl start ctxtelemetry.socket <!--NeedCopy--> -
ファイアウォール構成で新しいポートを有効にします。
たとえば、Ubuntu を使用している場合は、ポート 7503 を有効にするために sudo ufw allow 7503 コマンドを実行します。
注:
代わりにctxsetup.shを実行して、前述の手順3と4を自動化することもできます。
デバッグモード
Citrix Telemetry Serviceが期待どおりに動作しない場合は、デバッグモードを有効にして原因を特定できます。
-
デバッグモードを有効にするには、次のコマンドを実行して
ctxtelemetryファイルを開き、DebugModeの値を1に変更します。sudo vi /opt/Citrix/VDA/sbin/ctxtelemetry <!--NeedCopy-->
-
Citrix Telemetry Serviceを手動で停止するか、サービスが自動的に停止するまで15分間待ちます。
この例では、次のコマンドを実行してCitrix Telemetry Serviceを停止できます。
sudo netstat -ntlp Kill -9 1958 <!--NeedCopy--> -
シトリックス テレメトリー サービスを再起動するには、スカウトでLinux VDAを選択し、/var/log/xdl/にあるtelemetry-debug.logを見つけます。
サービスの待機時間
ソケットポートを開くsystemdデーモンは、デフォルトで起動し、使用するリソースはわずかです。Citrix Telemetry Serviceはデフォルトで停止しており、Delivery Controllerからのログ収集要求があった場合にのみ起動します。ログ収集が完了すると、サービスは15分間新しい収集要求を待ち、要求がない場合は再度停止します。待機時間は、次のコマンドで構成できます。最小値は10分です。10分未満の値を設定した場合、最小値である10分が適用されます。待機時間を設定したら、サービスを停止して再起動します。
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "TelemetryServiceIdleTimeoutInMinutes" -d <number> -t REG_DWORD
<!--NeedCopy-->
検証テスト
収集が開始される前に、選択された各マシンに対して検証テストが自動的に実行されます。これらのテストは、要件が満たされていることを確認します。マシンのテストが失敗した場合、Scoutは推奨される修正措置を含むメッセージを表示します。検証テストの詳細については、Citrix Scoutドキュメントの検証テストセクションを参照してください。