Configurer la redirection USB

Les périphériques USB sont partagés entre l’application Citrix Workspace™ et le bureau Linux VDA. Lorsqu’un périphérique USB est redirigé vers le bureau, l’utilisateur peut l’utiliser comme s’il était connecté localement.

Conseil :

• Nous vous recommandons d’utiliser la redirection USB lorsque la latence du réseau est inférieure à 100 millisecondes. N’utilisez pas la redirection USB lorsque la latence du réseau est supérieure à 200 millisecondes.

• La redirection USB comprend trois principaux domaines de fonctionnalité :

• Implémentation du projet open source (VHCI)
• Service VHCI
• Service USB

VHCI open source :

Cette partie de la fonctionnalité de redirection USB développe un système général de partage de périphériques USB sur un réseau IP. Elle se compose d’un pilote de noyau Linux et de certaines bibliothèques en mode utilisateur qui vous permettent de communiquer avec le pilote de noyau pour obtenir toutes les données USB. Dans l’implémentation Linux VDA, Citrix réutilise le pilote de noyau de VHCI. Cependant, tous les transferts de données USB entre le Linux VDA et l’application Citrix Workspace sont encapsulés dans le paquet de protocole Citrix ICA®.

Service VHCI :

Le service VHCI est un service open source fourni par Citrix pour communiquer avec le module de noyau VHCI. Ce service fonctionne comme une passerelle entre VHCI et le service USB de Citrix.

Service USB :

Le service USB représente un module Citrix qui gère toutes les virtualisations et les transferts de données sur le périphérique USB.

Fonctionnement de la redirection USB

Généralement, si un périphérique USB est redirigé avec succès vers le Linux VDA, un ou plusieurs nœuds de périphérique sont créés dans le chemin /dev du système. Cependant, il arrive parfois que le périphérique redirigé ne soit pas utilisable pour une session Linux VDA active. Les périphériques USB dépendent de pilotes pour fonctionner correctement et certains périphériques nécessitent des pilotes spéciaux. Si les pilotes ne sont pas fournis, les périphériques USB redirigés sont inaccessibles à la session Linux VDA active. Pour garantir la connectivité des périphériques USB, installez les pilotes et configurez correctement le système.

Le Linux VDA prend en charge une liste de périphériques USB qui sont redirigés avec succès vers et depuis le client. De plus, le périphérique est correctement monté, en particulier le disque USB, ce qui permet à l’utilisateur d’accéder au disque sans aucune configuration supplémentaire.

Périphériques USB pris en charge

Les périphériques suivants ont été vérifiés pour prendre en charge cette version du Linux VDA. D’autres périphériques peuvent être utilisés librement, avec des résultats inattendus :

| >**Remarque :** | | | | | | | | - >Le Linux VDA prend en charge uniquement les protocoles USB 2.0.

Configurer la redirection USB

Une stratégie Citrix contrôle si la redirection de périphériques USB est activée ou désactivée. De plus, le type de périphérique peut également être spécifié à l’aide d’une stratégie Delivery Controller™. Lors de la configuration de la redirection USB pour le Linux VDA, configurez la stratégie et les règles suivantes :

-  Stratégie de redirection de périphériques USB client

• Règles de redirection de périphériques USB client

Activer la redirection USB

Dans Citrix Studio, activez (ou désactivez) la redirection de périphériques USB vers et depuis le client (pour les hôtes de station de travail uniquement).

Dans la boîte de dialogue Modifier le paramètre :

1. Sélectionnez Autorisé.
2. Cliquez sur OK.

Définir les règles de redirection USB

Après avoir activé la stratégie de redirection USB, définissez les règles de redirection à l’aide de Citrix Studio en spécifiant les périphériques autorisés (ou refusés) sur le Linux VDA.

Dans la boîte de dialogue Règles de redirection de périphériques USB client :

1. Cliquez sur Nouveau pour ajouter une règle de redirection, ou cliquez sur Modifier pour examiner une règle existante.

2. Après avoir créé (ou modifié) une règle, cliquez sur OK.

   • 

Créer le module de noyau VHCI

La redirection USB dépend des modules de noyau VHCI (usb-vhci-hcd.ko et usb-vhci-iocif.ko). Ces modules font partie de la distribution Linux VDA (dans le cadre du package RPM). Ils sont compilés sur la base des noyaux de distribution Linux officiels et sont répertoriés dans le tableau suivant :

• Important :

• Si le noyau de votre machine n’est pas compatible avec le pilote conçu pour le VDA Linux, le service USB risque de ne pas démarrer. Dans ce cas, vous pouvez utiliser la fonctionnalité de redirection USB uniquement si vous créez vos propres modules de noyau VHCI.

Vérifier la cohérence de votre noyau avec les modules créés par Citrix

Sur la ligne de commande, exécutez la commande suivante pour vérifier la cohérence du noyau :

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

Si la commande s’exécute correctement, le module de noyau a été chargé avec succès et la version est cohérente avec celle installée par Citrix.

Si la commande s’exécute avec des erreurs, le noyau est incohérent avec le module Citrix et doit être reconstruit.

Reconstruire le module de noyau VHCI

Si votre module de noyau est incohérent avec la version Citrix, procédez comme suit :

1. Téléchargez le code source du VDA Linux depuis le site de téléchargement de Citrix. Sélectionnez le fichier contenu dans la section « Linux Virtual Delivery Agent (sources) ».

2. Extrayez le fichier citrix-linux-vda-sources.zip. Accédez à linux-vda-sources/vhci-hcd-1.15.zip et extrayez les fichiers source VHCI à l’aide de la commande unzip vhci-hcd-1.15.zip.

3. Assurez-vous que le package VDA Linux est installé, puis exécutez l’une des commandes suivantes :

   • sudo bash ctxusbcfg.sh dkms

     Cette commande vous permet d’utiliser le programme DKMS (Dynamic Kernel Module Support) pour gérer vos modules de noyau VHCI. DKMS n’est pas disponible pour SUSE.

     Remarque :

     La commande sudo bash ctxusbcfg.sh dkms installe les programmes kernel-devel et DKMS sur votre VDA. Lors de l’installation des programmes sur RHEL et CentOS, la commande installe et active le référentiel EPEL (Extra Packages for Enterprise Linux) sur votre VDA.

     DKMS peut échouer à créer les modules de noyau VHCI (usb-vhci-hcd.ko et usb-vhci-iocif.ko) lorsque vous effectuez une mise à niveau majeure du noyau, par exemple, de la version 4.x.y à la version 5.x.y. Si DKMS échoue, exécutez à nouveau sudo bash ctxusbcfg.sh dkms.

   • sudo bash ctxusbcfg.sh build

     Cette commande crée et installe les modules de noyau VHCI sans l’option DKMS.

Dépanner les problèmes de redirection USB

Utilisez les informations de cette section pour dépanner les divers problèmes que vous pourriez rencontrer lors de l’utilisation du VDA Linux.

Impossible de démonter le disque USB redirigé

Pour le contrôle d’accès de tous les disques USB redirigés depuis l’application Citrix Workspace, le VDA Linux gère tous ces périphériques avec des privilèges administratifs afin de garantir que seul le propriétaire peut accéder au périphérique redirigé. Par conséquent, l’utilisateur ne peut pas démonter le périphérique sans les privilèges administratifs.

Fichier perdu lorsque vous arrêtez la redirection d’un disque USB

Si vous redirigez un disque USB vers une session et tentez de le modifier (par exemple, créer des fichiers sur le disque), puis arrêtez immédiatement sa redirection à l’aide de la barre d’outils de l’application Citrix Workspace, le fichier que vous avez modifié ou créé peut être perdu. Ce problème se produit car lorsque vous écrivez des données sur un système de fichiers, le système monte le cache mémoire dans le système de fichiers. Les données ne sont pas écrites sur le disque lui-même. Si vous arrêtez la redirection à l’aide de la barre d’outils de l’application Citrix Workspace, il ne reste plus de temps pour que les données soient vidées sur le disque, ce qui entraîne une perte de données. Pour résoudre ce problème, utilisez la commande sync dans un terminal pour vider les données sur le disque avant d’arrêter la redirection USB.

Aucun périphérique dans la barre d’outils de l’application Citrix Workspace

Parfois, il est possible que vous ne voyiez pas les périphériques répertoriés dans la barre d’outils de l’application Citrix Workspace, ce qui indique qu’aucune redirection USB n’est en cours. Si vous rencontrez ce problème, vérifiez les points suivants :

• La stratégie est configurée pour autoriser la redirection USB
• Le module de noyau est compatible avec votre noyau

Remarque :

L’onglet Périphériques n’est pas disponible dans l’application Citrix Workspace pour Linux.

Échec de la redirection lorsque les périphériques USB sont visibles dans la barre d’outils de l’application Citrix Workspace, mais sont étiquetés restreint par la stratégie

Lorsque le problème se produit, procédez comme suit :

• Configurez la stratégie VDA Linux pour activer la redirection.

• Vérifiez si des restrictions de stratégie supplémentaires sont configurées dans le registre de l’application Citrix Workspace. Vérifiez DeviceRules dans le chemin du registre pour vous assurer que l’accès au périphérique n’est pas refusé par ce paramètre :

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

Un périphérique USB est redirigé avec succès, mais je ne peux pas l’utiliser dans ma session

Généralement, seuls les périphériques USB pris en charge peuvent être redirigés. D’autres périphériques peuvent également être redirigés vers une session VDA Linux active. Pour chaque périphérique redirigé, un nœud appartenant à l’utilisateur est créé dans le chemin système /dev. Cependant, ce sont les pilotes et la configuration qui déterminent si l’utilisateur peut utiliser le périphérique avec succès. Si vous trouvez un périphérique possédé (branché) mais inaccessible, ajoutez le périphérique à une stratégie illimitée.

Remarque :

Dans le cas des lecteurs USB, le VDA Linux configure et monte le disque. L’utilisateur (et seul le propriétaire qui l’a installé) peut accéder au disque sans aucune configuration supplémentaire. Ce n’est peut-être pas le cas pour les périphériques qui ne figurent pas dans la liste des périphériques pris en charge.