Linux Virtual Delivery Agent

GPU no virtualizadas

  • En la documentación de Linux VDA, las GPU no virtualizadas se refieren a:

  • GPUs usadas en escenarios de Acceso remoto a PC
  • GPUs pasadas a través de un hipervisor

  • Este artículo proporciona información sobre cómo habilitar HDX™ 3D Pro para GPU no virtualizadas.

Requisitos previos

  • Habilita HDX 3D Pro. Para ello, establece CTX_XDL_HDX_3D_PRO en Y al instalar el Linux VDA. Para obtener información sobre las variables de entorno, consulta Paso 8: Configurar el entorno de ejecución para completar la instalación.
  • Para las GPU compatibles con el NVIDIA Linux Capture SDK, la aceleración de hardware se habilita de forma predeterminada después de habilitar HDX 3D Pro. No se requiere ninguna configuración adicional.
  • Para las GPU que el NVIDIA Linux Capture SDK no admite, instala XDamage. Por ejemplo, puedes ejecutar sudo apt-get install -y libxdamage1 para instalar XDamage en Ubuntu 20.04. Normalmente, XDamage existe como una extensión de XServer.

  • Configuración

  • Modificar archivos de configuración de Xorg

Para GPU NVIDIA no virtualizadas

Los archivos de configuración se instalan y configuran automáticamente.

Para otras GPU

Debes modificar los cuatro archivos de configuración de plantilla instalados en /etc/X11/:

  • ctx-driver_name-1.conf
  • ctx-driver_name-2.conf
  • ctx-driver_name-3.conf
  • ctx-driver_name-4.conf

Usando ctx-driver_name-1.conf como ejemplo, haz lo siguiente para modificar los archivos de configuración de plantilla:

  1. Reemplaza driver_name por el nombre real de tu controlador.

    Por ejemplo, si el nombre de tu controlador es intel, puedes cambiar el nombre del archivo de configuración a ctx-intel-1.conf.

  2. Agrega la información del controlador de vídeo.

    Cada archivo de configuración de plantilla contiene una sección llamada “Device”, que está comentada. Esta sección describe la información del controlador de vídeo. Habilita esta sección antes de agregar la información de tu controlador de vídeo. Para habilitar esta sección:

    1. Consulta la guía proporcionada por el fabricante de la GPU para obtener información de configuración. Se puede generar un archivo de configuración nativo. Verifica que tu GPU pueda funcionar en un entorno local con el archivo de configuración nativo.

    2. Copia la sección “Device” del archivo de configuración nativo en ctx-driver_name-1.conf.

  3. Ejecuta el siguiente comando para establecer la clave de registro para que el Linux VDA pueda reconocer el nombre del archivo de configuración establecido en el Paso 1.

    /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_SZ" -v "DriverName" -d "intel" --force
    <!--NeedCopy-->
    

Habilitar XDamage

Si usas una GPU que no aparece en la sección de hardware compatible de las notas de la versión del NVIDIA Linux Capture SDK, habilita XDamage usando:

/opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_DWORD" -v "XDamageEnabled" -d "0x00000001" --force
<!--NeedCopy-->

Apagado de monitores para VDA de Acceso remoto a PC

El Linux VDA admite el apagado de monitores físicos para VDA de Acceso remoto a PC que usan GPU no virtualizadas.

Las distribuciones de Linux completamente probadas que admiten la función incluyen Ubuntu 20.04 y Debian 11.3.

La función está deshabilitada de forma predeterminada. Para habilitarla, completa los dos pasos siguientes:

  1. Instala el paquete evdi-dkms según tu distribución de Linux:

    sudo apt install evdi-dkms
    <!--NeedCopy-->
    
  2. Habilita la descarga de la pantalla gráfica a EVDI:

    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "Evdi" -d "0x00000001" --force
    <!--NeedCopy-->
    
  3. Si usas una GPU Intel, deshabilita el administrador de pantalla. De lo contrario, la GPU Intel estará ocupada por el administrador de pantalla y no estará disponible para las sesiones remotas de Citrix®.

    sudo systemctl disable --now gdm
    <!--NeedCopy-->
    

Solución de problemas

Salida gráfica nula o distorsionada

Si puedes ejecutar aplicaciones 3D localmente y todas las configuraciones son correctas, la salida gráfica faltante o distorsionada es el resultado de un error. Usa /opt/Citrix/VDA/bin/setlog y establece GFX_X11 en verbose para recopilar la información de seguimiento para la depuración.

La codificación de hardware no funciona

Si usas Xdamage, solo se admite la codificación por software.

GPU no virtualizadas