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 à distance au PC
  • Les GPU pass-through d’un hyperviseur

Cet article fournit des informations sur la prise en charge des GPU non virtualisés.

Activer HDX™ 3D Pro pour les GPU NVIDIA qui prennent en charge le SDK NVIDIA Capture pour Linux

Pour les GPU NVIDIA qui prennent en charge le SDK NVIDIA Capture pour Linux, activez HDX 3D Pro simplement en définissant CTX_XDL_HDX_3D_PRO sur Y lors de l’installation du VDA Linux. Aucune configuration supplémentaire n’est requise. L’accélération matérielle est activée par défaut après l’activation de HDX 3D Pro.

Compatible avec les GPU NVIDIA qui ne prennent pas en charge le SDK NVIDIA Capture pour Linux et les GPU d’autres fabricants tels qu’AMD et Intel

Remarque :

Dans ce scénario, seul l’encodage logiciel est pris en charge.

Étape 1 : Définir CTX_XDL_HDX_3D_PRO sur Y lors de l’installation du VDA Linux

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.

Étape 3 : Activer XDamage en exécutant la commande suivante

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

Étape 4 : Modifier les fichiers de configuration Xorg

Vous trouverez les quatre fichiers de configuration de modèle suivants sous /etc/X11. En fonction du nombre de moniteurs connectés, modifiez l’un des fichiers de configuration de modèle portant le numéro correspondant dans son nom. Par exemple, si un seul moniteur est connecté, modifiez le fichier de configuration de modèle portant le numéro 1 dans son nom, c’est-à-dire ctx-driver_name-1.conf. Si deux moniteurs sont connectés, modifiez le fichier de configuration de modèle portant le numéro 2 dans son nom, c’est-à-dire ctx-driver_name-2.conf.

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

En prenant 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 changer 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 les 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-->
    

Suppression de l’affichage du moniteur pour les VDA d’accès à distance au PC

Le VDA Linux prend en charge la suppression de l’affichage physique du moniteur pour les VDA d’accès à distance au PC 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.

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 gestionnaire d’affichage occupe le GPU Intel et le rend indisponible pour les sessions à distance Citrix®.

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

Dépannage

Sortie graphique nulle ou brouillée

Si vous pouvez exécuter des applications 3D localement et que toutes les configurations sont correctes, une sortie graphique manquante 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.