Linux Virtual Delivery Agent

Solución de problemas

Este artículo describe cómo usar XDPing para solucionar problemas y cómo consultar métricas de sesión con la utilidad ctxsdcutil.

XDPing

La herramienta XDPing de Linux es una aplicación de línea de comandos. Automatiza el proceso de comprobación de problemas de configuración comunes en un entorno VDA de Linux.

Instalar la herramienta XDPing de Linux

Ejecutar ctxsetup.sh no instala XDPing. Para instalar XDPing, ejecuta sudo /opt/Citrix/VDA/bin/xdping. Este comando también crea un entorno virtual de Python3 que es necesario para XDPing. Si este comando no puede crear un entorno virtual de Python3, créalo manualmente siguiendo las instrucciones en Crear un entorno virtual de Python3.

Para solucionar los errores de conexión SSL que puedas encontrar al usar la herramienta pip, considera agregar los siguientes hosts de confianza al archivo /etc/pip.conf:

[global] trusted-host = pypi.org files.pythonhosted.org

Tareas que puedes realizar con XDPing

XDPing incluye un único ejecutable llamado xdping que se ejecuta desde el shell de comandos.

La siguiente tabla describe las diversas tareas que puedes realizar con los comandos XDPing correspondientes:

Tarea Comando XDPing Observaciones
Para mostrar las opciones de línea de comandos sudo /opt/Citrix/VDA/bin/xdping -h N/A
Para ejecutar el conjunto completo de pruebas sudo /opt/Citrix/VDA/bin/xdping (ejecuta XDPing sin ninguna opción de línea de comandos) La herramienta XDPing de Linux realiza más de 150 pruebas individuales en el sistema. Para obtener más información, consulta Pruebas individuales más adelante en este artículo.
  • Para ejecutar una comprobación del estado de registro del VDA sudo /opt/Citrix/VDA/bin/xdping -a Para obtener más información, consulta Alcance de las comprobaciones del estado de registro del VDA más adelante en este artículo.
  • Para hacer una copia de seguridad de los datos clave de un VDA sudo /opt/Citrix/VDA/bin/xdping -b Para obtener más información, consulta Copia de seguridad y comparación de datos del VDA más adelante en este artículo.
  • Para comparar las dos últimas copias de los datos de copia de seguridad del VDA sudo /opt/Citrix/VDA/bin/xdping -diff Para obtener más información, consulta Copia de seguridad y comparación de datos del VDA más adelante en este artículo.
  • Para comparar dos copias específicas de los datos de copia de seguridad del VDA **sudo /opt/Citrix/VDA/bin/xdping -diff=:** Para obtener más información, consulta Copia de seguridad y comparación de datos del VDA más adelante en este artículo.
  • Para comprobar el entorno antes de instalar el paquete del VDA de Linux sudo /opt/Citrix/VDA/bin/xdping —preflight N/A
  • Para ejecutar solo categorías de pruebas específicas, por ejemplo, las pruebas de hora, Kerberos y base de datos sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos,database N/A
  • Para sondear un Delivery Controller específico **sudo /opt/Citrix/VDA/bin/xdping -d ** N/A
  • Para mostrar qué dependencias están instaladas en el VDA sudo /opt/Citrix/VDA/bin/xdping –query-pkgs o sudo /opt/Citrix/VDA/bin/xdping -q N/A
  • Para mostrar qué dependencias están instaladas en el VDA y guardar los resultados de la consulta en una ruta específica **sudo /opt/Citrix/VDA/bin/xdping -f ** o **sudo /opt/Citrix/VDA/bin/xdping –query-pkgs-to ** N/A

Pruebas individuales

  • La herramienta XDPing de Linux realiza más de 150 pruebas individuales en el sistema, que se clasifican a grandes rasgos de la siguiente manera:

  • Comprobar si se cumplen los requisitos del sistema del VDA de Linux.
  • Identificar y mostrar información de la máquina, incluidas las distribuciones de Linux.
  • Comprobar la compatibilidad del kernel de Linux.
  • Comprobar si hay problemas conocidos de las distribuciones de Linux que puedan afectar el funcionamiento del VDA de Linux.
  • Comprobar el modo y la compatibilidad de Security-Enhanced Linux (SELinux).
  • Identificar interfaces de red y comprobar la configuración de red.
  • Comprobar el particionamiento del almacenamiento y el espacio en disco disponible.
  • Comprobar la configuración del host de la máquina y del nombre de dominio.
  • Comprobar la configuración de DNS y realizar pruebas de búsqueda.
  • Identificar hipervisores subyacentes y comprobar la configuración de la máquina virtual. Compatibilidad con:
    • XenServer (anteriormente Citrix Hypervisor™)
    • Microsoft HyperV
    • VMware vSphere
  • Comprobar la configuración de la hora y si la sincronización de la hora de red está operativa.
  • Comprobar si el servicio PostgreSQL está configurado y operativo correctamente.
  • Comprobar si SQLite está configurado y operativo correctamente.
  • Comprobar si el firewall está habilitado y los puertos necesarios están abiertos.
  • Comprobar la configuración de Kerberos y realizar pruebas de autenticación.
  • Comprobar el entorno de búsqueda LDAP para el motor del servicio de directivas de grupo.
  • Comprobar si la integración de Active Directory está configurada correctamente y la máquina actual está unida al dominio. Compatibilidad con:
    • Samba Winbind
    • Dell Quest Authentication Services
    • Centrify DirectControl
    • SSSD
  • Comprobar la integridad del objeto de equipo Linux en Active Directory.
  • Comprobar la configuración del Módulo de autenticación conectable (PAM).
  • Comprobar el patrón de volcado de memoria.
  • Comprobar si los paquetes requeridos por el VDA de Linux están instalados.
  • Identificar el paquete del VDA de Linux y comprobar la integridad de la instalación.
  • Comprobar la integridad de la base de datos del registro de PostgreSQL.
  • Comprobar si los servicios del VDA de Linux están configurados y operativos correctamente.
  • Comprobar la integridad de la configuración del VDA y HDX™.
  • Sondear cada Delivery Controller™ configurado para comprobar que el servicio Broker es accesible, operativo y responde.
  • Comprobar si la máquina está registrada en la granja de Delivery Controller.
  • Comprobar el estado de cada sesión HDX activa o desconectada.
  • Escanear archivos de registro en busca de errores y advertencias relacionados con el VDA de Linux.
  • Comprobar si la versión de Xorg es adecuada.
  • Comprobar si las dependencias requeridas están instaladas.

Ejemplo de salida

A continuación, se muestra un ejemplo de salida de la ejecución de la prueba de Kerberos:

La primera parte del ejemplo de salida de la prueba de Kerberos

La segunda parte del ejemplo de salida de la prueba de Kerberos

La tercera parte del ejemplo de salida de la prueba de Kerberos

  • Alcance de las comprobaciones del estado de registro del VDA

  • La herramienta XDPing de Linux también proporciona un módulo de análisis para ayudarte a comprobar y analizar el estado de registro de tu VDA. Para ver el alcance de las comprobaciones del estado de registro, consulta la siguiente captura de pantalla:

  • Comprobaciones del estado de registro

  • Copia de seguridad y comparación de datos del VDA

  • A partir del VDA de Linux 2305, la herramienta XDPing introduce un módulo de copia de seguridad del VDA. Este módulo te permite hacer una copia de seguridad de los datos clave de un VDA en cualquier momento, como la configuración, la base de datos y los datos de permisos binarios. Puedes hacer una copia de seguridad de los datos clave de un VDA cuando funciona correctamente. En caso de que el VDA falle más adelante, haz una copia de seguridad de otra copia de los datos y compara las dos copias de datos para facilitar la solución de problemas. La siguiente tabla describe la copia de seguridad y comparación de datos del VDA con los comandos XDPing correspondientes:
Tarea Comando XDPing Observaciones
Para hacer una copia de seguridad de los datos clave de un VDA sudo /opt/Citrix/VDA/bin/xdping -b Cada vez que ejecutas el comando de copia de seguridad, se genera una copia de los datos de la copia de seguridad y se guarda en un directorio bajo /var/ctxbackup. Los directorios de datos de la copia de seguridad se nombran con la fecha y hora actuales en formato aaaa-mm-dd-hh_mm_ss, por ejemplo, 2023-02-27-16_31_27. De forma predeterminada, el número máximo de directorios de datos de copia de seguridad es 30 y la herramienta XDPing rota o elimina los directorios de datos de copia de seguridad antiguos cuando se supera este número. Para personalizar el número de rotación de directorios, ejecuta el siguiente comando: sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent\Backup" -t "REG_DWORD" -v "MaxDirRotationCount" -d "0x0000005" --force
Para comparar las dos últimas copias de datos de copia de seguridad de VDA sudo /opt/Citrix/VDA/bin/xdping -diff N/A
Para comparar dos copias específicas de datos de copia de seguridad de VDA **sudo /opt/Citrix/VDA/bin/xdping -diff=:** N/A

Utilidades de consulta de métricas de sesión

ctxsession

Esta utilidad proporciona una experiencia de usuario de Windows. Con esta utilidad, puedes acceder a las métricas de sesión como se muestra en la siguiente captura de pantalla:

Consultar métricas de sesión a través de **ctxsession**

ctxqsession, ctxquser, ctxqfull, ctxquery

Para obtener instrucciones sobre cómo usar estas utilidades, ejecuta el comando de ayuda, por ejemplo:

Información de ayuda de la utilidad

Los usuarios solo pueden consultar sus propias métricas de sesión. Solo los usuarios root y los del grupo ctxadm tienen permiso para consultar las métricas de sesión de otros usuarios.

ctxsdcutil

Esta utilidad ayuda a consultar las siguientes métricas de todas las sesiones o de una sesión específica alojada en un VDA. Para ello, ejecuta el comando /opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]. El argumento [-c] significa consultar las métricas cada segundo.

  • Ancho de banda de entrada de la sesión

  • Ancho de banda de salida de la sesión

  • Velocidad de línea de salida de la sesión

  • Latencia - Última registrada

  • Tiempo de ida y vuelta

  • Ancho de banda de salida de ThinWire

  • Ancho de banda de salida de audio

  • Ancho de banda de salida de la impresora

  • Ancho de banda de entrada de la unidad

  • Ancho de banda de salida de la unidad

Solución de problemas