Linux Virtual Delivery Agent

GPU non virtualisés

  • Dans la documentation du VDA Linux, les GPU non virtualisés désignent :

  • Les GPU utilisés dans les scénarios d’accès au PC distant
  • Les GPU passés d’un hyperviseur

  • Cet article fournit des informations sur l’activation de HDX™ 3D Pro pour les GPU non virtualisés.

Prérequis

  • Activez HDX 3D Pro. Pour ce faire, définissez CTX_XDL_HDX_3D_PRO sur Y lors de l’installation du VDA Linux. Pour plus d’informations sur les variables d’environnement, consultez Étape 8 : Configurer l’environnement d’exécution pour terminer l’installation.
  • Pour les GPU pris en charge par le NVIDIA Linux Capture SDK, l’accélération matérielle est activée par défaut après l’activation de HDX 3D Pro. Aucune configuration supplémentaire n’est requise.
  • Pour les GPU non pris en charge par le NVIDIA Linux Capture SDK, installez XDamage. Par exemple, vous pouvez exécuter sudo apt-get install -y libxdamage1 pour installer XDamage sur Ubuntu 20.04. Généralement, XDamage existe en tant qu’extension de XServer.

  • Configuration

  • Modifier les fichiers de configuration Xorg

Pour les GPU NVIDIA non virtualisés

Les fichiers de configuration sont installés et configurés automatiquement.

Pour les autres GPU

Vous devez modifier les quatre fichiers de configuration de modèle installés sous /etc/X11/ :

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

En utilisant ctx-driver_name-1.conf comme exemple, procédez comme suit pour modifier les fichiers de configuration de modèle :

  1. Remplacez driver_name par le nom de votre pilote réel.

    Par exemple, si le nom de votre pilote est intel, vous pouvez modifier le nom du fichier de configuration en ctx-intel-1.conf.

  2. Ajoutez les informations du pilote vidéo.

    Chaque fichier de configuration de modèle contient une section nommée « Device », qui est commentée. Cette section décrit les informations du pilote vidéo. Activez cette section avant d’ajouter les informations de votre pilote vidéo. Pour activer cette section :

    1. Consultez le guide fourni par le fabricant du GPU pour obtenir des informations de configuration. Un fichier de configuration natif peut être généré. Vérifiez que votre GPU peut fonctionner dans un environnement local avec le fichier de configuration natif.

    2. Copiez la section « Device » du fichier de configuration natif dans ctx-driver_name-1.conf.

  3. Exécutez la commande suivante pour définir la clé de registre afin que le VDA Linux puisse reconnaître le nom du fichier de configuration défini à l’étape 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-->
    

Activer XDamage

Si vous utilisez un GPU qui n’est pas répertorié dans la section du matériel pris en charge des notes de publication du NVIDIA Linux Capture SDK, activez XDamage en utilisant :

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

Extinction de l’écran pour les VDA d’accès au PC distant

Le VDA Linux prend en charge l’extinction de l’écran physique pour les VDA d’accès au PC distant qui utilisent des GPU non virtualisés.

Les distributions Linux entièrement testées qui prennent en charge cette fonctionnalité incluent Ubuntu 20.04 et Debian 11.3.

La fonctionnalité est désactivée par défaut. Pour l’activer, suivez les deux étapes suivantes :

  1. Installez le package evdi-dkms en fonction de votre distribution Linux :

    sudo apt install evdi-dkms
    <!--NeedCopy-->
    
  2. Activez le déchargement de l’affichage graphique vers 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 vous utilisez un GPU Intel, désactivez le gestionnaire d’affichage. Sinon, le GPU Intel est occupé par le gestionnaire d’affichage et n’est pas disponible pour les sessions à distance Citrix®.

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

Dépannage

Sortie graphique absente ou brouillée

Si vous pouvez exécuter des applications 3D localement et que toutes les configurations sont correctes, une sortie graphique absente ou brouillée est le résultat d’un bogue. Utilisez /opt/Citrix/VDA/bin/setlog et définissez GFX_X11 sur verbose pour collecter les informations de trace à des fins de débogage.

L’encodage matériel ne fonctionne pas

Si vous utilisez Xdamage, seul l’encodage logiciel est pris en charge.

GPU non virtualisés