Linux 虚拟投递代理 2507 LTSR

与 Citrix Telemetry Service 集成

将 Citrix Telemetry Service (ctxtelemetry) 与 Linux VDA 软件集成后,您可以运行 Citrix Scout,它会使用 /opt/Citrix/VDA/bin/xdlcollect.sh 脚本收集有关 Linux VDA 的日志。

  • Citrix Scout

启用和禁用 Citrix Telemetry Service

  • 要启用此服务,请运行命令 sudo systemctl enable ctxtelemetry.socket
  • 要禁用此服务,请运行命令 sudo systemctl disable ctxtelemetry.socket

端口

Citrix Telemetry Service (ctxtelemetry) 默认使用 TCP/IP 端口 7503 侦听 Citrix Scout。它使用 Delivery Controller 上的 TCP/IP 端口 7502 与 Citrix Scout 通信。

在安装 VDA 后更改端口,请执行以下操作:

  1. 要更改与 Scout 通信的端口,请运行以下命令。

    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t REG_DWORD -v "TelemetryServicePort" -d <port number> --force
    <!--NeedCopy-->
    
  2. 要更改用于侦听 Scout 的套接字端口,请运行以下命令以打开并编辑 ctxtelemetry.socket 文件。

    sudo vi /etc/systemd/system/ctxtelemetry.socket
    <!--NeedCopy-->
    

    套接字端口图像

  3. 运行以下命令以重新启动套接字端口。

    sudo systemctl daemon-reload
    sudo systemctl stop ctxtelemetry.socket
    sudo systemctl start ctxtelemetry.socket
    <!--NeedCopy-->
    
  4. 在防火墙配置中启用新端口。

    例如,如果您使用的是 Ubuntu,请运行命令 sudo ufw allow 7503 以启用端口 7503。

注意:

您也可以运行 ctxsetup.sh 来自动执行上述步骤 3 和 4。

调试模式

如果 Citrix Telemetry Service 未按预期工作,您可以启用调试模式以确定原因。

  1. 要启用调试模式,请运行以下命令以打开 ctxtelemetry 文件,然后将 DebugMode 值更改为 1。

    sudo vi /opt/Citrix/VDA/sbin/ctxtelemetry
    <!--NeedCopy-->
    

    启用调试模式

  2. 手动停止 Citrix Telemetry Service,或者等待 15 分钟让服务自动停止。

    停止遥测

    在此示例中,您可以运行以下命令来停止 Citrix Telemetry Service。

    sudo netstat -ntlp
    Kill -9 1958
    <!--NeedCopy-->
    
  3. 要重新启动 Citrix Telemetry Service,请在 Scout 上选择您的 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 文档中的验证测试部分。

与 Citrix Telemetry Service 集成