Résoudre les problèmes liés au cache connecté Microsoft pour les entreprises et l’éducation

• S’applique à:

  ✅ Windows 11, ✅ Supported Linux distributions, ✅ Microsoft Connected Cache for Enterprise

Cet article contient des instructions sur la façon de résoudre les différents problèmes que vous pouvez rencontrer lors de l’utilisation du cache connecté. Ces problèmes sont classés par tâche dans laquelle ils peuvent être rencontrés.

Problèmes connus

Cette section décrit les problèmes connus liés à la dernière version de Microsoft Connected Cache for Enterprise and Education. Pour plus d’informations sur les correctifs inclus dans la dernière version, consultez la page Notes de publication.

Le provisionmcconwsl.ps1 de script échoue lorsqu’il est exécuté sur un ordinateur hôte Windows 11 configuré pour utiliser la langue japonaise

Dans le script d’installation du cache connecté (provisionmcconwsl.ps1), le traitement case activée est exécuté jusqu’à ce que la valeur du dernier code d’exécution (dernier résultat) de la tâche d’installation devienne 0 dans le traitement suivant. Toutefois, dans le système d’exploitation japonais, la valeur de retour est null, car « Dernier résultat » s’affiche et une exception se produit.

Comme solution de contournement temporaire, l’erreur ci-dessus ne se produit pas en remplaçant le paramètre de langue de l’utilisateur administrateur local du japonais par l’anglais, puis en exécutant le script.

Étapes d’obtention d’un ID d’abonnement Azure

1. Connectez-vous au Portail Azure.
2. Sélectionnez Abonnements. Si vous ne voyez pas Abonnements, tapez Abonnements dans la barre de recherche. Lorsque vous commencez à taper, la liste filtre en fonction de votre entrée.
3. Si vous disposez déjà d’un abonnement Azure, passez à l’étape 5. Si vous n’avez pas d’abonnement Azure, sélectionnez + Ajouter en haut à gauche.
4. Sélectionnez l’abonnement Paiement à l’utilisation . Vous serez invité à entrer des informations de crédit carte, mais vous ne serez pas facturé pour l’utilisation du service Microsoft Connected Cache.
5. Dans la page Abonnements , vous trouverez des détails sur votre abonnement actuel. Sélectionnez le nom de l’abonnement.
6. Une fois que vous avez sélectionné le nom de l’abonnement, vous trouverez l’ID d’abonnement sous l’onglet Vue d’ensemble . Sélectionnez l’icône Copier dans le Presse-papiers en regard de votre ID d’abonnement pour copier la valeur.

Résolution des problèmes de création de ressources Azure

La création de ressources Azure du cache connecté peut être lancée à l’aide de l’interface utilisateur Portail Azure ou du jeu de commandes Azure CLI.

Si vous rencontrez une erreur lors de la création de la ressource, case activée que vous disposez des autorisations nécessaires pour créer des ressources Azure dans le cadre de votre abonnement et que vous avez rempli tous les champs obligatoires pendant le processus de création de la ressource.

Résolution des problèmes de configuration du nœud de cache

La configuration de votre nœud De cache connecté peut être effectuée à l’aide de l’interface utilisateur Portail Azure ou de l’ensemble de commandes Azure CLI.

Si vous rencontrez une erreur de validation, case activée que vous avez rempli tous les champs de configuration requis.

Si votre configuration ne semble pas prendre effet, case activée que vous avez sélectionné l’option Enregistrer en haut de la page de configuration dans l’interface utilisateur Portail Azure.

Si vous avez modifié la configuration du proxy, vous devez reprovisionner le logiciel de cache connecté sur l’ordinateur hôte pour que la configuration du proxy prenne effet.

Résolution des problèmes de nœuds de cache créés lors de la préversion initiale

Les nœuds de cache créés et déployés pendant la préversion préliminaire de Microsoft Connected Cache pour Entreprise et Éducation doivent continuer à fonctionner, mais ne peuvent plus être gérés ou surveillés à distance via le service Azure de cache connecté.

Par conséquent, nous vous recommandons vivement de recréer vos ressources existantes dans Azure , puis de redéployer le logiciel de cache connecté sur vos machines hôtes à l’aide du dernier programme d’installation spécifique au système d’exploitation.

Résolution des problèmes de déploiement de nœud de cache sur l’ordinateur hôte Windows

Collecte des journaux d’installation hébergés par Windows

Le déploiement d’un nœud Cache connecté sur un ordinateur hôte Windows implique l’exécution d’une série de scripts PowerShell contenus dans le package d’approvisionnement Windows. Ces scripts tentent d’écrire des fichiers journaux dans le répertoire d’installation spécifié dans la commande d’approvisionnement (C:\mccwsl01\InstallLogs par défaut).

Il existe trois types de fichiers journaux d’installation :

1. WSL_Mcc_Install_Transcript : ce fichier journal enregistre les lignes imprimées dans la fenêtre PowerShell lors de l’exécution du script d’installation
2. WSL_Mcc_Install_FromRegisteredTask_Status : ce fichier journal enregistre les status de haut niveau écrites pendant l’installation des tâches inscrites
3. WSL_Mcc_Install_FromRegisteredTask_Transcript : ce fichier journal enregistre les status détaillées écrites pendant l’installation des tâches inscrites

La transcription de la tâche inscrite est généralement la plus utile pour diagnostiquer le problème d’installation.

Collecte d’autres journaux hébergés par Windows

Une fois que le nœud de cache a été correctement installé sur l’ordinateur hôte Windows, il écrit régulièrement des fichiers journaux dans le répertoire d’installation (C:\mccwsl01\ par défaut).

Vous pouvez vous attendre à voir les types de fichiers journaux suivants :

1. WSL_Mcc_Monitor_FromRegisteredTask_Transcript : ce fichier journal enregistre la sortie de la tâche planifiée « MCC_Monitor_Task » chargée de s’assurer que le cache connecté continue de s’exécuter.
2. WSL_Mcc_UserUninstall_Transcript : ce fichier journal enregistre la sortie du script « uninstallmcconwsl.ps1 » que l’utilisateur peut exécuter pour désinstaller le logiciel MCC de l’ordinateur hôte.
3. WSL_Mcc_Uninstall_FromRegisteredTask_Transcript : ce fichier journal enregistre la sortie de la tâche planifiée « MCC_Uninstall_Task » chargée de désinstaller le logiciel MCC de l’ordinateur hôte lorsqu’elle est appelée par le script « uninstallmcconwsl.ps1 ».

stratégie de groupe l’objet est en conflit avec l’inscription de tâches planifiées

L’activation de l’objet stratégie de groupe : Accès réseau : Ne pas autoriser le stockage des mots de passe et des informations d’identification pour l’authentification réseau empêche le logiciel du cache connecté d’inscrire les tâches planifiées nécessaires à la réussite de l’inscription et du fonctionnement des nœuds de cache.

L’installation de WSL2 échoue avec le message « Une session d’ouverture de session spécifiée n’existe pas »

Si vous rencontrez ce message d’échec lors de la tentative d’exécution de la commande wsl.exe --install --no-distribution PowerShell sur votre ordinateur hôte Windows, vérifiez que vous êtes connecté en tant qu’administrateur local et que vous exécutez la commande à partir d’une fenêtre PowerShell avec élévation de privilèges.

Mise à jour du noyau WSL2

Si l’installation du cache connecté échoue en raison de problèmes liés à WSL, essayez d’exécuter wsl.exe --update pour obtenir la dernière version du noyau WSL.

Vérification si le conteneur de cache connecté est en cours d’exécution

Une fois que le logiciel de cache connecté a été correctement déployé sur l’ordinateur hôte Windows, vous pouvez case activée si le nœud de cache s’exécute correctement en procédant comme suit sur l’ordinateur hôte Windows :

1. Lancez un processus PowerShell en tant que compte spécifié en tant que compte d’exécution pendant l’installation du cache connecté
2. Exécutez wsl -d Ubuntu-24.04-Mcc-Base pour accéder à la distribution Linux qui héberge le conteneur de cache connecté
3. Exécuter sudo iotedge list pour afficher les conteneurs en cours d’exécution dans le runtime IoT Edge

S’il affiche les conteneurs edgeAgent et edgeHub, mais n’affiche pas MCC, vous pouvez afficher les status du gestionnaire de sécurité IoT Edge à l’aide sudo iotedge system logs -- -fde .

Vous pouvez également redémarrer le runtime IoT Edge à l’aide de sudo systemctl restart iotedge.

Vérification des tâches planifiées du cache connecté

Une fois le conteneur de cache connecté en cours d’exécution, une tâche planifiée est exécutée régulièrement sous le compte d’exécution du cache connecté pour empêcher WSL de nettoyer le conteneur de cache connecté.

Vous pouvez utiliser le planificateur de tâches sur l’ordinateur hôte pour case activée la status de cette tâche planifiée.

1. Ouvrir le planificateur de tâches sur l’ordinateur hôte
2. Accédez à la section Tâches actives et double-cliquez sur MCC_Monitor_Task
3. Sélectionnez la tâche planifiée MCC_Monitor_Task
4. Sélectionnez l’onglet Déclencheurs et vérifiez que l’état est Activé

Remarque

Si le mot de passe du compte d’exécution change, vous devez mettre à jour l’utilisateur dans toutes les tâches planifiées du cache connecté afin que le nœud Cache connecté continue de fonctionner correctement.

Nœud de cache correctement déployé, mais ne répondant pas aux demandes

Si votre nœud de cache ne répond pas aux requêtes en dehors de localhost, cela peut être dû au fait que les règles de transfert de port de l’ordinateur hôte n’ont pas été correctement définies lors de l’installation du cache connecté. Étant donné que WSL 2 utilise une carte Ethernet virtualisée par défaut, des règles de transfert de port sont nécessaires pour autoriser le trafic à atteindre le instance WSL 2 à partir de votre réseau local. Pour plus d’informations, consultez Accès aux applications réseau avec WSL.

Pour case activée les règles de transfert de port de votre ordinateur hôte, utilisez la commande PowerShell suivante.

netsh interface portproxy show v4tov4

Si vous ne voyez aucune règle de transfert de port pour le port 80 vers 0.0.0.0, vous pouvez exécuter la commande suivante à partir d’un instance PowerShell avec élévation de privilèges pour définir le transfert approprié vers WSL.

netsh interface portproxy add v4tov4 listenport=80 listenaddress=0.0.0.0 connectport=80 connectaddress=<WSL IP Address>

Vous pouvez récupérer l’adresse IP WSL à partir du wslip.txt fichier qui doit être présent dans le répertoire d’installation que vous avez spécifié dans la commande d’approvisionnement du cache connecté (« c :\mccwsl01 » par défaut).

Résolution des problèmes de déploiement de nœud de cache sur un ordinateur hôte Linux

Le déploiement d’un nœud de cache connecté sur un ordinateur hôte Linux implique l’exécution d’une série de scripts Bash contenus dans le package d’approvisionnement Linux.

Une fois que le logiciel de cache connecté a été correctement déployé sur l’ordinateur hôte Linux, vous pouvez case activée si le nœud de cache s’exécute correctement en procédant comme suit sur l’ordinateur hôte Linux :

1. Exécuter sudo iotedge list pour afficher les conteneurs en cours d’exécution dans le runtime IoT Edge

S’il affiche les conteneurs edgeAgent et edgeHub, mais n’affiche pas MCC, vous pouvez afficher les status du gestionnaire de sécurité IoT Edge à l’aide sudo iotedge system logs -- -fde .

Vous pouvez également redémarrer le runtime IoT Edge à l’aide de sudo systemctl restart iotedge.

Génération d’un bundle de prise en charge des diagnostics de nœud de cache

Vous pouvez générer un bundle de support avec des informations de diagnostic détaillées en exécutant le collectMccDiagnostics.sh script inclus dans le package d’installation.

Pour les machines hôtes Windows, vous devez effectuer les opérations suivantes :

1. Lancez un processus PowerShell en tant que compte spécifié en tant que compte d’exécution pendant l’installation du cache connecté

2. Remplacez le répertoire « MccScripts » dans le package d’approvisionnement du cache connecté extrait et vérifiez la présence de collectmccdiagnostics.sh

3. Exécuter wsl bash collectmccdiagnostics.sh pour générer le bundle de prise en charge des diagnostics

4. Une fois le script terminé, notez la sortie de la console décrivant l’emplacement du bundle de prise en charge des diagnostics

   Par exemple, « Package correctement compressé, envoyez le fichier créé à l’adresse /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz »

5. Exécutez la wsl cp commande pour copier le bundle de prise en charge à partir de l’emplacement de la distribution Ubuntu vers le système d’exploitation hôte Windows

   Par exemple wsl cp /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz /mnt/c/mccwsl01/SupportBundles

Pour les machines hôtes Linux, vous devez effectuer les opérations suivantes :

1. Remplacez le répertoire « MccScripts » dans le package d’approvisionnement du cache connecté extrait et vérifiez la présence de collectmccdiagnostics.sh

2. Exécuter collectmccdiagnostics.sh pour générer le bundle de prise en charge des diagnostics

3. Une fois le script terminé, notez la sortie de la console décrivant l’emplacement du bundle de prise en charge des diagnostics

   Par exemple, « Package correctement compressé, envoyez le fichier créé à l’adresse /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz »

Résolution des problèmes de surveillance des nœuds de cache

Les performances et les status des nœuds du cache connecté peuvent être surveillées à l’aide de l’interface utilisateur Portail Azure.

Si les visuels de surveillance de base de l’onglet Vue d’ensemble affichent des valeurs inattendues ou erronées, actualisez la fenêtre du navigateur.

Si le problème persiste, case activée que vous avez configuré les filtres de nœud Intervalle de temps et Cache comme vous le souhaitez.

Diagnostiquer et résoudre

Vous pouvez également utiliser la fonctionnalité Diagnostiquer et résoudre les problèmes fournie par l’interface Portail Azure. Cet onglet dans la ressource Azure Cache connecté Microsoft vous guide à travers quelques invites pour vous aider à affiner la solution à votre problème.