Documentation produit

Linux Virtual Delivery Agent

Voir PDF

Configuration et optimisation graphiques

April 10, 2026

Contributeur:

C C

Cet article décrit la configuration et l’optimisation graphiques du VDA Linux.

Pour plus d’informations, consultez la section Configuration système requise et Présentation de l’installation.

Configuration

Optimiser pour les charges de travail graphiques 3D

Ce paramètre configure les valeurs par défaut appropriées qui conviennent le mieux aux charges de travail graphiques intensives. Activez ce paramètre pour les utilisateurs dont la charge de travail est axée sur les applications graphiques intensives. Appliquez cette stratégie uniquement dans les cas où un GPU est disponible pour la session. Tout autre paramètre qui remplace explicitement les paramètres par défaut définis par cette stratégie a la priorité.
Par défaut, Optimiser pour les charges de travail graphiques 3D est désactivé.

Codec vidéo pour la compression

Thinwire est la technologie d’affichage à distance utilisée dans le VDA Linux. Cette technologie permet de transmettre les graphiques générés sur une machine, généralement via un réseau, à une autre machine pour affichage.

La stratégie graphique Utiliser le codec vidéo pour la compression définit le mode graphique par défaut et offre les options suivantes pour différents cas d’utilisation :

Utiliser si préféré. Ce paramètre est celui par défaut. Aucune configuration supplémentaire n’est requise. Il garantit que Thinwire est sélectionné pour toutes les connexions Citrix® et optimisé pour l’évolutivité, la bande passante et une qualité d’image supérieure pour les charges de travail de bureau typiques.
Pour tout l’écran. Fournit Thinwire avec H.264 ou H.265 plein écran pour optimiser l’expérience utilisateur et la bande passante, en particulier dans les cas d’utilisation intensive de graphiques 3D. Le filigrane de session est pris en charge lorsque Pour tout l’écran est sélectionné, ou lorsque Utiliser si préféré est sélectionné et que Optimiser pour les charges de travail graphiques 3D est activé.
Pour les régions en évolution active. La technologie d’affichage adaptative de Thinwire identifie les images en mouvement (vidéo, 3D en mouvement). Elle utilise H.264 ou H.265 uniquement dans la partie de l’écran où l’image est en mouvement. L’utilisation sélective du codec vidéo H.264 ou H.265 permet à HDX Thinwire de détecter et d’encoder les parties de l’écran qui sont fréquemment mises à jour à l’aide du codec vidéo H.264 ou H.265. La compression d’images fixes (JPEG, RLE) et la mise en cache de bitmaps continuent d’être utilisées pour le reste de l’écran, y compris le texte et les images photographiques. Les utilisateurs bénéficient d’une consommation de bande passante réduite et d’une meilleure qualité pour le contenu vidéo, combinées à un texte sans perte ou à des images de haute qualité ailleurs. L’utilisation sélective de H.265 n’est pas prise en charge lorsque la stratégie Qualité visuelle est définie sur Toujours sans perte ou Construire sans perte.

Certains autres paramètres de stratégie, y compris les paramètres de stratégie d’affichage visuel suivants, peuvent être utilisés pour affiner les performances de l’affichage à distance :

Encodage matériel H.265/H.264

La stratégie Utiliser l’encodage matériel pour le codec vidéo permet l’utilisation de l’accélération matérielle GPU, si disponible, pour compresser les éléments d’écran avec le codec vidéo. L’accélération matérielle GPU optimise l’utilisation des ressources matérielles et améliore considérablement les performances en termes d’images par seconde (IPS).

L’accélération matérielle GPU couvre tous les modes graphiques définis par la stratégie Utiliser le codec vidéo pour la compression :

Utiliser si préféré
Pour tout l’écran
Pour les régions en évolution active

Pour activer la compression vidéo matérielle, suivez les étapes suivantes :

Définissez la stratégie Utiliser l’encodage matériel pour le codec vidéo sur Activé.
Définissez Utiliser le codec vidéo pour la compression sur Utiliser si préféré, Pour tout l’écran ou Pour les régions en évolution active. Assurez-vous qu’il n’est pas défini sur Ne pas utiliser le codec vidéo.

Le codec vidéo H.265 doit être pris en charge et activé à la fois sur le VDA et sur l’application Citrix Workspace. Si le codec vidéo H.265 n’est pas pris en charge sur le VDA Linux ou sur l’application Citrix Workspace, le paramètre de stratégie Décodage H.265 pour les graphiques est ignoré et les sessions reviennent à l’utilisation du codec vidéo H.264. Si le matériel GPU n’est pas disponible, le VDA revient à l’encodage basé sur le CPU à l’aide du codec vidéo logiciel.

Pour activer l’encodage matériel H.265 sur votre client, consultez Encodage vidéo H.265.

Le VDA Linux prend en charge H.265 pour l’accélération matérielle des graphiques et des vidéos sur les clients suivants :

Citrix Receiver pour Windows 4.10 à 4.12
Application Citrix Workspace™ 1808 pour Windows et versions ultérieures

Compression sans perte H.265/H.264

-  La compression sans perte H.265/H.264 est disponible pour l'accélération matérielle HDX 3D PRO par les GPU NVIDIA. La compression sans perte H.265 nécessite l'application Citrix Workspace 2305 pour Windows et versions ultérieures. La compression sans perte H.264 nécessite les clients suivants :

-  Application Citrix Workspace 2303 pour Windows et versions ultérieures
-  Application Citrix Workspace 2301 pour Mac et versions ultérieures avec la puce Apple M1

Pour activer la compression sans perte H.265/H.264, suivez les étapes suivantes :

Définissez la stratégie Utiliser l’encodage matériel pour le codec vidéo sur Activé.
Définissez la stratégie Utiliser le codec vidéo pour la compression sur Pour tout l’écran.
Définissez la stratégie Qualité visuelle sur Toujours sans perte ou Construire sans perte.

Autoriser la compression visuellement sans perte

La stratégie Autoriser la compression visuellement sans perte permet d’utiliser une compression visuellement sans perte au lieu d’une véritable compression sans perte pour les graphiques. La compression visuellement sans perte améliore les performances par rapport à la véritable compression sans perte, mais présente une perte mineure imperceptible à l’œil. Ce paramètre modifie la façon dont les valeurs du paramètre Qualité visuelle sont utilisées.

La stratégie Autoriser la compression visuellement sans perte est désactivée par défaut. Pour activer la compression visuellement sans perte, définissez Autoriser la compression visuellement sans perte sur Activé et la stratégie Qualité visuelle sur Construire sans perte.

Si la stratégie Utiliser le codec vidéo pour la compression est définie sur Ne pas utiliser le codec vidéo, la compression visuellement sans perte s’applique à l’encodage d’images statiques. Si la stratégie Utiliser le codec vidéo pour la compression est définie sur un mode graphique autre que Ne pas utiliser le codec vidéo, la compression visuellement sans perte s’applique à l’encodage H.264.

Pour plus d’informations sur les paramètres de stratégie Qualité visuelle et Utiliser le codec vidéo pour la compression, consultez Paramètres de stratégie d’affichage visuel et Paramètres de stratégie graphique.

Curseur de qualité graphique

Nous avons inclus un curseur de qualité graphique dans l’outil d’indicateur d’état graphique qui s’exécute dans vos sessions Linux virtuelles. Le curseur permet de trouver le bon équilibre entre la qualité d’image et l’interactivité.

Pour utiliser le curseur, suivez les étapes suivantes :

Activez la stratégie Indicateur d’état graphique dans Citrix Studio.

La politique d'indicateur d'état graphique

Ouvrez le Terminal et exécutez la commande ctxslider. L’interface utilisateur du curseur apparaît.
Remarque :
- Si vous avez défini la stratégie Qualité visuelle sur Toujours sans perte ou Générer sans perte, l’interface utilisateur du curseur ne s’affiche pas.
- Vous pouvez lancer l’interface utilisateur du curseur à partir du Terminal et de la zone de notification.
Les choix suivants sont désormais disponibles :
- Pour modifier la qualité d’image, déplacez le curseur. Le curseur prend en charge une plage de 0 à 9.
- Pour utiliser les paramètres définis par le système, sélectionnez Laisser le système décider.
- Pour passer en mode sans perte, sélectionnez Pixel parfait.

Ajuster les débits binaires moyens en fonction des estimations de bande passante

Citrix améliore l’encodage matériel HDX™ 3D Pro en ajustant les débits binaires moyens en fonction des estimations de bande passante.

Lorsque l’encodage matériel HDX 3D Pro est utilisé, le VDA peut estimer par intermittence la bande passante du réseau et ajuster les débits binaires des trames encodées en conséquence. Cette nouvelle fonctionnalité offre un mécanisme pour équilibrer la netteté et la fluidité.

Cette fonctionnalité est activée par défaut. Pour la désactiver, exécutez la commande suivante :

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "DisableReconfigureEncoder" -d "0x00000001" --force
<!--NeedCopy-->

En plus d’utiliser cette fonctionnalité, vous pouvez également exécuter les commandes suivantes pour ajuster la netteté et la fluidité. Les paramètres AverageBitRatePercent et MaxBitRatePercent définissent le pourcentage d’utilisation de la bande passante. Plus les valeurs que vous définissez sont élevées, plus les graphiques sont nets et moins la fluidité est bonne. La plage de réglage recommandée est de 50 à 100.

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AverageBitRatePercent" -d "90" --force

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "MaxBitRatePercent" -d "100" --force
<!--NeedCopy-->

Lors de l’ajustement du débit binaire moyen, lorsque votre écran reste immobile, la trame la plus récente reste dans un état de faible qualité car aucune nouvelle trame n’est envoyée. La prise en charge de l’accentuation peut résoudre ce problème en reconfigurant et en envoyant immédiatement la trame la plus récente avec la plus haute qualité.

Pour une liste complète des stratégies prises en charge par Thinwire du VDA Linux, consultez Liste de prise en charge des stratégies.

Pour plus d’informations sur la configuration de la prise en charge de plusieurs moniteurs sur le VDA Linux, consultez CTX220128.

Traitement parallèle

Thinwire peut améliorer le nombre d’images par seconde (FPS) en parallélisant certaines tâches, avec une légère augmentation de la consommation globale du processeur. Cette fonctionnalité est désactivée par défaut. Pour l’activer, exécutez la commande suivante sur votre VDA :

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "ParallelProcessing" -d "0x00000001" --force
<!--NeedCopy-->

Dépannage

Vérifier le mode graphique utilisé

Exécutez la commande suivante pour vérifier le mode graphique utilisé (0 signifie TW+. 1 signifie codec vidéo plein écran) :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep GraphicsMode
<!--NeedCopy-->

Le résultat ressemble à :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "GraphicsMode" -d "0x00000000" --force

Vérifier que le H.264 est utilisé

Exécutez la commande suivante pour vérifier que le H.264 est utilisé (0 signifie non utilisé. 1 signifie utilisé) :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep H264
<!--NeedCopy-->

Par exemple, le résultat peut ressembler à :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H264" -d "0x00000000" --force

Vérifier que le H.265 est utilisé

Exécutez la commande suivante pour vérifier que le H.265 plein écran est utilisé (0 signifie non utilisé. 1 signifie utilisé) :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep H265
<!--NeedCopy-->

Par exemple, le résultat peut ressembler à :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H265" -d "0x00000000" --force

Vérifier le schéma d’encodage YUV utilisé

Exécutez la commande suivante pour vérifier le schéma d’encodage YUV utilisé (0 signifie YUV420. 1 signifie YUV422. 2 signifie YUV444) :

Remarque :

La valeur de YUVFormat n’est significative que lorsqu’un codec vidéo est utilisé.

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep YUVFormat
<!--NeedCopy-->

Par exemple, le résultat peut ressembler à :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "YUVFormat" -d "0x00000000" --force

Vérifier que l’encodage logiciel YUV444 est utilisé

Exécutez la commande suivante pour vérifier que l’encodage logiciel YUV444 est utilisé :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep Graphics
<!--NeedCopy-->

Lorsque YUV444 est utilisé, le résultat ressemble à ceci :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "GraphicsMode" -d "0x00000001" --force

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H264" -d "0x00000001" --force

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000000" --force

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "YUVFormat" -d "0x00000002" --force

Vérifier que HDX 3D Pro est activé

Exécutez les commandes suivantes pour vérifier que HDX 3D Pro est activé :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep ProductEdition

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep StackSessionMode

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep 3DPro
<!--NeedCopy-->

Lorsque HDX 3D Pro est activé, le résultat ressemble à ceci :

create -k "HKLM\Software\Citrix\VirtualDesktopAgent\State" -t "REG_SZ" -v "ProductEdition" -d "<PLT or ENT>" --force

create -k "HKLM\System\CurrentControlSet\Control\Citrix\WinStations\tcp" -t "REG_DWORD" -v "StackSessionMode" -d "0x00000000" --force

create -k "HKLM\System\CurrentControlSet\Control\Citrix" -t "REG_DWORD" -v "3DPro" -d "0x00000000" --force

Pour vérifier que les bibliothèques NVIDIA requises sont chargées pour HDX 3D Pro, exécutez la commande nvidia-smi sur le VDA Linux. Le résultat ressemble à ceci :

Tue Apr 12 10:42:03 2016
+------------------------------------------------------+
| NVIDIA-SMI 361.28     Driver Version: 361.28         |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  GRID K1             Off  | 0000:00:05.0     Off |                  N/A |
| N/A   42C    P0    14W /  31W |    207MiB /  4095MiB |      8%      Default |
+-------------------------------+----------------------+----------------------+

+-----------------------------------------------------------------------------+
| Processes:                                                       GPU Memory |
|  GPU       PID  Type  Process name                               Usage      |
|=============================================================================|
|    0      2164  C+G   /usr/local/bin/ctxgfx                          106MiB |
|    0      2187    G   Xorg                                            85MiB |
+-----------------------------------------------------------------------------+
<!--NeedCopy-->

Vérifier que l’encodage matériel est utilisé pour 3D Pro

Exécutez la commande suivante (0 signifie non utilisé. 1 signifie utilisé) :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep HardwareEncoding
<!--NeedCopy-->

Lorsque 3D Pro est utilisé, le résultat ressemble à ceci :

create -k "HKLM\Software\Citrix\Ica\Session\1\Graphics" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000001" --force

Vérifier que le pilote graphique NVIDIA GRID est correctement installé

Pour vérifier que le pilote graphique NVIDIA GRID est correctement installé, exécutez nvidia-smi. Le résultat ressemble à ceci :

+------------------------------------------------------+
| NVIDIA-SMI 352.70     Driver Version: 352.70         |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  Tesla M60           Off  | 0000:00:05.0     Off |                  Off |
| N/A   20C    P0    37W / 150W |     19MiB /  8191MiB |      0%      Default |
+-------------------------------+----------------------+----------------------+

+-----------------------------------------------------------------------------+
| Processes:                                                       GPU Memory |
|  GPU       PID  Type  Process name                               Usage      |
|=============================================================================|
|  No running processes found                                                 |
+-----------------------------------------------------------------------------+
<!--NeedCopy-->

Définissez la configuration correcte pour la carte :

etc/X11/ctx-nvidia.sh

Problèmes de redessin multi-écrans avec HDX 3D Pro

Si vous rencontrez des problèmes de redessin sur des écrans autres que le moniteur principal, vérifiez que la licence NVIDIA GRID est disponible.

Vérifier les journaux d’erreurs Xorg

Le fichier journal de Xorg est nommé de manière similaire à Xorg.{DISPLAY}.log dans le dossier /var/log/.

Problèmes connus et limitations

Pour vGPU, la console locale de Citrix Hypervisor™ affiche l’écran de session de bureau ICA

Solution de contournement : Désactivez la console VGA locale de la VM en exécutant les commandes suivantes :

Pour Citrix Hypervisor 8.1 et versions ultérieures :

[root@xenserver® ~]# xe vgpu-param-set uuid=vgpu-uuid extra_args=disable_vnc=1
<!--NeedCopy-->

Pour Citrix Hypervisor antérieur à 8.1 :

xe vm-param-set uuid=<vm-uuid> platform:vgpu_extra_args="disable_vnc=1"
<!--NeedCopy-->

Les fenêtres contextuelles du bureau Gnome 3 sont lentes lors de la connexion

Il s’agit d’une limitation du démarrage de la session de bureau Gnome 3.

Certaines applications OpenGL/WebGL ne s’affichent pas correctement lors du redimensionnement de la fenêtre de l’application Citrix Workspace

Le redimensionnement de la fenêtre de l’application Citrix Workspace modifie la résolution de l’écran. Le pilote propriétaire NVIDIA modifie certains états internes et peut exiger que les applications réagissent en conséquence. Par exemple, l’élément de bibliothèque WebGL lightgl.js peut générer une erreur indiquant que le rendu vers cette texture n’est pas pris en charge (tampon de trame incomplet).

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Cloud Software Group à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Cloud Software Group, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Configuration et optimisation graphiques

April 10, 2026

Contributeur:

C C

April 10, 2026

Contributeur:

C C