Redirección de dispositivos USB
Los dispositivos USB se comparten entre la aplicación Citrix Workspace™ y el escritorio de Linux VDA. Cuando un dispositivo USB se redirige al escritorio, puede usar el dispositivo USB como si estuviera conectado localmente.
Sugerencia:
Recomendamos usar la redirección de dispositivos USB cuando la latencia de la red sea inferior a 100 milisegundos. No use la redirección de dispositivos USB cuando la latencia de la red sea superior a 200 milisegundos.
La redirección de dispositivos USB incluye tres áreas principales de funcionalidad:
-
Proyecto USB/IP de código abierto
-
Módulo de sesión USB de Citrix
-
Módulo de servicio USB de Citrix
Proyecto USB/IP de código abierto:
El proyecto USB/IP consta de un controlador del kernel de Linux y algunas bibliotecas en modo de usuario que le permiten comunicarse con el controlador del kernel para obtener todos los datos USB.
El Linux VDA implementa la redirección de dispositivos USB basándose en el proyecto USB/IP de código abierto y reutiliza el controlador del kernel y las bibliotecas en modo de usuario de USB/IP. Sin embargo, todas las transferencias de datos USB entre el Linux VDA y la aplicación Citrix Workspace están encapsuladas por el protocolo USB de Citrix ICA.
Módulo de sesión USB de Citrix:
El módulo de sesión USB de Citrix actúa como un puente de comunicación entre el módulo del kernel USB/IP y la aplicación Citrix Workspace.
Módulo de servicio USB de Citrix:
El módulo de servicio USB de Citrix gestiona todas las operaciones en dispositivos USB, por ejemplo, conectar o desconectar dispositivos USB.
Cómo funciona la redirección de dispositivos USB
Normalmente, si un dispositivo USB se redirige correctamente al Linux VDA, se crean uno o más nodos de dispositivo en la ruta /dev del sistema. A veces, sin embargo, el dispositivo redirigido no se puede usar para una sesión activa de Linux VDA. Los dispositivos USB dependen de los controladores para funcionar correctamente y algunos dispositivos requieren controladores especiales. Si no se proporcionan controladores, los dispositivos USB redirigidos son inaccesibles para la sesión activa de Linux VDA. Para asegurar la conectividad del dispositivo USB, instale los controladores y configure el sistema correctamente.
El VDA de Linux admite una lista de dispositivos USB que se redirigen correctamente desde el cliente.
Dispositivos USB compatibles
Sugerencia:
Hemos añadido compatibilidad con puertos USB 3.0. Puede insertar dispositivos USB 3.0 en puertos USB 3.0 de un dispositivo cliente.
Se ha verificado que los siguientes dispositivos son compatibles con esta versión del VDA de Linux. Otros dispositivos pueden utilizarse libremente, con resultados inesperados:
| Dispositivo de almacenamiento masivo USB | VID:PID | Sistema de archivos |
|---|---|---|
Netac Technology Co., Ltd |
0dd8:173c | FAT32, NTFS |
Kingston Datatraveler 101 II |
0951:1625 | FAT32, NTFS |
Kingston Datatraveler GT101 G2 |
1567:8902 | FAT32, NTFS |
SanDisk SDCZ80 flash drive |
0781:5580 | FAT32, NTFS |
WD HDD |
1058:10B8 | FAT32, NTFS |
Toshiba Kingston DataTraveler 3.0 USB device |
0930:6545 | FAT32, NTFS |
Taiwan OEM – OBSOLETE VendorCo ProductCode Disk 2.0 |
FFFF:5678 | FAT32, NTFS |
TD-RDF5A Transcend USB device |
8564:4000 | FAT32, NTFS |
Nota:
Para usar NTFS en Amazon Linux 2, CentOS, RHEL, Rocky Linux y SUSE, primero debe habilitar la compatibilidad con NTFS en estas distribuciones.
| Ratón USB 3D | VID:PID |
|---|---|
3DConnexion SpaceMouse Pro |
046d: c62b |
| Escáner USB | VID:PID |
|---|---|
Epson Perfection V330 photo |
04B8: 0142 |
| Yubico USB | VID:PID |
|---|---|
Yubico YubiKey OTP+FIDO+CCID -Keyboard, HID |
1050:0407 |
| Webcam USB | VID:PID |
|---|---|
Logitech composite USB device – WebCam, Audio |
0460:0825 |
Configurar la redirección de dispositivos USB
(Solo para CentOS, RHEL y Rocky Linux) Instale o compile el módulo del kernel USB/IP
El VDA de Linux utiliza USB/IP como controlador de host virtual para la redirección de dispositivos USB. Dado que en la mayoría de los casos el módulo del kernel USB/IP se lanza con la versión 3.17 o posterior del kernel de Linux, no es necesario compilar el módulo del kernel de forma predeterminada. Sin embargo, el módulo del kernel USB/IP no está disponible para CentOS, RHEL y Rocky Linux. Para usar la redirección de dispositivos USB con estas distribuciones de Linux, debe instalar o compilar el módulo del kernel USB/IP. Descargue e instale USB/IP desde
<https://pkgs.org/download/kmod-usbip> según su distribución de Linux.
Configurar directivas de redirección de dispositivos USB
Una directiva de Citrix controla si la redirección de dispositivos USB está habilitada o deshabilitada. El tipo de dispositivo también se puede especificar mediante una directiva de Delivery Controller™. Al configurar la redirección de dispositivos USB para el VDA de Linux, configure la siguiente directiva y reglas:
-
Directiva de redirección de dispositivos USB de cliente
-
Reglas de redirección de dispositivos USB de cliente
Habilitar la redirección de dispositivos USB
En Citrix Studio, habilite (o deshabilite) la redirección de dispositivos USB desde el cliente (solo para hosts de estación de trabajo).
En el cuadro de diálogo Editar configuración:
-
Seleccione Permitido.
-
Haga clic en Aceptar.
Establecer reglas de redirección de dispositivos USB
Después de habilitar la directiva de redirección USB, establezca las reglas de redirección mediante Citrix Studio especificando qué dispositivos están permitidos (o denegados) en el VDA de Linux.
En el cuadro de diálogo Reglas de redirección de dispositivos USB del cliente:
-
Haga clic en Nuevo para agregar una regla de redirección, o haga clic en Editar para revisar una regla existente.
-
Después de crear (o editar) una regla, haga clic en Aceptar.
Solucionar problemas de redirección de dispositivos USB
Utilice la información de esta sección para solucionar varios problemas que pueden surgir al usar el VDA de Linux.
No se puede desmontar el disco USB redirigido
El VDA de Linux administra todos los discos USB redirigidos desde la aplicación Citrix Workspace con privilegios administrativos para asegurarse de que solo el propietario pueda acceder al dispositivo redirigido. Como resultado, solo puede desmontar el dispositivo con privilegios administrativos.
Archivo perdido al dejar de redirigir un disco USB
Si deja de redirigir un disco USB inmediatamente usando la barra de herramientas de la aplicación Citrix Workspace, los archivos que modificó o creó en el disco pueden perderse. Este problema ocurre porque cuando se escriben datos en un sistema de archivos, el sistema monta la caché de memoria en el sistema de archivos. Los datos no se escriben en el disco en sí. Si deja de redirigir usando la barra de herramientas de la aplicación Citrix Workspace, no queda tiempo para que los datos se vacíen en el disco, lo que resulta en la pérdida de datos.
Para resolver este problema, utilice el comando sync en un terminal para vaciar los datos en el disco antes de detener la redirección USB.
No hay dispositivos en la barra de herramientas de la aplicación Citrix Workspace
A veces, es posible que no vea los dispositivos enumerados en la barra de herramientas de la aplicación Citrix Workspace, lo que indica que no se está produciendo ninguna redirección USB.
Si se encuentra con este problema, verificar lo siguiente:
-
La directiva está configurada para permitir la redirección de dispositivos USB.
-
El módulo de servicio USB de Citrix se está ejecutando.
Si la directiva no está configurada correctamente, corríjala consultando la sección Establecer directivas de redirección de dispositivos USB de este artículo.
Si el módulo de servicio USB de Citrix no se está ejecutando, siga estos pasos:
-
Compruebe si hay un módulo del kernel USB/IP disponible en su distribución de Linux mediante el siguiente comando:
modinfo usbip-core -
Si la salida se muestra como se indica a continuación, instale o compile el módulo del kernel USB/IP según su distribución de Linux:
modinfo: ERROR: Module usbip-core not found.-
Para Amazon Linux 2, CentOS, RHEL y Rocky Linux, consulte la sección Instalar o compilar el módulo del kernel USB/IP de este artículo.
-
Para SUSE, descargue e instale el paquete USB/IP desde
<https://software.opensuse.org/package/usbip>. -
Para Ubuntu/Debian, siga estos pasos para compilar e instalar el módulo del kernel USB/IP:
-
Descargue el código fuente del módulo del kernel USB/IP.Vaya al repositorio del kernel de Linux en
<https://github.com/torvalds/linux/tree/master/drivers/usb/usbip>, seleccione la etiqueta de la versión del kernel de Linux de destino (v4.15 o posterior) y obtenga el enlace, como<https://github.com/torvalds/linux/tree/v4.15/drivers/usb/usbip>.Vaya a DownGit e introduzca el enlace anterior para crear un enlace de descarga para descargar el código fuente de USB/IP. -
Descomprima el archivo de origen con los siguientes comandos:
unzip ${USBIP_SRC}.zip
cd usbip -
Modifique el archivo Makefile de la siguiente manera:
# SPDX-License-Identifier: GPL-2.0
ccflags-$(CONFIG_USBIP_DEBUG) := -DDEBUG
obj-$(CONFIG_USBIP_CORE) += usbip-core.o
usbip-core-y := usbip_common.o usbip_event.o
obj-$(CONFIG_USBIP_VHCI_HCD) += vhci-hcd.o
vhci-hcd-y := vhci_sysfs.o vhci_tx.o vhci_rx.o vhci_hcd.o
#obj-$(CONFIG_USBIP_HOST) += usbip-host.o
#usbip-host-y := stub_dev.o stub_main.o stub_rx.o stub_tx.o
#obj-$(CONFIG_USBIP_VUDC) += usbip-vudc.o
#usbip-vudc-y := vudc_dev.o vudc_sysfs.o vudc_tx.o vudc_rx.o vudc_transfer.o vudc_main.o -
Compile el código fuente:
apt-get install linux-headers-`uname -r`
make -C /lib/modules/`uname -r`/build M=$PWD -
Instale el módulo del kernel USB/IP:
cp usbip-core.ko vhci-hcd.ko /opt/Citrix/VDA/lib64/ -
Reinicie el servicio ctxusbsd para cargar el módulo del kernel USB/IP:
service ctxusbsd restart
-
-
Error de redirección cuando los dispositivos USB son visibles en la barra de herramientas de la aplicación Citrix Workspace, pero están etiquetados como "restringidos por política"
Cuando se produzca el problema, haga lo siguiente:
-
Configure la directiva de Linux VDA para habilitar la redirección.
-
Compruebe si hay restricciones de directiva adicionales configuradas en el registro de la aplicación Citrix Workspace. Compruebe DeviceRules en la ruta del registro para asegurarse de que el acceso al dispositivo no esté denegado por esta configuración:HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Wow6432Node\\Citrix\\ICA Client\\GenericUSB
Un dispositivo USB se redirige correctamente, pero no puedo usarlo en mi sesión
Normalmente, solo se pueden redirigir dispositivos USB compatibles. Otros dispositivos también se pueden redirigir a una sesión activa de Linux VDA. Para cada dispositivo redirigido, se crea un nodo propiedad del usuario en la ruta /dev del sistema. Sin embargo, son los controladores y la configuración los que determinan si el usuario puede utilizar el dispositivo correctamente. Si encuentra un dispositivo que es propiedad (conectado) pero inaccesible, añada el dispositivo a una directiva sin restricciones.
Nota:
Para las unidades USB, el VDA de Linux configura y monta el disco. El usuario (y solo el propietario que lo instaló) puede acceder al disco sin ninguna configuración adicional. Esto podría no ser cierto para los dispositivos que no están en la lista de dispositivos compatibles.