📘

Attention compatible uniquement avec la version V2.1.8 minimum de Wisper Core

Configuration de l'USB Passthrough sous Wisper 360

La configuration USB Passthrough permet de rediriger les hubs USB du poste physique directement dans la VM.Cela permet une meilleure gestion des périphériques USB "exotiques" et de corriger certains comportements erratiques des micro-casques qui peuvent se déconnecter de manière inopinée. Ce mode nécessite une configuration particulière.

Avantages et inconvénients du mode USB Passthrough

✅ Avantages :

Gestion USB entièrement prise en charge par la VM

• Le hub USB interne est remonté dans la VM, comme sur Cebox Evolution®.
• Plus de problème de reset USB ou de reconnexion des périphériques.
• L’USB est géré directement par la VM, garantissant une compatibilité native avec les périphériques.

Performances optimisées

• Moins de latence et de coupures sur les périphériques USB (claviers, souris, casques, webcams).
• Meilleur support pour les périphériques "exotiques" nécessitant un contrôle natif (lecteurs de cartes à puce, Yubikey).

Stabilité accrue pour les sessions longues

• Moins de risques de déconnexions intempestives des périphériques USB.
• Utilisation fluide pour des tâches nécessitant un usage continu (visioconférences, appels, etc.).

❌ Inconvénients :

Perte de contrôle de la souris et du clavier hors VM

• Une fois dans la VM, le clavier et la souris ne sont plus disponibles pour le système hôte.
• Impossible d’effectuer certaines actions hors VM, comme le refresh des écrans (en cas de perte de synchro) ou la gestion des moniteurs (gauche/droite).
• Pour récupérer la souris, il faut éteindre la VM.

Problèmes d’accès et de gestion à distance

• Portail Wisper 360 non utilisable avec la souris (car capturée par la VM).
• Possibles problèmes avec le support à distance si la souris n'est pas reconnue dans certains cas.
• Autorisation VNC impossible (prévoir une connexion automatique dans la configuration).

Compatibilité matérielle requise

• Nécessite une compatibilité avec IOMMU group, VT-d (similaire au cas du nouveau matériel sous Evolution).
• Si le matériel ne prend pas en charge ces fonctionnalités, la VM ne démarre pas.

Problèmes d’affichage

• Modification du Master : activation du suivi visuel du curseur de la souris dans le master (pointeur invisible).
• Ajout d'un raccourci sur le bureau pour permettre une synchronisation de l’écran en cas de perte de synchronisation.

Mode Opératoire – Activation de l’USB Passthrough sous Wisper 360

Objectif

Mettre en place l’USB Passthrough en configurant un hyperviseur dédié et en déployant les ajustements nécessaires sur les postes utilisateurs sous Wisper Core v2.1.8 minimum.

Étapes à suivre

1️⃣ Déploiement d’un hyperviseur dédié

• Le support Wisper doit créer un hyperviseur spécifique pour l’USB Passthrough.
• S’assurer que cet hyperviseur est bien isolé des environnements de production.

2️⃣ Activation de Mouse Cursor Trail sous Windows

La souris étant directement redirigée dans la VM, le curseur ne peut donc pas apparaître. Pour pallier ce problème, il faut activer la fonctionnalité "trace de la souris" dans Windows.

Méthode via GPO (si applicable) :

1. Ouvrir Group Policy Management (gpedit.msc pour un test local).
2. Aller dans :

   Configuration utilisateur > Stratégies > Paramètres Windows > Paramètres de registre

3. Ajouter une nouvelle clé de registre :
   • Chemin : HKEY_USERS\.DEFAULT\Control Panel\Mouse
   • Valeur : MouseTrails
   • Type : REG_SZ
   • Donnée : 2
4. Appliquer la GPO sur les machines concernées via Active Directory.

3️⃣ Déploiement du fichier command.exe pour le rafraîchissement des écrans

• Problème : avec le passthrough USB, le portail Wisper 360 n’est plus manageable avec la souris.
• Solution : utiliser un utilitaire de rafraîchissement d’écran.

Méthode :

• Copier command.exe (demander un lien de téléchargement à notre support) sur le bureau des utilisateurs via un script de déploiement.
• Alternative : stocker le .exe dans un endroit spécifique et créer un raccourci sur le bureau.
• Vérifier que l’exécution du fichier est bien autorisée.
• Créer un raccourci sur le bureau avec comme argument : Command.exe refresh send.

4️⃣ Création d’une VM de test avec l’hyperviseur dédié

• Créer une nouvelle VM dédiée aux tests avec l’hyperviseur W360-USB_Passthrough.
• Isoler cette VM pour ne pas impacter les postes en production.

5️⃣ Allocation et remplacement de la nouvelle VM sur les postes

• Assigner la nouvelle VM aux postes concernés.
• Vérifier que l’allocation ne perturbe pas les configurations existantes.

6️⃣ Mise à jour des postes vers Wisper Core

• Déployer la mise à jour sur tous les postes concernés.
• Vérifier que la mise à jour s’effectue sans erreur.

7️⃣ Désactivation du démarrage automatique des VM

• Modifier la configuration pour empêcher le lancement automatique des VM après redémarrage.

8️⃣ Redémarrage des postes après mise à jour

• Redémarrer chaque poste pour appliquer la mise à jour.
• Vérifier que la mise à jour s’est bien appliquée.

9️⃣ Vérification de la disposition des écrans depuis le portail

• Vérifier que les écrans sont correctement détectés et positionnés.
• En cas de mauvaise disposition, configurer la disposition des écrans.

🔟 Démarrage de la VM et tests fonctionnels

• Démarrer la VM avec l’hyperviseur W360-USB_Passthrough.
• Tester les fonctionnalités principales, notamment l’USB Passthrough.