USB-Umleitung konfigurieren

USB-Geräte werden zwischen der Citrix Workspace™-App und dem Linux VDA-Desktop gemeinsam genutzt. Wenn ein USB-Gerät auf den Desktop umgeleitet wird, kann der Benutzer das USB-Gerät so verwenden, als wäre es lokal verbunden.

| > | **Tipp:** | | |

• Wir empfehlen die Verwendung der USB-Umleitung, wenn die Netzwerklatenz weniger als 100 Millisekunden beträgt. Verwenden Sie die USB-Umleitung nicht, wenn die Netzwerklatenz mehr als 200 Millisekunden beträgt.

• Die USB-Umleitung umfasst drei Hauptfunktionsbereiche:

• Implementierung des Open-Source-Projekts (VHCI)
• VHCI-Dienst
• USB-Dienst

Open-Source VHCI:

Dieser Teil der USB-Umleitungsfunktion entwickelt ein allgemeines USB-Gerätefreigabesystem über ein IP-Netzwerk. Es besteht aus einem Linux-Kernel-Treiber und einigen Benutzermodus-Bibliotheken, die die Kommunikation mit dem Kernel-Treiber ermöglichen, um alle USB-Daten zu erhalten. In der Linux VDA-Implementierung verwendet Citrix den Kernel-Treiber von VHCI wieder. Alle USB-Datenübertragungen zwischen dem Linux VDA und der Citrix Workspace-App werden jedoch im Citrix ICA®-Protokollpaket gekapselt.

VHCI-Dienst:

Der VHCI-Dienst ist ein von Citrix bereitgestellter Open-Source-Dienst zur Kommunikation mit dem VHCI-Kernelmodul. Dieser Dienst fungiert als Gateway zwischen VHCI und dem Citrix USB-Dienst.

USB-Dienst:

Der USB-Dienst stellt ein Citrix-Modul dar, das die gesamte Virtualisierung und Datenübertragung auf dem USB-Gerät verwaltet.

Funktionsweise der USB-Umleitung

Typischerweise werden, wenn ein USB-Gerät erfolgreich auf den Linux VDA umgeleitet wird, ein oder mehrere Geräteknoten im Systempfad /dev erstellt. Manchmal ist das umgeleitete Gerät jedoch für eine aktive Linux VDA-Sitzung nicht nutzbar. USB-Geräte sind auf Treiber angewiesen, um ordnungsgemäß zu funktionieren, und einige Geräte erfordern spezielle Treiber. Wenn keine Treiber bereitgestellt werden, sind die umgeleiteten USB-Geräte für die aktive Linux VDA-Sitzung unzugänglich. Um die USB-Gerätekonnektivität sicherzustellen, installieren Sie die Treiber und konfigurieren Sie das System ordnungsgemäß.

Der Linux VDA unterstützt eine Liste von USB-Geräten, die erfolgreich zum und vom Client umgeleitet werden. Darüber hinaus wird das Gerät, insbesondere die USB-Festplatte, ordnungsgemäß gemountet, sodass der Benutzer ohne zusätzliche Konfiguration auf die Festplatte zugreifen kann.

Unterstützte USB-Geräte

Die folgenden Geräte wurden für die Unterstützung dieser Version des Linux VDA verifiziert. Andere Geräte können frei verwendet werden, mit unerwarteten Ergebnissen: | Column 1 | Column 2 | | | > | **Hinweis:** | | | | | | |

Der Linux VDA unterstützt nur USB 2.0-Protokolle.

USB-Umleitung konfigurieren

Eine Citrix-Richtlinie steuert, ob die USB-Geräteumleitung aktiviert oder deaktiviert ist. Darüber hinaus kann der Gerätetyp auch über eine Delivery Controller™-Richtlinie angegeben werden. Beim Konfigurieren der USB-Umleitung für den Linux VDA konfigurieren Sie die folgende Richtlinie und Regeln:

• Client-USB-Geräteumleitungsrichtlinie
• Client-USB-Geräteumleitungsregeln

USB-Umleitungsrichtlinie aktivieren

Aktivieren (oder deaktivieren) Sie in Citrix Studio die USB-Geräteumleitung zum und vom Client (nur für Workstation-Hosts).

Im Dialogfeld Einstellung bearbeiten:

1. Wählen Sie Zulässig.
2. Klicken Sie auf OK.

USB-Umleitungsregeln festlegen

Nachdem Sie die USB-Umleitungsrichtlinie aktiviert haben, legen Sie die Umleitungsregeln mit Citrix Studio fest, indem Sie angeben, welche Geräte auf dem Linux VDA zugelassen (oder verweigert) werden.

Im Dialogfeld Client-USB-Geräteumleitungsregeln:

1. Klicken Sie auf Neu, um eine Umleitungsregel hinzuzufügen, oder klicken Sie auf Bearbeiten, um eine vorhandene Regel zu überprüfen.
2. Nachdem Sie eine Regel erstellt (oder bearbeitet) haben, klicken Sie auf OK.

VHCI-Kernelmodul erstellen

Die USB-Umleitung hängt von den VHCI-Kernelmodulen (usb-vhci-hcd.ko und usb-vhci-iocif.ko) ab. Diese Module sind Teil der Linux VDA-Distribution (als Teil des RPM-Pakets). Sie werden basierend auf den offiziellen Linux-Distributions-Kerneln kompiliert und sind in der folgenden Tabelle aufgeführt:

Wichtig:

Wenn der Kernel Ihres Computers nicht mit dem für den Linux VDA erstellten Treiber kompatibel ist, kann der USB-Dienst möglicherweise nicht gestartet werden. In diesem Fall können Sie die USB-Umleitungsfunktion nur verwenden, wenn Sie Ihre eigenen VHCI-Kernelmodule erstellen.

Überprüfen, ob Ihr Kernel mit den von Citrix erstellten Modulen konsistent ist

Führen Sie in der Befehlszeile den folgenden Befehl aus, um zu überprüfen, ob der Kernel konsistent ist:

insmod /opt/Citrix/VDA/lib64/usb-vhci-hcd.ko
<!--NeedCopy-->

Wenn der Befehl erfolgreich ausgeführt wird, wurde das Kernelmodul erfolgreich geladen und die Version ist mit der von Citrix installierten konsistent.

Wenn der Befehl mit Fehlern ausgeführt wird, ist der Kernel inkonsistent mit dem Citrix-Modul und muss neu erstellt werden.

VHCI-Kernelmodul neu erstellen

Wenn Ihr Kernelmodul inkonsistent mit der Citrix-Version ist, gehen Sie wie folgt vor:

1. Laden Sie den LVDA-Quellcode von der Citrix Download-Website herunter. Wählen Sie die Datei im Abschnitt „Linux Virtual Delivery Agent (Quellen)“ aus.

2. Entpacken Sie die Datei citrix-linux-vda-sources.zip. Navigieren Sie zu linux-vda-souces/vhci-hcd-1.15.tar.bz2 und entpacken Sie die VHCI-Quelldateien mit tar xvf vhci-hcd-1.15.tar.bz2.

3. Erstellen Sie das Kernelmodul basierend auf den Header-Dateien und der Datei Module.symvers. Verwenden Sie die folgenden Schritte, um die Kernel-Header-Dateien zu installieren und Module.symvers basierend auf der entsprechenden Linux-Distribution zu erstellen:

   RHEL/CentOS:

   yum install kernel-devel
   <!--NeedCopy-->
   

   SUSE 12:

   
   -  zypper install kernel-devel
   
   zypper install kernel-source
   
   <!--NeedCopy-->
   

   Ubuntu:

   
   -  apt-get install linux-headers
   
   <!--NeedCopy-->
   

   Tipp:

   Wenn die Installation erfolgreich ist, gibt es einen Kernel-Ordner, der dem folgenden ähnelt:

   /usr/src/kernels/3.10.0-327.10.1.el7.x86_64

4. Überprüfen Sie im Ordner /usr/src/kernels/3.10.0-327.10.1.el7.x86_64, ob die Datei Module.symvers vorhanden ist. Wenn diese Datei nicht im Ordner vorhanden ist, erstellen Sie den Kernel (indem Sie die folgenden Befehle nacheinander ausführen: make oldconfig; make prepare; make modules; make), um diese Datei zu erhalten, oder kopieren Sie sie von /usr/src/kernels/3.10.0-327.10.1.el7.x86_64-obj/x86_64/defaults/module.*

5. Führen Sie die folgenden Befehle aus, um die Entwicklungstools zu installieren.

   RHEL 8, CentOS 8:

   
   -  yum groupinstall 'Development Tools'
   
   yum install elfutils-libelf-devel
   
   <!--NeedCopy-->
   

   RHEL 7, CentOS 7:

   
   yum groupinstall 'Development Tools'
   
   <!--NeedCopy-->
   

   Ubuntu 20.04, Ubuntu 18.04, Debian 10:

   
   apt install build-essential flex bison libelf-dev
   
   <!--NeedCopy-->
   

   Ubuntu 16.04:

   
   apt install build-essential flex bison
   
   <!--NeedCopy-->
   

6. Ändern Sie in der Datei vhci-hcd-1.15/Makefile das Makefile von VCHI und setzen Sie KDIR auf das Kernelverzeichnis:

   #KDIR = $(BUILD_PREFIX)/lib/modules/$(KVERSION)/build
   
   KDIR = /usr/src/kernels/3.10.0-327.10.1.el7.x86_64
   <!--NeedCopy-->
   

7. Führen Sie im Ordner vhci-hcd-1.15/ den Befehl make aus, um den VHCI-Kernel zu erstellen.

   Hinweis:

   Wenn der Build erfolgreich war, werden usb-vhci-hcd.ko und usb-vhci-iocifc.ko im Ordner vhci-hcd-1.15/ erstellt.

8. Ersetzen Sie das Kernelmodul durch das neu erstellte: cp -f usb-vhci-*.ko /opt/Citrix/VDA/lib64/

9. Starten Sie den USB-Dienst neu:

   service ctxusbsd restart
   <!--NeedCopy-->
   

10. Melden Sie sich von der Sitzung ab und wieder an. Überprüfen Sie, ob die USB-Umleitung funktioniert.

Beheben von Problemen beim Kernel-Build

Die folgenden Fehler können auftreten, wenn Sie das VHCI-Modul mit bestimmten Kerneln erstellen:

• Der Fehler implicit declaration of function 'copy\_to\_user' kann auftreten, siehe folgenden Screenshot:

  

  Der Fehler tritt aufgrund von Header-Dateiänderungen in den Kerneln auf. Als Workaround fügen Sie die Zeile #include <linux/uaccess.h> zur Datei vhci-hcd-1.15/usb-vhci-iocifc.c hinzu.

  

• Der Fehler 'driver\_attr\_debug_output' undeclared kann auftreten, siehe folgenden Screenshot:

  

  Der Fehler tritt auf, wenn Symbole im Kernel fehlen. Als Workaround deaktivieren Sie die Makrodefinition für DEBUG in den Dateien vhci-hcd-1.15/usb-vhci-iocifc.c und vhci-hcd-1.15/usb-vhci-hcd.c.

  

• Der Fehler 'make[3]: *** No rule to make target 'arch/x86/tools/relocs_32.c', needed by 'arch/x86/tools/relocs_32.o'. Stop. kann auftreten, siehe folgenden Screenshot:

  

  Als Workaround ersetzen Sie SUBDIRS=$(PWD) durch M=$(shell pwd) mit den folgenden Befehlen unter dem Pfad vhci-hcd-1.15/:

   sed -i 's/SUBDIRS=$(PWD)/M=$(shell pwd)/g' Makefile
  
   sed -i 's/SUBDIRS=$(PWD)/M=$(shell pwd)/g' test/Makefile
   <!--NeedCopy-->
  

• Der Fehler ./include/uapi/linux/stat.h:30:17: error: expected ')' before numeric constant #define S_IRUSR 00400 kann auftreten, siehe folgenden Screenshot:

  

  Führen Sie die folgenden Befehle aus, um das Problem zu umgehen:

   sed -i 's/show_debug_output/debug_output_show/g' usb-vhci-iocifc.c usb-vhci-hcd.c  
  
   sed -i 's/store_debug_output/debug_output_store/g' usb-vhci-iocifc.c usb-vhci-hcd.c  
  
   sed -i 's/static DRIVER_ATTR(debug_output, S_IRUSR | S_IWUSR, debug_output_show, debug_output_store);/static DRIVER_ATTR_RW(debug_output);/g' usb-vhci-iocifc.c usb-vhci-hcd.c
   <!--NeedCopy-->
  

• Der Fehler ./arch/x86/include/asm/uaccess.h:433:29: error: invalid initializer __typeof__(ptr) __pu_ptr = (ptr); \ kann auftreten, siehe folgenden Screenshot:

  

  Als Workaround ändern Sie die Zeile 219 der Datei usb-vhci-iocifc.c von __put_user('\0', arg->bus_id); in __put_user('\0', arg->bus_id + 0);.

• Der Fehler error: 'access_ok' undeclared (first use in this function) if(unlikely((_IOC_DIR(cmd) & _IOC_READ) && !access_ok(VERIFY_WRITE, arg, _IOC_SIZE(cmd)))) kann auftreten, siehe folgenden Screenshot:

  

  Führen Sie die folgenden Befehle aus, um das Problem zu umgehen:

   sed -i 's/VERIFY_READ, //g' usb-vhci-iocifc.c  
   sed -i 's/VERIFY_WRITE, //g' usb-vhci-iocifc.c
   <!--NeedCopy-->
  

Beheben von Problemen bei der USB-Umleitung

Verwenden Sie die Informationen in diesem Abschnitt, um verschiedene Probleme zu beheben, die bei der Verwendung des Linux VDA auftreten können.

USB-Datenträger kann nicht ausgeworfen werden

Für die Zugriffssteuerung aller von der Citrix Workspace-App umgeleiteten USB-Datenträger verwaltet der Linux VDA alle diese Geräte mit Administratorrechten, um sicherzustellen, dass nur der Besitzer auf das umgeleitete Gerät zugreifen kann. Folglich kann der Benutzer das Gerät ohne Administratorrechte nicht auswerfen.

Datei geht verloren, wenn die Umleitung eines USB-Datenträgers beendet wird

Wenn Sie einen USB-Datenträger an eine Sitzung umleiten und versuchen, ihn zu ändern (z. B. Dateien auf dem Datenträger zu erstellen), und dann die Umleitung sofort über die Symbolleiste der Citrix Workspace-App beenden, kann die geänderte oder erstellte Datei verloren gehen. Dieses Problem tritt auf, weil beim Schreiben von Daten in ein Dateisystem das System den Speicher-Cache im Dateisystem einbindet. Die Daten werden nicht direkt auf den Datenträger geschrieben. Wenn Sie die Umleitung über die Symbolleiste der Citrix Workspace-App beenden, bleibt keine Zeit mehr, die Daten auf den Datenträger zu schreiben, was zu Datenverlust führt. Um dieses Problem zu beheben, verwenden Sie den Befehl sync in einem Terminal, um Daten auf den Datenträger zu schreiben, bevor Sie die USB-Umleitung beenden.

Keine Geräte in der Symbolleiste der Citrix Workspace-App

Manchmal werden in der Symbolleiste der Citrix Workspace-App keine Geräte angezeigt, was darauf hindeutet, dass keine USB-Umleitung stattfindet. Wenn dieses Problem auftritt, überprüfen Sie Folgendes:

• Die Richtlinie ist so konfiguriert, dass die USB-Umleitung zugelassen wird.
• Das Kernelmodul ist mit Ihrem Kernel kompatibel.

Hinweis:

Die Registerkarte Geräte ist in der Citrix Workspace-App für Linux nicht verfügbar.

Fehlgeschlagene Umleitung, wenn USB-Geräte in der Symbolleiste der Citrix Workspace-App sichtbar sind, aber als richtlinienbeschränkt gekennzeichnet sind

Wenn das Problem auftritt, gehen Sie wie folgt vor:

• Konfigurieren Sie die Linux VDA-Richtlinie, um die Umleitung zu aktivieren.

• Überprüfen Sie, ob zusätzliche Richtlinieneinschränkungen in der Registrierung der Citrix Workspace-App konfiguriert sind. Überprüfen Sie DeviceRules im Registrierungspfad, um sicherzustellen, dass der Zugriff auf das Gerät durch diese Einstellung nicht verweigert wird:

  HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\GenericUSB

Ein USB-Gerät wird erfolgreich umgeleitet, kann aber in meiner Sitzung nicht verwendet werden

Typischerweise können nur unterstützte USB-Geräte umgeleitet werden. Andere Geräte können ebenfalls an eine aktive Linux VDA-Sitzung umgeleitet werden. Für jedes umgeleitete Gerät wird ein dem Benutzer gehörender Knoten im Systempfad /dev erstellt. Es sind jedoch die Treiber und die Konfiguration, die bestimmen, ob der Benutzer das Gerät erfolgreich verwenden kann. Wenn Sie ein Gerät finden, das zwar angeschlossen (besessen) ist, aber nicht zugänglich ist, fügen Sie das Gerät einer uneingeschränkten Richtlinie hinzu.

Hinweis:

Bei USB-Laufwerken konfiguriert und mountet der Linux VDA den Datenträger. Der Benutzer (und nur der Besitzer, der ihn installiert hat) kann ohne zusätzliche Konfiguration auf den Datenträger zugreifen. Dies ist möglicherweise nicht der Fall für Geräte, die nicht in der Liste der unterstützten Geräte aufgeführt sind.