Agente de entrega virtual de Linux 2507 LTSR

Integración con el servicio de telemetría de Citrix

Con el servicio de telemetría de Citrix (ctxtelemetry) integrado en el software VDA de Linux, puedes ejecutar Citrix Scout, que luego usa el script /opt/Citrix/VDA/bin/xdlcollect.sh para recopilar registros sobre el VDA de Linux.

  • Citrix Scout

Habilitar y deshabilitar el servicio de telemetría de Citrix

  • Para habilitar el servicio, ejecuta el comando sudo systemctl enable ctxtelemetry.socket.
  • Para deshabilitar el servicio, ejecuta sudo systemctl disable ctxtelemetry.socket.

Puertos

El servicio de telemetría de Citrix (ctxtelemetry), de forma predeterminada, usa el puerto TCP/IP 7503 para escuchar a Citrix Scout. Usa el puerto TCP/IP 7502 en el Delivery Controller para comunicarse con Citrix Scout.

Para cambiar los puertos después de instalar el VDA, haz lo siguiente:

  1. Para cambiar un puerto para comunicarte con Scout, ejecuta el siguiente comando.

    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t REG_DWORD -v "TelemetryServicePort" -d <port number> --force
    <!--NeedCopy-->
    
  2. Para cambiar el puerto de socket para escuchar a Scout, ejecuta 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. Ejecuta 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. Habilita los nuevos puertos en la configuración de tu firewall.

    Si usas Ubuntu, por ejemplo, ejecuta el comando sudo ufw allow 7503 para habilitar el puerto 7503.

Nota:

También puedes ejecutar ctxsetup.sh para automatizar los pasos 3 y 4 anteriores.

Modo de depuración

Si el servicio de telemetría de Citrix no funciona como esperas, puedes habilitar el modo de depuración para determinar las causas.

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

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

    Habilitar modo de depuración

  2. Detén manualmente el servicio de telemetría de Citrix, o espera 15 minutos a que el servicio se detenga automáticamente.

    Detener telemetría

    En este ejemplo, puedes ejecutar los siguientes comandos para detener el servicio de telemetría de Citrix.

    sudo netstat -ntlp
    Kill -9 1958
    <!--NeedCopy-->
    
  3. Para reiniciar el servicio de telemetría de Citrix, selecciona tu VDA de Linux en Scout y busca 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 usa pocos recursos. El servicio de telemetría de Citrix se detiene de forma predeterminada y se inicia solo cuando hay una solicitud de recopilación de registros del Delivery Controller. Una vez completada la recopilación de registros, el servicio espera nuevas solicitudes de recopilación durante 15 minutos y se detiene de nuevo si no hay ninguna. Puedes configurar el tiempo de espera mediante el siguiente comando. El valor mínimo es de 10 minutos. Si estableces un valor inferior a 10 minutos, el valor mínimo (10 minutos) surte efecto. Después de establecer el tiempo de espera, detén y reinicia 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 de que comience una recopilación, las pruebas de verificación se ejecutan automáticamente para cada máquina seleccionada. Estas pruebas garantizan que se cumplan los requisitos. Si una prueba falla en una máquina, Scout muestra un mensaje con las acciones correctivas sugeridas. Para obtener más información sobre las pruebas de verificación, consulta la sección Pruebas de verificación en la documentación de Citrix Scout.

Integración con el servicio de telemetría de Citrix