Linux Virtual Delivery Agent

Nicht-virtualisierte GPUs

  • In der Linux VDA-Dokumentation beziehen sich nicht-virtualisierte GPUs auf:

  • GPUs, die in Remote PC Access-Szenarien verwendet werden
  • GPUs, die von einem Hypervisor durchgereicht werden

  • Dieser Artikel enthält Informationen zur Aktivierung von HDX™ 3D Pro für nicht-virtualisierte GPUs.

Voraussetzungen

  • Aktivieren Sie HDX 3D Pro. Setzen Sie dazu CTX_XDL_HDX_3D_PRO bei der Installation des Linux VDA auf Y. Informationen zu Umgebungsvariablen finden Sie unter Schritt 8: Einrichten der Laufzeitumgebung zur Durchführung der Installation.
  • Für GPUs, die das NVIDIA Linux Capture SDK unterstützt, ist die Hardwarebeschleunigung nach der Aktivierung von HDX 3D Pro standardmäßig aktiviert. Es ist keine zusätzliche Konfiguration erforderlich.
  • Für GPUs, die das NVIDIA Linux Capture SDK nicht unterstützt, installieren Sie XDamage. Sie können beispielsweise sudo apt-get install -y libxdamage1 ausführen, um XDamage unter Ubuntu 20.04 zu installieren. Typischerweise existiert XDamage als Erweiterung von XServer.

  • Konfiguration

  • Xorg-Konfigurationsdateien ändern

Für nicht-virtualisierte NVIDIA GPUs

Die Konfigurationsdateien werden automatisch installiert und eingerichtet.

Für andere GPUs

Sie müssen die vier unter /etc/X11/ installierten Vorlagen-Konfigurationsdateien ändern:

  • ctx-driver_name-1.conf
  • ctx-driver_name-2.conf
  • ctx-driver_name-3.conf
  • ctx-driver_name-4.conf

Am Beispiel von ctx-driver_name-1.conf gehen Sie wie folgt vor, um die Vorlagen-Konfigurationsdateien zu ändern:

  1. Ersetzen Sie driver_name durch Ihren tatsächlichen Treibernamen.

    Wenn Ihr Treibername beispielsweise intel lautet, können Sie den Namen der Konfigurationsdatei in ctx-intel-1.conf ändern.

  2. Fügen Sie die Informationen zum Videotreiber hinzu.

    Jede Vorlagen-Konfigurationsdatei enthält einen Abschnitt namens “Device”, der auskommentiert ist. Dieser Abschnitt beschreibt die Informationen zum Videotreiber. Aktivieren Sie diesen Abschnitt, bevor Sie Ihre Videotreiberinformationen hinzufügen. So aktivieren Sie diesen Abschnitt:

    1. Beachten Sie die Anleitung des GPU-Herstellers für Konfigurationsinformationen. Eine native Konfigurationsdatei kann generiert werden. Stellen Sie sicher, dass Ihre GPU in einer lokalen Umgebung mit der nativen Konfigurationsdatei funktioniert.

    2. Kopieren Sie den Abschnitt “Device” der nativen Konfigurationsdatei in ctx-driver_name-1.conf.

  3. Führen Sie den folgenden Befehl aus, um den Registrierungsschlüssel so einzustellen, dass der Linux VDA den in Schritt 1 festgelegten Namen der Konfigurationsdatei erkennen kann.

    /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_SZ" -v "DriverName" -d "intel" --force
    <!--NeedCopy-->
    

XDamage aktivieren

Wenn Sie eine GPU verwenden, die nicht im Abschnitt zur unterstützten Hardware der Versionshinweise für das NVIDIA Linux Capture SDK aufgeführt ist, aktivieren Sie XDamage mit:

/opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_DWORD" -v "XDamageEnabled" -d "0x00000001" --force
<!--NeedCopy-->

Monitor-Blanking für Remote PC Access VDAs

Der Linux VDA unterstützt das physische Monitor-Blanking für Remote PC Access VDAs, die nicht-virtualisierte GPUs verwenden.

Vollständig getestete Linux-Distributionen, die diese Funktion unterstützen, sind Ubuntu 20.04 und Debian 11.3.

Die Funktion ist standardmäßig deaktiviert. Um sie zu aktivieren, führen Sie die folgenden zwei Schritte aus:

  1. Installieren Sie das Paket evdi-dkms basierend auf Ihrer Linux-Distribution:

    sudo apt install evdi-dkms
    <!--NeedCopy-->
    
  2. Aktivieren Sie die Auslagerung der Grafikdarstellung auf EVDI:

    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "Evdi" -d "0x00000001" --force
    <!--NeedCopy-->
    
  3. Wenn Sie eine Intel GPU verwenden, deaktivieren Sie den Display Manager. Andernfalls wird die Intel GPU vom Display Manager belegt und steht für Citrix® Remote-Sitzungen nicht zur Verfügung.

    sudo systemctl disable --now gdm
    <!--NeedCopy-->
    

Fehlerbehebung

Keine oder verzerrte Grafikausgabe

Wenn Sie 3D-Anwendungen lokal ausführen können und alle Konfigurationen korrekt sind, ist eine fehlende oder verzerrte Grafikausgabe das Ergebnis eines Fehlers. Verwenden Sie /opt/Citrix/VDA/bin/setlog und setzen Sie GFX_X11 auf verbose, um die Trace-Informationen für das Debugging zu sammeln.

Hardware-Kodierung funktioniert nicht

Wenn Sie Xdamage verwenden, wird nur Software-Kodierung unterstützt.

Nicht-virtualisierte GPUs