Grafiken konfigurieren

Last published : Nov 13, 2026
Dieser Artikel enthält Anleitungen zur Grafikkonsfiguration und Feinabstimmung des Linux VDA.
Weitere Informationen finden Sie unter Systemanforderungen und im Abschnitt Installationsübersicht.

Konfigurationsparameter

Es gibt mehrere grafikbezogene Konfigurationsparameter unter HKEY\_LOCAL\_MACHINE\System\CurrentControlSet\Control\Citrix\Thinwire, die Sie mit dem Dienstprogramm ctxreg optimieren können.

Thinwire Plus aktivieren

Thinwire Plus ist standardmäßig aktiviert, sowohl für Standard-VDA als auch für 3D Pro.

H.264 aktivieren

Zusätzlich zur Betriebssystemanforderung hat H.264 eine Mindestanforderung an die Version der Citrix Workspace-App (früher Citrix Receiver). Wenn der Client die Anforderungen nicht erfüllt, wird auf Thinwire Plus zurückgegriffen.
Betriebssystem Mindestanforderung für H.264
Windows 3.4 oder höher
Mac OS X 11.8 oder höher
Linux 13.0 oder höher
Android 3.5
iOS 5.9
Chrome OS 1.4
Die neueste Feature-Matrix für die Citrix Workspace-App ist unter <https://docs.citrix.com/de-de/citrix-workspace-app/citrix-workspace-app-feature-matrix.html> verfügbar.
Führen Sie den folgenden Befehl aus, um die H.264-Kodierung auf dem VDA zu bewerben:
sudo ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AdvertiseH264" -d "0x00000001" --force

So aktivieren Sie die Hardwarekodierung in HDX™ 3D Pro

Für HDX 3D Pro aktiviert die Einstellung AdvertiseH264 nur die Software-H.264-Kodierung. Führen Sie den folgenden Befehl aus, um die Hardwarekodierung zu aktivieren:
sudo ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000001" --force
Hinweis:
Wenn Sie den Fehler ctxreg command can't be found erhalten, verwenden Sie den Befehl ctxreg mit einem vollständigen Pfad. Verwenden Sie beispielsweise sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AdvertiseH264" -d "0x00000001" –force anstelle von sudo ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AdvertiseH264" -d "0x00000001" –force.

So optimieren Sie Thinwire Plus für geringere Bandbreite

  • MaxColorDepth
    Default 0x20, type DWORD
    Diese Option gibt die Farbtiefe der Grafiken an, die über das Thinwire-Protokoll an den Client übertragen werden.
    Um Bandbreite zu sparen, setzen Sie ihn auf 0x10 (was die bevorzugte Farbtiefe für einfache Grafiken darstellt) oder auf 0x8 (den experimentellen Modus für geringe Bandbreite).
  • Qualität
    Visuelle Qualität
    Default: 0x1(medium), type: DWORD, valid values: 0x0(low), 0x1(medium), 0x2(high), 0x3(build to lossless), 0x4 always lossless.
    Um Bandbreite zu sparen, setzen Sie Quality auf 0x0(low).
  • Weitere Parameter
    • TargetFPS
      Zielbildrate
      Default: 0x1e (30), Type: DWORD
    • MinFPS
      Ziel-Mindestbildrate
      Default: 0xa (10), Type: DWORD
    • MaxScreenNum
      Maximale Anzahl von Monitoren, die der Client haben kann
      Default: 0x2, Type: DWORD
      Für einen Standard-VDA können Sie einen Maximalwert von bis zu 10 festlegen. Für 3D Pro beträgt der maximal zulässige Wert 4.

Problembehandlung

Prüfen, welche Kodierung verwendet wird

Führen Sie den folgenden Befehl aus, um zu prüfen, ob die H.264-Kodierung verwendet wird (1 bedeutet H.264; 0 bedeutet TW+):
sudo ctxreg dump | grep H264
Die Ergebnisse sehen wie folgt aus:
create -k "HKLM\Software\Citrix\Ica\Session\1\Graphics" -t "REG_DWORD" -v "H264" -d "0x00000001" --force
create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AdvertiseH264" -d "0x00000001" --force

Prüfen, ob Hardwarekodierung für 3D Pro verwendet wird

Führen Sie den folgenden Befehl aus (0 bedeutet nicht in Gebrauch; 1 bedeutet in Gebrauch):
sudo /opt/Citrix/VDA/bin/ctxreg dump | grep HardwareEncoding
Die Ergebnisse sehen wie folgt aus:
create -k "HKLM\Software\Citrix\Ica\Session\1\Graphics" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000001" --force
Eine andere Möglichkeit ist die Verwendung des Befehls nvidia-smi. Die Ausgaben sehen wie folgt aus, wenn die Hardwarekodierung verwendet wird:
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 |
+-----------------------------------------------------------------------------+

Überprüfen, ob der NVIDIA GRID-Grafiktreiber korrekt installiert ist

Um zu überprüfen, ob der NVIDIA GRID-Grafiktreiber korrekt installiert ist, führen Sie nvidia-smi aus. Die Ergebnisse sehen wie folgt aus:
+------------------------------------------------------+
| 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                                                 |
+-----------------------------------------------------------------------------+
Legen Sie die korrekte Konfiguration für die Karte fest:
etc/X11/ctx-nvidia.sh

HDX 3D Pro Probleme beim Neuzeichnen auf mehreren Monitoren

Wenn Sie Neuzeichnungsprobleme auf anderen Bildschirmen als dem primären Monitor feststellen, prüfen Sie, ob die NVIDIA GRID-Lizenz verfügbar ist.

Xorg-Fehlerprotokolle prüfen

Die Protokolldatei von Xorg heißt ähnlich wie Xorg.{DISPLAY}.log im Ordner /var/log/.

Bekannte Probleme und Einschränkungen

Bei vGPU zeigt die lokale XenServer®-Konsole den ICA-Desktopsitzungsbildschirm an

Problemumgehung: Deaktivieren Sie die lokale VGA-Konsole der VM, indem Sie den folgenden Befehl ausführen:
xe vm-param-set uuid=<vm-uuid> platform:vgpu_extra_args="disable_vnc=1"

NVENC API wird in anderen vGPU-Profilen als 8Q nicht unterstützt

NVIDIA Tesla M60-Karten-vGPU-Profile, die nicht 8Q sind, unterstützen kein cuda. Daher sind NVENC API und Citrix® 3D Pro Hardware-Kodierung nicht verfügbar.

NVIDIA K2-Grafikkarten unterstützen keine YUV444-Hardwarekodierung im Pass-Through-Modus

Dies ist eine Einschränkung von NVIDIA K2-Grafikkarten.

Gnome 3-Desktop-Popups sind beim Anmelden langsam

Dies ist eine Einschränkung des Gnome 3-Desktop-Sitzungsstarts.

Einige OpenGL/WebGL-Anwendungen werden beim Ändern der Größe des Citrix Receiver-Fensters nicht richtig gerendert

Das Ändern der Größe des Citrix Receiver-Fensters ändert die Bildschirmauflösung. Der proprietäre NVIDIA-Treiber ändert einige interne Zustände und erfordert möglicherweise, dass Anwendungen entsprechend reagieren. Zum Beispiel könnte das WebGL-Bibliothekselement lightgl.js einen Fehler auslösen, der besagt, dass 'Rendering to this texture is not supported (incomplete frame buffer)'.