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 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_PRO sur Y lors 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é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.

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 :

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

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 :

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

GPU non virtualisés