GPU non virtualisées
-
Dans la documentation du VDA Linux, les GPU non virtualisées désignent :
- Les GPU utilisées dans les scénarios d’accès au PC distant
-
Les GPU pass-through d’un hyperviseur
- Cet article fournit des informations sur l’activation de HDX™ 3D Pro pour les GPU non virtualisées.
Conditions préalables
- Activez HDX 3D Pro. Pour ce faire, définissez
CTX_XDL_HDX_3D_PROsurYlors 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 prises 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 prises en charge par le NVIDIA Linux Capture SDK, installez
XDamage. Par exemple, vous pouvez exécutersudo apt-get install -y libxdamage1pour 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ées
Les fichiers de configuration sont installés et définis 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 prenant ctx-driver_name-1.conf comme exemple, procédez comme suit pour modifier les fichiers de configuration de modèle :
-
Remplacez driver_name par le nom réel de votre pilote.
Par exemple, si le nom de votre pilote est
intel, vous pouvez renommer le fichier de configuration enctx-intel-1.conf. -
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 vos informations de pilote vidéo. Pour activer cette section :
-
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.
-
Copiez la section « Device » du fichier de configuration natif dans ctx-driver_name-1.conf.
-
-
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 ne figure pas dans la section du matériel pris en charge des notes de publication du NVIDIA Linux Capture SDK, activez XDamage à l’aide de :
/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 physique de l’écran pour les VDA d’accès au PC distant qui utilisent des GPU non virtualisées.
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 :
-
Installez le package
evdi-dkmsen fonction de votre distribution Linux :sudo apt install evdi-dkms <!--NeedCopy--> -
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--> -
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.