Linux Virtual Delivery Agent

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 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 en définissant CTX_XDL_HDX_3D_PRO sur Y lors de l’installation du Linux VDA. 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.

Compatibilité 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 le codage logiciel est pris en charge.

Étape 1 : définissez CTX_XDL_HDX_3D_PRO sur Y lors de l’installation du 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.

Étape 2 : installez Xdamage

Par exemple, vous pouvez exécuter sudo apt-get install -y libxdamage1 pour installer XDamage sur Ubuntu 20.04. En règle générale, XDamage existe sous forme d’extension de XServer.

Étape 3 : activez 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 dans /etc/X11. En fonction du nombre de moniteurs connectés, modifiez l’un des fichiers de configuration de modèle avec le nombre correspondant dans son nom. Par exemple, si un seul moniteur est connecté, modifiez le fichier de configuration de modèle dont le nom comporte le chiffre 1, c’est-à-dire ctx-driver_name-1.conf. Si deux moniteurs sont connectés, modifiez le fichier de configuration de modèle dont le nom contient le chiffre 2, 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 utilisant ctx-driver_name-1.conf en tant qu’exemple, suivez la procédure suivante pour modifier les fichiers de configuration de modèle :

  1. 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 pour ctx-intel-1.conf.

  2. 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 :

    1. 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.

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

  3. 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-->
    

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.

La fonction est désactivée par défaut. Pour l’activer, procédez comme suit :

  1. Installez le package evdi-dkms basé sur votre distribution Linux :

    sudo apt install evdi-dkms
    <!--NeedCopy-->
    
  2. 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-->
    
  3. Si vous utilisez un GPU Intel, désactivez le gestionnaire d’affichage. Dans le cas contraire, le gestionnaire d’affichage occupe et rend le GPU Intel indisponible 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.