GPU non virtualisés
Dans la documentation du Linux VDA, les GPU non virtualisés font référence à :
- GPU utilisés dans les scénarios Remote PC Access
- GPU transmis par un hyperviseur
Cet article fournit des informations sur l’activation de HDX 3D Pro pour les GPU non virtualisés.
Logiciels requis
- Activez HDX 3D Pro. Pour ce faire, définissez
CTX_XDL_HDX_3D_PROsurYlors de l’installation de Linux VDA. Pour plus d’informations sur les variables d’environnement, consultez Étape 8 : définir l’environnement d’exécution afin de terminer l’installation. - Pour les GPU pris en charge par le SDK NVIDIA Linux Capture, 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 SDK NVIDIA Linux Capture, installez
XDamage. Par exemple, vous pouvez exécutersudo apt-get install -y libxdamage1pour installer XDamage sur Ubuntu 20.04. En règle générale, XDamage existe sous forme d’extension de XServer.
Configuration
Modifier les fichiers de configuration Xorg
Pour les GPU non virtualisés NVIDIA
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 utilisant ctx-driver_name-1.conf en tant qu’exemple, suivez la procédure suivante pour modifier les fichiers de configuration de modèle :
-
Remplacez driver_name par le nom de votre pilote.
Par exemple, si votre nom de pilote est
intel, vous pouvez modifier le nom du fichier de configuration pourctx-intel-1.conf. -
Ajoutez les informations du pilote vidéo.
Chaque fichier de configuration de modèle contient une section appelée « Machine », à laquelle un commentaire est ajouté. 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 :
-
Consultez le guide du GPU fourni par le fabricant pour obtenir des informations sur la configuration. Un fichier de configuration natif peut être généré. Vérifiez que votre GPU peut fonctionner dans un environnement local à l’aide du fichier de configuration natif.
-
Copiez la section « Device » du fichier de configuration natif versctx-driver_name-1.conf.
-
-
Exécutez la commande suivante pour définir la clé de registre de façon à permettre au Linux VDA de 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 relative au matériel pris en charge des notes de publication du SDK NVIDIA Linux Capture, 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-->
Occultation de moniteur pour les VDA Remote PC Access
Le Linux VDA prend en charge l’occultation de moniteur physique pour les VDA Remote PC Access 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 fonction est désactivée par défaut. Pour l’activer, procédez comme suit :
-
Installez le package
evdi-dkmsbasé sur votre distribution Linux :sudo apt install evdi-dkms <!--NeedCopy--> -
Activez le déchargement de l’affichage graphique vers l’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 distantes Citrix.
sudo systemctl disable --now gdm <!--NeedCopy-->
Dépannage
Pas de sortie graphique ou sortie illisible
Si vous pouvez exécuter des applications 3D localement et que toutes les configurations sont correctes, une sortie graphique manquante ou illisible est due à un bogue. Utilisez /opt/Citrix/VDA/bing/setlog et définissez GFX_X11 sur Détaillé afin de collecter les informations de trace à des fins de débogage.
Le codage matériel ne fonctionne pas
Si vous utilisez Xdamage, seul le codage logiciel est pris en charge.