Linux Virtual Delivery Agent

GPU no virtualizadas

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

  • GPU utilizadas en escenarios de Acceso con PC remoto
  • GPU passthrough 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 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 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 no compatibles con NVIDIA Linux Capture SDK, 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 los 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

Tomando 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 de modo que 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 utilizas una GPU que no aparece en la sección de hardware compatible de las notas de la versión de NVIDIA Linux Capture SDK, habilita XDamage mediante:

/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 monitor para VDA de Acceso con PC remoto

Linux VDA admite el apagado de monitores físicos para VDA de Acceso con PC remoto que utilizan GPU no virtualizadas.

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

La función está inhabilitada 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 visualización de gráficos 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 utilizas una GPU Intel, inhabilita el administrador de visualización. De lo contrario, la GPU Intel estará ocupada por el administrador de visualización 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 nula o distorsionada es el resultado de un error. Utiliza /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 utilizas Xdamage, solo se admite la codificación por software.

GPU no virtualizadas