Linux Virtual Delivery Agent

Nicht-virtualisierte GPUs

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

  • GPUs, die in Remote-PC-Zugriffsszenarien 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 vom NVIDIA Linux Capture SDK unterstützt werden, ist die Hardwarebeschleunigung nach der Aktivierung von HDX 3D Pro standardmäßig aktiviert. Es ist keine zusätzliche Konfiguration erforderlich.
  • Für GPUs, die vom NVIDIA Linux Capture SDK nicht unterstützt werden, 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

Verwenden Sie ctx-driver_name-1.conf als Beispiel und führen Sie die folgenden Schritte aus, um die Vorlagen-Konfigurationsdateien zu ändern:

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

    Wenn Ihr Treibername beispielsweise intel ist, 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 vom GPU-Hersteller bereitgestellte Anleitung für Konfigurationsinformationen. Eine native Konfigurationsdatei kann generiert werden. Überprüfen Sie, ob 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 festzulegen, 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-->

Monitorabschaltung für Remote-PC-Zugriff-VDAs

Der Linux VDA unterstützt die physische Monitorabschaltung für Remote-PC-Zugriff-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 entsprechend Ihrer Linux-Distribution:

    sudo apt install evdi-dkms
    <!--NeedCopy-->
    
  2. Aktivieren Sie die Auslagerung der Grafikanzeige 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®-Remotesitzungen 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 die Fehlerbehebung zu sammeln.

Hardware-Kodierung funktioniert nicht

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

Nicht-virtualisierte GPUs