Optimisation pour Microsoft Teams

Important :

L’optimisation pour Microsoft Teams nécessite au minimum Microsoft Teams version 1.2.00.31357.

Citrix offre une optimisation pour Microsoft Teams avec l’application Citrix Workspace et Citrix Virtual Apps and Desktops. Par défaut, nous regroupons tous les composants nécessaires dans l’application Citrix Workspace et le Virtual Delivery Agent (VDA).

Notre optimisation pour Microsoft Teams contient des services et une API HDX côté VDA afin de créer une interface avec l’application hébergée Microsoft Teams pour recevoir des commandes. Ces composants ouvrent un canal virtuel de contrôle (CTXMTOP) vers Media Engine côté application Citrix Workspace. Le point de terminaison décode et restitue le multimédia localement. Inversez les composants logiciels enfichables de la fenêtre locale de l’application Citrix Workspace dans l’application Microsoft Teams hébergée.

L’authentification et la signalisation se produisent en mode natif sur l’application hébergée par Microsoft Teams, tout comme les autres services Microsoft Teams (par exemple le chat ou la collaboration). La redirection audio/vidéo ne les affecte pas.

CTXMTOP est un canal virtuel de commande et de contrôle. Cela signifie que le média n’est pas échangé entre l’application Citrix Workspace et le VDA.

Seule la récupération/restitution client est disponible.

Cette vidéo de démo vous donne une idée du fonctionnement de Microsoft Teams dans un environnement virtuel Citrix.

Démo Optimisation pour Microsoft Teams

Installation de Microsoft Teams

AVERTISSEMENT :

Toute utilisation incorrecte de l’Éditeur du Registre peut générer des problèmes sérieux, pouvant vous obliger à réinstaller le système d’exploitation. Citrix ne peut garantir la possibilité de résoudre les problèmes provenant d’une mauvaise utilisation de l’Éditeur du Registre. Vous assumez l’ensemble des risques liés à l’utilisation de l’Éditeur du Registre. Veillez à faire une copie de sauvegarde de votre registre avant de le modifier.

Nous vous recommandons de suivre les instructions d’installation de Microsoft Teams à l’échelle de la machine et d’éviter d’utiliser le programme d’installation .exe qui installe Teams dans Appdata. Au lieu de cela, effectuez l’installation dans C:\Program Files (x86)\Microsoft\Teams en utilisant l’indicateur ALLUSER=1 de la ligne de commande. Dans ce mode, l’application Teams ne se met pas à jour automatiquement chaque fois qu’il y a une nouvelle version. Nous recommandons ce mode pour les environnements non persistants. Pour plus d’informations, voir Installer Microsoft Teams à l’aide de MSI (section Installation VDI).

Si vous avez des environnements VDI permanents dédiés, que vous souhaitez que l’application Teams se mette à jour automatiquement et que vous préférez que Teams s’installe par utilisateur sous Appdata/Local, utilisez le programme d’installation .exe ou le MSI sans ALLUSER =1.

Si vous utilisez Citrix App Layering pour gérer les installations VDA et Microsoft Teams dans différentes couches, déployez cette clé de Registre sur Windows avant d’installer Teams avec ALLUSER =1 :

HKEY_LOCAL_MACHINE\SOFTWARE\Citrix

Ou

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix

Créez une clé de Registre vide nommée PortICA (conservez le nom, le type et les données par défaut).

Recommandations pour Profile Management

Lorsque l’indicateur ALLUSER =1 est transmis au MSI à partir de la ligne de commande, l’application Teams s’installe sous C:\Program Files (~300 Mo). L’application utilise AppData\Local pour les journaux et AppData\Roaming\Microsoft\Teams pour les configurations spécifiques à l’utilisateur, la mise en cache des éléments dans l’interface utilisateur, etc.

Configuration système requise

Version minimale - Virtual Delivery Agents (VDA) 1906.2 :

Systèmes d’exploitation pris en charge :

  • Windows 10 64 bits, versions minimum 1607 jusqu’à 1903.
  • Windows Server 2019, 2016 et 2012 R2 (éditions Standard et Datacenter).

Exigences :

  • BCR_x64.msi - MSI qui contient le code d’optimisation de Microsoft Teams et démarre automatiquement à partir de l’interface graphique. Si vous utilisez l’interface de ligne de commande pour l’installation du VDA, ne l’excluez pas.

Version recommandée : application Citrix Workspace 1911 pour Windows et version minimale - application Citrix Workspace 1907 pour Windows :

  • Windows 7, 8 et 10 (éditions 32 bits et 64 bits, y compris l’édition Embedded)
  • Windows 10 IoT Enterprise 2016 LTSB (v1607) et 2019 LTSC (v1809)
  • Exigences pour le point de terminaison : CPU double cœur d’environ 2,2–2,4 GHz pouvant prendre en charge la résolution HD 720p lors d’une visioconférence égal à égal.
  • CPU double ou quadruple cœur avec des vitesses de base plus faibles (~1,5 GHz) équipés d’Intel Turbo Boost ou AMD Turbo Core pouvant augmenter jusqu’à 2,4 GHz au moins.
  • Clients fins HP vérifiés : t630/t640, t730/t740, mt45.
  • Clients fins Dell vérifiés : 5070, 5470 Mobile TC.
  • Pour obtenir la liste complète des points de terminaison vérifiés, reportez-vous à Clients fins.
  • L’application Citrix Workspace requiert une capacité minimale de 600 Mo d’espace disque disponible et 1 Go de RAM.
  • La configuration minimale requise pour Microsoft .NET Framework est la version 4.6.2. L’application Citrix Workspace télécharge et installe automatiquement .NET Framework si la version n’est pas présente dans le système.

Activer l’optimisation de Microsoft Teams

Pour activer l’optimisation de Microsoft Teams, utilisez la stratégie Studio décrite dans Stratégie de redirection de Microsoft Teams (elle est définie sur ON par défaut). Outre l’activation de cette stratégie, HDX vérifie que la version de l’application Citrix Workspace est égale ou supérieure à la version minimale requise. Si la stratégie est activée et que la version de l’application Citrix Workspace est prise en charge, la clé de Registre HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream\MSTeamsRedirSupport est définie sur 1 de manière automatique sur le VDA. L’application Microsoft Teams lit la clé à charger en mode VDI.

Si vous cliquez sur About > Version, la légende Optimized for Citrix affiche :

Légende Optimized for Citrix

Si vous ne voyez pas Optimized for Citrix, quittez Teams en cliquant avec le bouton droit de la souris sur l’icône de la zone de notification et redémarrez.

Configuration réseau requise

Microsoft Teams s’appuie sur les serveurs Media Processor dans Office 365 pour les réunions ou les appels à plusieurs. Microsoft Teams s’appuie sur les relais de transport Office 365 pour les scénarios suivants :

  • Deux homologues dans un appel point à point n’ont pas de connectivité directe
  • Un participant n’a pas de connectivité directe avec le processeur multimédia.

Par conséquent, l’intégrité du réseau entre l’homologue et le cloud Office 365 détermine les performances de l’appel.

Nous vous recommandons d’évaluer votre environnement pour identifier les risques et les exigences qui peuvent influencer votre déploiement voix et vidéo global dans le cloud. Utilisez l’Outil d’évaluation de réseau Skype Entreprise pour tester si votre réseau est prêt pour Microsoft Teams. Pour plus d’informations, consultez la section Assistance.

Résumé des principales recommandations réseau pour le trafic RTP (Real Time Protocol) :

  • Connectez-vous au réseau Office 365 aussi directement que possible à partir de la succursale.
  • Si vous devez utiliser l’un des éléments suivants à la succursale, assurez-vous que le trafic RTP/UDP Teams est fluide. HdxTeams.exe n’applique pas les proxys explicites configurés sur le point de terminaison.
    • Contourner les serveurs proxy
    • Interception SSL réseau
    • Dispositifs d’inspection approfondie des paquets
    • Épingles à cheveux VPN (utiliser le split tunneling si possible)
  • Planifiez et fournissez une bande passante suffisante.
  • Vérifiez la connectivité et la qualité du réseau de chaque succursale.

Le moteur multimédia WebRTC dans l’application Workspace (HdxTeams.exe) utilise le protocole SRTP (Secure Real-Time Transport Protocol) pour les flux multimédia qui sont déchargés sur le client. SRTP assure la confidentialité et l’authentification de RTP à l’aide de clés symétriques (128 bits) pour chiffrer les médias et contrôler les messages, et utilise le chiffrement AES en mode compteur.

Les mesures suivantes sont recommandées pour garantir une expérience utilisateur positive :

Mesure Point de terminaison vers Office 365
Latence (sens unique) < 50 msec
Latence (RTT) < 100 msec
Perte de paquets < 1 % au cours d’un intervalle de 15 s
Variation inter-arrivées des paquets < 30 ms pendant un intervalle de 15 s

Pour de plus amples informations, consultez la section Préparer le réseau de votre organisation pour Microsoft Teams.

En termes de bande passante requise, l’optimisation pour Microsoft Teams peut utiliser une grande variété de codecs pour l’audio (OPUS/G.722/PCM G711) et la vidéo (H264/VP9).

Les homologues négocient ces codecs pendant le processus d’établissement de l’appel à l’aide de l’offre/réponse du protocole SDP. Les recommandations minimales Citrix sont les suivantes :

Type Bande passante Codec
Audio (dans chaque sens) ~ 90 kbps G.722
Audio (dans chaque sens) ~ 60 Kbits/s Opus*
Vidéo (dans chaque sens) ~ 700 kbps H264 360p @ 30 ips 16:9
Vidéo (dans chaque sens) ~ 2500 kbps VP9 720p @ 30 ips 16:9
Partage d’écran ~ 300 kbps H264 1080p @ 15 ips

* Opus prend en charge l’encodage à débit variable et constant de 6 Kbits/s à 510 Kbits/s.

Opus et VP9 sont les codecs recommandés pour les appels entre deux utilisateurs VDI optimisés.

G.722 et H264 sont les codecs recommandés pour un utilisateur VDI qui rejoint une réunion.

Établissement des appels et chemins de circulation des médias

Autant que possible, le service HDX Media Engine de l’application Citrix Workspace (HdxTeams.exe) tente d’établir une connexion SRTP réseau directe via UDP dans un appel d’égal à égal. Si les ports UDP sont bloqués, Media Engine revient à TCP 443.

HDX Media Engine prend en charge ICE, Session Traversal Utilities for NAT (STUN) et Traversal Using Relays around NAT (TURN) pour découvrir les candidats et établir les connexions.

S’il n’y a pas de chemin direct entre les deux homologues ou entre un homologue et un serveur de conférence (si l’utilisateur rejoint un appel ou une réunion à plusieurs), HdxTeams.exe utilise un serveur relais de transport Microsoft Teams dans Office 365 pour atteindre l’autre homologue ou le processeur multimédia (où les réunions sont hébergées). L’ordinateur client de l’utilisateur doit avoir accès à deux plages d’adresses IP de sous-réseau Office 365 et à 4 ports UDP. Pour plus d’informations, consultez le diagramme d’architecture dans la section « Configuration d’appel » ci-dessous et URL et plages d’adresses IP Office 365 ID 11.

ID Catégorie Adresses Ports de destination
11 Optimisation requise 13.107.64.0/18, 52.112.0.0/14 UDP : 3478, 3479, 3480, 3481, TCP : 443 (repli)

Ces plages contiennent à la fois des relais de transport et des processeurs multimédias. Les relais de transport Teams offrent des fonctionnalités STUN et TURN, mais ce ne sont pas des points de terminaison ICE. De plus, les relais de transport Teams ne terminent pas les médias ni n’effectuent aucun transcodage. Ils peuvent relier TCP (si HdxTeams.exe utilise TCP) à UDP lorsqu’ils transmettent le trafic à d’autres homologues ou processeurs multimédia.

HdxTeams.exe contacte le relais de transport Microsoft Teams le plus proche dans le cloud Office 365. HdxTeams.exe utilise une adresse IP anycast et le port 3478—3481 UDP (différents ports UDP par charge de travail, bien qu’un multiplexage soit possible) ou 443 TCP TLSv1.2 pour les replis. La qualité des appels dépend du protocole réseau sous-jacent. Étant donné que UDP est toujours préférable à TCP, nous vous conseillons de concevoir vos réseaux pour prendre en charge le trafic UDP au niveau de la succursale.

Si Teams est chargé en mode optimisé et que HdxTeams.exe est en cours d’exécution sur le point de terminaison, des échecs ICE (Interactive Connectivity Establishment) peuvent provoquer un échec de la configuration d’appel ou une lecture audio/vidéo à sens unique. Lorsqu’un appel ne peut pas être établi ou que les flux de médias ne sont pas en duplex intégral, vérifiez d’abord la trace Wireshark sur le point de terminaison. Pour plus d’informations sur le processus de collecte des candidats ICE, voir « Collecte des journaux » dans la section Assistance.

Remarque :

Si les points de terminaison n’ont pas accès à Internet, il peut encore être possible pour l’utilisateur d’effectuer un appel égal à égal uniquement si les participants se trouvent sur le même réseau LAN. Les réunions échouent. Dans ce cas, il y a un délai de 30 secondes avant le début de l’établissement de l’appel.

Configuration d’appel

Utilisez ce diagramme d’architecture comme référence visuelle pour la procédure d’appel. Les étapes correspondantes sont indiquées dans le diagramme.

Architecture :

Fonctionnement de l'optimisation pour Microsoft Teams

  1. Lancez Microsoft Teams.
  2. Teams s’authentifie auprès de O365. Les stratégies de locataire sont envoyées au client Teams, et les informations TURN et de canal de signalisation pertinentes sont relayées à l’application.
  3. Teams détecte qu’il s’exécute dans un VDA et envoie des appels d’API vers l’API JavaScript Citrix.
  4. Citrix JavaScript dans Teams ouvre une connexion WebSocket sécurisée à WebSocketService.exe s’exécutant sur le VDA (127.0.0. 1:9002), ce qui génère WebSocketAgent.exe dans la session utilisateur.
  5. WebSocketAgent.exe instancie un canal virtuel générique en appelant le service de redirection Teams Citrix HDX (CtxSvcHost.exe).
  6. Le wfica32.exe (moteur HDX) de l’application Citrix Workspace génère un nouveau processus appelé HdxTeams.exe, qui est le nouveau moteur WebRTC utilisé pour l’optimisation de Teams.
  7. HdxTeams.exe et Teams.exe ont un chemin de canal virtuel bidirectionnel et peuvent commencer à traiter les demandes multimédia.

    —Appels utilisateur—

  8. L’homologue A clique sur le bouton Appeler. Teams.exe communique avec les services Teams dans Office 365 en établissant un chemin de signalisation de bout en bout avec l’homologue B. Teams demande à HDxTeams une série de paramètres d’appel pris en charge (codecs, résolutions, etc., connus sous le nom d’offre SDP (Session Description Protocol)). Ces paramètres d’appel sont ensuite relayés à l’aide du chemin de signalisation vers les services Teams dans Office 365 et à partir de là vers l’autre homologue.
  9. L’offre/réponse SDP (négociation à une seule passe) est réalisée via le canal de signalisation, et les vérifications de connectivité ICE (traversée NAT et pare-feu à l’aide des requêtes de liaison NAT (STUN)) sont effectuées. Ensuite, le contenu multimédia SRTP (Secure Real-Time Transport Protocol) circule directement entre HdxTeams.exe et l’autre homologue (ou les serveurs de conférence Office 365 s’il s’agit d’une réunion).

Considérations sur les pare-feux

Lorsque les utilisateurs lancent un appel optimisé à l’aide du client Microsoft Teams pour la première fois, ils peuvent voir un avertissement concernant les paramètres du pare-feu Windows. L’avertissement demande aux utilisateurs d’autoriser la communication pour HdxTeams.exe (HDX Overlay Teams).

Avertissement de pare-feu

Les quatre entrées suivantes sont ajoutées sous Règles de trafic entrant dans la console Pare-feu Windows Defender > Sécurité avancée. Vous pouvez appliquer des règles plus restrictives si vous le souhaitez.

Règles de trafic entrant du pare-feu

Citrix SD-WAN : connectivité réseau optimisée pour Microsoft Teams

Une qualité audio et vidéo optimale nécessite une connexion réseau au cloud Office 365 avec une faible latence, une faible gigue et une faible perte de paquets. La rétroacheminement du trafic RTP audio-vidéo Microsoft Teams à partir des utilisateurs de l’application Citrix Workspace situés dans des succursales vers un centre de données avant d’accéder à Internet peut ajouter une latence excessive et entraîner une congestion sur les liaisons WAN. Citrix SD-WAN optimise la connectivité pour Microsoft Teams conformément aux principes de connectivité réseau Microsoft Office 365. Citrix SD-WAN utilise l’adresse IP et le service Web Microsoft REST Office 365 et le DNS approximatif pour identifier, catégoriser et diriger le trafic Microsoft Teams.

Dans de nombreuses régions, les connexions Internet haut débit professionnelles souffrent de pertes intermittentes de paquets, de périodes de gigue excessive et de pannes.

Citrix SD-WAN propose deux solutions pour préserver la qualité audio-vidéo de Microsoft Teams lorsque l’intégrité du réseau est variable ou dégradée.

  • Si vous utilisez Microsoft Azure, une appliance virtuelle Citrix SD-WAN (VPX) déployé dans le VNET Azure fournit des optimisations de connectivité avancées. Ces optimisations incluent le basculement transparent de liaison et le traçage des paquets audio.
  • Les clients Citrix SD-WAN peuvent également se connecter à Office 365 via le service Citrix Cloud Direct. Ce service fournit une livraison fiable et sécurisée pour tout le trafic lié à Internet.

Si la qualité de la connexion Internet des succursales n’est pas un problème, il peut être suffisant de réduire la latence en dirigeant le trafic Microsoft Teams directement à partir de l’appliance de succursale Citrix SD-WAN vers la porte d’entrée Office 365 la plus proche. Pour de plus amples informations, consultez la section Optimisation de Citrix SD-WAN Office 365.

Citrix SD-WAN

Vue Galerie et haut-parleurs actifs dans Microsoft Teams

Un seul flux vidéo entrant est pris en charge lors des réunions ou des appels de groupe. Lorsque plusieurs participants envoient leur vidéo, seule la vidéo de l’intervenant dominant est affichée à tout moment. Il peut y avoir un délai d’une ou deux secondes entre le moment où un haut-parleur est détecté comme actif et le moment où le flux vidéo s’affiche.

Partage d’écran dans Microsoft Teams

Microsoft Teams s’appuie sur le partage d’écran basé sur la vidéo (VBSS), codant le bureau partagé avec des codecs vidéo comme H264 et créant un flux haute définition. Avec l’optimisation HDX, le partage d’écran entrant est traité comme un flux vidéo. Par conséquent, si vous êtes au milieu d’un appel vidéo et que l’autre homologue commence à partager le bureau, ce flux vidéo de la caméra d’origine est mis en pause et, à la place, le flux vidéo de partage d’écran s’affiche. L’homologue doit ensuite reprendre manuellement le partage de la caméra.

Le partage d’écran sortant est également optimisé et déchargé vers l’application Citrix Workspace (version 1907 ou ultérieure). Dans ce cas, HdxTeams.exe capture et transmet uniquement la fenêtre Citrix Desktop Viewer (CDViewer.exe). Si vous souhaitez partager une application locale s’exécutant sur votre machine cliente, vous pouvez la superposer sur CDViewer et elle est également capturée.

Multi-moniteurs : dans les cas où CDViewer est en mode plein écran et s’étend sur plusieurs moniteurs, seul le moniteur principal est partagé. Les utilisateurs doivent faire glisser l’application à l’intérieur du bureau virtuel vers le moniteur principal pour que l’autre participant à l’appel puisse la voir.

Partage d'écran

Remarque :

Si vous publiez Teams en tant qu’application transparente autonome, le partage d’écran capture le bureau local de votre point de terminaison physique dans la version minimale 1909 de l’application Citrix Workspace.

Périphériques dans Microsoft Teams

Lorsque l’optimisation pour Microsoft Teams est active, l’application Citrix Workspace accède aux périphériques (casque, microphone, caméras, haut-parleurs, etc.). Ensuite, les périphériques sont correctement énumérés dans l’interface utilisateur Microsoft Teams (Paramètres > Périphériques).

Mode Optimisation pour Microsoft Teams

Microsoft Teams n’accède pas directement aux périphériques, mais s’appuie sur HdxTeams.exe pour l’acquisition, la capture et le traitement des médias. Microsoft Teams répertorie les périphériques que l’utilisateur peut sélectionner.

Recommandations :

  • Casques certifiés Microsoft Teams avec annulation de l’écho intégrée. Les configurations comportant plusieurs périphériques, où le microphone et les haut-parleurs se trouvent sur des périphériques distincts, peuvent entraîner un écho. Par exemple, une webcam avec un microphone intégré et un moniteur avec des haut-parleurs. Lorsque vous utilisez des haut-parleurs externes, placez-les aussi loin que possible du microphone et de n’importe quelle surface susceptible de réfracter le son dans le microphone.
  • Caméras certifiées Microsoft Teams, bien que les les périphériques certifiés Skype Entreprise soient compatibles avec Microsoft Teams.
  • HdxTeams.exe ne peut pas profiter du déchargement CPU avec des webcams qui exécutent le codage H.264 intégré -UVC 1.1 et 1.5.

Remarque :

HdxTeams.exe prend en charge uniquement ces formats de périphériques audio spécifiques (canaux, profondeur de bits et taux d’échantillonnage) :

  • Périphériques de lecture : jusqu’à 2 canaux, 16 bits, fréquences jusqu’à 48 000 Hz
  • Périphériques d’enregistrement : jusqu’à 3 canaux, 16 bits, fréquences jusqu’à 48 000 Hz

Même si un seul haut-parleur ou un microphone ne correspond pas aux paramètres attendus, l’énumération des périphériques dans Teams échoue et Aucun s’affiche sous Paramètres > Périphériques. Pour contourner le problème, ouvrez le Panneau de configuration Sons (mmsys.cpl), sélectionnez le périphérique de lecture ou d’enregistrement, accédez à Propriétés > Avancé et modifiez les paramètres vers un mode pris en charge. Vous pouvez également désactiver le périphérique en question.

Les technologies HDX peuvent utiliser l’une ou l’autre des méthodes suivantes pour mapper les périphériques :

  • Optimisation pour Microsoft Teams (mode recommandé).
  • Si Microsoft Teams ne parvient pas à se charger en mode VDI optimisé, le VDA utilise des technologies HDX héritées comme Redirection de webcam et Redirection audio et microphone client. En mode non optimisé, les périphériques sont mappés au VDA. Les périphériques apparaissent dans l’application Microsoft Teams comme s’ils étaient connectés localement au bureau virtuel.

    Pour déterminer si vous êtes en mode optimisé ou non optimisé lorsque vous regardez l’onglet Paramètres > Périphériques dans Teams, la différence la plus significative est le nom de la caméra. Si Microsoft Teams s’est chargé en mode non optimisé, les technologies HDX héritées sont lancées. Le nom de la webcam a le suffixe Citrix HDX, comme indiqué dans le graphique suivant. Les noms des périphériques haut-parleur et microphone peuvent être légèrement différents (ou tronqués) par rapport au mode optimisé.

Mode Annulation d'optimisation pour Microsoft Teams

Lorsque les technologies HDX héritées sont utilisées, Microsoft Teams ne décharge pas le traitement audio, vidéo et partage d’écran vers le moteur multimédia WebRTC de l’application Citrix Workspace du point de terminaison. Les technologies HDX utilisent le rendu côté serveur à la place. La consommation de CPU sur le VDA est élevée lorsque vous activez la vidéo. Les performances audio en temps réel peuvent ne pas être optimales.

Limitations connues

  • Vue Galerie - Haut-parleur actif uniquement.
  • Boutons HID - Réponse et fin de l’appel non pris en charge. Augmentation et baisse du volume sont pris en charge.
  • Lors de la commutation de l’entrée ou de la sortie du périphérique dans Paramètres > Périphériques en cours d’appel, vous pouvez rencontrer un problème audio d’une seconde.
  • Lorsque vous effectuez le partage d’écran dans des configurations multi-moniteurs, seul le moniteur principal est partagé.

Surveillance de Teams

Cette section fournit des instructions pour la surveillance de l’optimisation Microsoft Teams avec HDX. Si l’utilisateur exécute le mode optimisé et que HdxTeams.exe s’exécute sur la machine cliente, il existe un processus dans le VDA appelé WebSocketAgent.exe qui s’exécute dans la session. Utilisez le Gestionnaire d’activités dans Director pour afficher l’application.

Surveiller Teams dans le Gestionnaire d'activités

Avec la version minimale du VDA, 1912, vous pouvez surveiller les appels Teams actifs à l’aide de Citrix HDX Monitor (version minimale 3.11). L’ISO du produit Citrix Virtual Apps and Desktops contient la dernière version de hdxmonitor.msi dans le dossier layout\image-full\Support\HDX Monitor.

Pour plus d’informations, consultez la section Surveillance dans l’article CTX253754 du centre de connaissances.

Dépannage

Cette section fournit des conseils de dépannage pour les problèmes que vous pourriez rencontrer lors de l’utilisation de l’optimisation de Microsoft Teams. Pour de plus amples informations, consultez l’article CTX253754.

Sur le VDA

Quatre services sont installés par BCR_x64.msi. Seuls deux de ces services sont responsables de la redirection Microsoft Teams dans le VDA.

Quatre services installés par redirection de contenu du navigateur

  • Citrix HDX Teams Redirection Service établit le canal virtuel utilisé dans Microsoft Teams. Le service repose sur CtxSvcHost.exe.

  • Citrix HDX HTML5 Video Redirection Service s’exécute en tant que WebSocketService.exe en écoute sur 127.0.0.1:9002 TCP. WebSocketService.exe exécute deux fonctions principales :

    i. La terminaison TLS pour Secure WebSockets reçoit une connexion WebSocket sécurisée de vdiCitrixPeerConnection.js, qui est un composant de l’application Microsoft Teams. Vous pouvez le suivre avec le moniteur de processus. Pour plus d’informations sur les certificats, consultez la section « Redirection vidéo TLS et HTML5 et redirection du contenu du navigateur » sous Communications entre le Controller et le VDA.

    Certains logiciels de sécurité bureau et antivirus interfèrent avec le bon fonctionnement de WebSocketService.exe et de ses certificats. Bien que le service (Citrix HDX HTML5 Video Redirection) soit en cours d’exécution dans la console services.msc, le socket TCP 127.0.0.1:9002 de l’hôte local n’est jamais en mode d’écoute comme dans netstat. Lorsque vous essayez de redémarrer le service, il se bloque (« Arrêt… »). Veillez à appliquer les exclusions appropriées pour le processus WebScoketService.exe.

    Moniteur de processus

    ii. Mappage de session utilisateur. Lorsque l’application Microsoft Teams démarre, WebSocketService.exe démarre le processus WebSocketAgent.exe dans la session de l’utilisateur dans le VDA. WebSocketService.exe s’exécute dans la session 0 en tant que compte LocalSystem.

    Service WebSocketAgent.exe

    Vous pouvez utiliser netstat pour vérifier si le service WebSocketService.exe est dans un état d’écoute actif dans le VDA.

    Exécutez netstat -anob -p tcp à partir d’une fenêtre d’invite de commandes avec privilèges élevés :

    Exemple d'exécution de netstat

    En cas de connexion réussie, l’état passe à ESTABLISHED :

    Exemple de netstat réussi

Important :

WebSocketService.exe écoute deux sockets TCP, 127.0.0.1:9001 et 127.0.0.1:9002. Le port 9001 est utilisé pour la redirection du contenu du navigateur et la redirection vidéo HTML5. Le port 9002 est utilisé pour la redirection de Microsoft Teams. Assurez-vous que vous n’avez pas dans le système d’exploitation Windows du VDA de configurations proxy qui peuvent empêcher une communication directe entre Teams.exe et WebSocketService.exe. Parfois, lorsque vous configurez un proxy explicite dans Internet Explorer 11, (Options Internet > Connexions > Paramètres LAN > Serveur proxy), les connexions peuvent circuler via un serveur proxy attribué. Vérifiez que l’option Ne pas utiliser de serveur proxy pour les adresses locales est cochée si vous utilisez un paramètre proxy manuel et explicite.

Emplacements et descriptions des services

Service Chemin vers l’exécutable Ouvrir une session en tant que Description
Service de redirection vidéo Citrix HTML5 “C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service Compte Système local Fournit plusieurs services multimédia HDX avec l’infrastructure initiale requise pour effectuer la redirection de média entre le bureau virtuel et la machine de point de terminaison.
Service de redirection de navigateur Citrix HDX “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs Ce compte (service local) Permet de rediriger le contenu du navigateur entre la machine de point de terminaison et le bureau virtuel.
Service de transfert de port Citrix “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs Ce compte (service local) Permet de réacheminer le port entre la machine de point de terminaison et le bureau virtuel pour la redirection de contenu du navigateur.
Service de redirection de Teams Citrix HDX “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs Compte Système local Offre une redirection de Microsoft Teams entre la machine de point de terminaison et le bureau virtuel.

Application Citrix Workspace

Sur le point de terminaison de l’utilisateur, l’application Citrix Workspace pour Windows instancie un nouveau service appelé HdxTeams.exe. Elle le fait lorsque Microsoft Teams s’ouvre dans le VDA et que l’utilisateur tente d’appeler ou d’accéder à des périphériques en mode auto-aperçu. Si ce service ne s’affiche pas, vérifiez les points suivants :

  1. Assurez-vous que vous avez installé au minimum la version 1905 de l’application Workspace pour Windows. Voyez-vous HdxTeams.exe et les binaires webrpc.dll dans le chemin d’installation de l’application Workspace ?
  2. Si vous avez validé l’étape 1, procédez comme suit pour vérifier si HdxTeams.exe est lancé.
    1. Quittez Microsoft Teams sur le VDA.
    2. Démarrez services.msc sur le VDA.
    3. Arrêtez le service de Teams Citrix HDX.
    4. Déconnectez la session ICA.
    5. Connectez la session ICA.
    6. Démarrez le service de redirection de Teams Citrix HDX.
    7. Redémarrez le service de redirection vidéo Citrix HDX HTML5.
    8. Lancez Microsoft Teams sur le VDA.
  3. Si HdxTeams.exe n’est toujours pas lancé sur le point de terminaison client, procédez comme suit :
    1. Redémarrez le VDA.
    2. Redémarrez le point de terminaison client.

Assistance

Citrix et Microsoft prennent conjointement en charge la mise à disposition de Microsoft Teams à partir de Citrix Virtual Apps and Desktops à l’aide de l’optimisation pour Microsoft Teams. Cette prise en charge conjointe est le résultat d’une étroite collaboration entre les deux entreprises. Si vous avez des contrats de support valides et que vous rencontrez un problème avec cette solution, ouvrez un ticket de support avec le fournisseur dont le code semble être à l’origine du problème. Autrement dit, Microsoft pour Teams ou Citrix pour les composants d’optimisation.

Citrix ou Microsoft reçoit le ticket, trie le problème et escalade le cas échéant. Vous n’avez pas besoin de contacter l’équipe de support de chaque entreprise.

Lorsque vous rencontrez un problème, nous vous recommandons de cliquer sur Aide > Signaler un problème dans l’interface utilisateur de Teams. Les journaux côté VDA sont automatiquement partagés entre Citrix et Microsoft pour résoudre les problèmes techniques plus rapidement.

Collecte des journaux

Les journaux HDXTeams.exe se trouvent sur la machine de l’utilisateur dans %TEMP% dans le dossier HDXTeams (AppData/Local/Temp/HDXTeams). Recherchez un fichier .txt appelé webrpc_Day_Month_timestamp_Year.txt.

Lors de l’établissement d’un appel, ces quatre phases de l’ICE sont requises :

  • Récupération des candidats
  • échange de candidats
  • Vérifications de connectivité (demandes de liaison STUN)
  • Promotion des candidats

Dans les journaux HdxTeams.exe, les entrées suivantes sont les entrées ICE (Interactive Connectivity Establishment) pertinentes. Ces entrées doivent être là pour qu’un appel réussisse (voir cet exemple pour la phase de récupération) :

RPCStubs Info: -> device id = \\?\display#int3470#4&1835d135&0&uid13424#{65e8773d-8f56-11d0-a3b9-00a0c9223196}{bf89b5a5-61f7-4127-a279-e187013d7caf} label = Microsoft Camera Front groupId =

webrtcapi.RTCPeerConnection Info: createOffer. audio = 1 video = 1
webrtcapi.RTCPeerConnection Info: setLocalDescription.
>>> begin:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnSignalingChange. signaling state = HaveLocalOffer

webrtcapi.RTCPeerConnection Info: OnIceGatheringChange. state = Gathering

[…]
>>> begin:sdp
candidate:840548147 1 udp 2122194687 10.108.124.215 56927 typ host generation 0 ufrag oVk6 network-id 1
<<< end:sdp
[…]
>>> begin:sdp
candidate:1938109490 1 udp 24911871 52.114.xxx.xxx 52786 typ relay raddr 73.205.xxx.x rport 25651 generation 0 ufrag dDML network-id 1 network-cost 10
<<< end:sdp
[…]
>>> begin:sdp
candidate:4271145120 1 udp 1685987071 66.xxx.xxx.xxx 55839 typ srflx raddr 10.108.124.215 rport 55839 generation 0 ufrag uAVH network-id 1
<<< end:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnIceGatheringChange. state = Complete webrtcapi.RTCPeerConnection Info: setRemoteDescription.
>>> begin:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnSignalingChange. signaling state = HaveRemotelOffer

S’il y a plusieurs candidats ICE, l’ordre de préférence est :

  1. hôte
  2. réflexion homologue
  3. réflexion serveur
  4. relais de transport

Si vous rencontrez un problème et que vous pouvez le reproduire, nous vous recommandons de cliquer sur Aide > Signaler un problème dans Teams. Les journaux sont partagés entre Citrix et Microsoft pour résoudre les problèmes techniques si vous avez ouvert un dossier avec Microsoft. La capture de traces CDF avant de contacter le support Citrix est également recommandée. Pour plus d’informations, consultez l’article CDFcontrol du centre de connaissances.

Pour obtenir des recommandations sur la collecte des traces CDF, consultez l’article du centre de connaissances Recommandations pour la collecte des traces CDF.

Traces CDF côté VDA - Activez les fournisseurs de traces CDF suivants :

Traces CDF côté VDA

Traces CDF côté application Workspace - Activez les fournisseurs de traces CDF suivants :

Traces CDF côté application Workspace