Linux Virtual Delivery Agent 2106

Integración con Citrix Telemetry Service

Con Citrix Telemetry Service (ctxtelemetry) integrado con el software Linux VDA, puede ejecutar Citrix Scout, que, a su vez, utiliza el script /opt/Citrix/VDA/bin/xdlcollect.sh para recopilar registros sobre Linux VDA.

Imagen de Citrix Scout

Nota:

Después de actualizar desde Linux VDA 1912 y versiones anteriores, debe volver a ejecutar /opt/Citrix/VDA/sbin/ctxsetup.sh para configurar las variables de Citrix Telemetry Service (ctxtelemetry). Para obtener más información acerca de las variables, consulte Easy Install.

Habilitar e inhabilitar Citrix Telemetry Service

  • Para habilitar el servicio, ejecute el comando sudo systemctl enable ctxtelemetry.socket.
  • Para inhabilitar el servicio, ejecute sudo systemctl disable ctxtelemetry.socket.

Puertos

De forma predeterminada, Citrix Telemetry Service (ctxtelemetry) utiliza el puerto TCP/IP 7503 para escuchar a Citrix Scout. Para comunicarse con Citrix Scout, utiliza el puerto TCP/IP 7502 en el Delivery Controller.

Puede utilizar los puertos predeterminados o cambiarlos mediante las siguientes variables al instalar Linux VDA.

  • CTX_XDL_TELEMETRY_SOCKET_PORT: El puerto de socket para escuchar a Citrix Scout. El puerto predeterminado es 7503.
  • CTX_XDL_TELEMETRY_PORT: El puerto para comunicarse con Citrix Scout. El puerto predeterminado es 7502.

Para cambiar los puertos una vez instalado el VDA, haga lo siguiente:

  1. Para cambiar un puerto para comunicarse con Scout, ejecute el siguiente comando.

    /opt/Citrix/VDA/bin/ctxreg update -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "TelemetryServicePort" -d <port number> -t REG_DWORD
    <!--NeedCopy-->
    
  2. Para cambiar el puerto de socket para escuchar a Scout, ejecute el siguiente comando para abrir y modificar el archivo ctxtelemetry.socket.

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

    imagen del puerto de socket

  3. Ejecute los siguientes comandos para reiniciar el puerto de socket.

    sudo systemctl daemon-reload
    sudo systemctl stop ctxtelemetry.socket
    sudo systemctl start ctxtelemetry.socket
    <!--NeedCopy-->
    
  4. Habilite los nuevos puertos en la configuración del firewall.

    Si está utilizando una distribución Ubuntu, por ejemplo, ejecute el comando sudo ufw allow 7503 para habilitar el puerto 7503.

Modo de depuración

Si Citrix Telemetry Service no funciona de la manera prevista, puede habilitar el modo de depuración para determinar las causas.

  1. Para habilitar el modo de depuración, ejecute el siguiente comando para abrir el archivo ctxtelemetry y, a continuación, cambie el valor de DebugMode a 1.

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

    imagen de habilitar el modo de depuración

  2. Detenga manualmente Citrix Telemetry Service o espere 15 minutos para que el servicio se detenga automáticamente.

    imagen de parada de telemetría

    En este ejemplo, puede ejecutar los siguientes comandos para detener Citrix Telemetry Service.

    sudo netstat -ntlp
    Kill -9 1958
    <!--NeedCopy-->
    
  3. Para reiniciar Citrix Telemetry Service, seleccione su Linux VDA en Scout y busque telemetry-debug.log en /var/log/xdl/.

Tiempo de espera del servicio

El demonio systemd que abre el puerto de socket se inicia de forma predeterminada y utiliza pocos recursos. Citrix Telemetry Service se detiene de forma predeterminada y solo se inicia cuando hay una solicitud de recopilación de registros de Delivery Controller. Una vez completada la recopilación de registros, el servicio espera nuevas solicitudes de recopilación durante un plazo de 15 minutos y se detiene de nuevo si no hay ninguna. Puede configurar el tiempo de espera con el siguiente comando. El valor mínimo es de 10 minutos. Si establece un valor inferior a 10 minutos, surtirá efecto el valor mínimo de 10 minutos. Después de configurar el tiempo de espera, detenga y reinicie el servicio.

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "TelemetryServiceIdleTimeoutInMinutes" -d <number> -t REG_DWORD
<!--NeedCopy-->

Pruebas de verificación

Antes del inicio de una recopilación, se ejecutan automáticamente pruebas de verificación en cada máquina seleccionada. Estas pruebas tienen por finalidad comprobar que se cumplen los requisitos. Si la prueba de una máquina falla, Scout muestra un mensaje con acciones correctivas sugeridas. Para obtener más información acerca de las pruebas de verificación, consulte la sección Pruebas de verificación de la documentación de Citrix Scout.

Integración con Citrix Telemetry Service