Résoudre les problèmes de synchronisation de fichiers Azure

Vous pouvez utiliser Azure File Sync pour centraliser les partages de fichiers de votre organisation dans Azure Files tout en conservant la flexibilité, le niveau de performance et la compatibilité d’un serveur de fichiers local. Cet article est destiné à vous aider à dépanner et à résoudre les problèmes que vous pouvez rencontrer avec le déploiement d’Azure File Sync. Nous vous y expliquons également comment collecter des journaux d’activité du système qui sont utiles pour analyser les problèmes rencontrés de manière plus approfondie.

Documentation courante sur la résolution des problèmes

En fonction du problème que vous rencontrez, consultez la documentation de résolution des problèmes appropriée :

Si vous ne savez pas où commencer, consultez les premières étapes de résolution des problèmes généraux.

Premières étapes de résolution générale des problèmes

Si vous rencontrez des problèmes avec Azure File Sync, commencez par effectuer les étapes suivantes :

1. Recherchez les erreurs à l’aide des journaux d’événements ou de Portail Azure sur le serveur. Pour plus d’informations sur la façon d’afficher l’intégrité de votre environnement Azure File Sync à l’aide des journaux des Portail Azure ou des événements, consultez Surveiller Azure File Sync.
2. Vérifiez que le service Azure File Sync s’exécute sur le serveur :
   • Ouvrez le composant logiciel enfichable MMC des services et vérifiez que le service de l’Agent de synchronisation du stockage (FileSyncSvc) est en cours d’exécution. Si le service n’est pas en cours d’exécution et ne parvient pas à démarrer, consultez le service De l’agent de synchronisation de stockage (FileSyncSvc) ne parvient pas à démarrer.
3. Vérifiez que les pilotes de filtre Azure File Sync (StorageSync.sys et StorageSyncGuard.sys) s’exécutent sur le serveur :
   • À partir d’une invite de commandes avec élévation de privilèges, exécutez fltmc. Vérifiez que les pilotes de filtre de système de fichiers StorageSync.sys et StorageSyncGuard.sys sont répertoriés.
4. Utilisez l’applet de commande Debug-StorageSyncServer sur le serveur pour rechercher les problèmes courants.

Applet de commande Debug-StorageSyncServer

L’applet Debug-StorageSyncServer de commande diagnostiquera les problèmes courants sur le serveur Azure File Sync, tels que la configuration incorrecte du certificat et l’heure incorrecte du serveur. Nous avons également simplifié la résolution des problèmes Azure File Sync en fusionnant les fonctionnalités de certains scripts et applets de commande existants (AFSDiag.ps1 commande.

Pour exécuter les diagnostics sur le serveur, exécutez les commandes PowerShell suivantes :

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -Diagnose

Pour tester la connectivité réseau sur le serveur, exécutez les commandes PowerShell suivantes :

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -TestNetworkConnectivity

Pour identifier les fichiers qui ne parviennent pas à se synchroniser sur le serveur, exécutez les commandes PowerShell suivantes :

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -FileSyncErrorsReport

Pour collecter les journaux et les traces sur le serveur, exécutez les commandes PowerShell suivantes :

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose

Comment collecter des journaux et des traces sur le serveur Azure File Sync

Si votre problème n’est pas résolu après avoir suivi les étapes décrites dans la documentation de résolution des problèmes, exécutez l’outil AFSDiag et envoyez sa sortie de fichier .zip à l’ingénieur du support affecté à votre cas pour un diagnostic plus approfondi.

Pour exécuter AFSDiag, procédez comme suit :

1. Ouvrez une fenêtre PowerShell avec élévation de privilèges, puis exécutez les commandes suivantes (appuyez sur Entrée après chaque commande) :

   Notes

   AFSDiag crée le répertoire de sortie et un dossier temporaire au sein de celui-ci avant de collecter les journaux, puis supprime le dossier temporaire une fois l’opération terminée. Spécifiez un emplacement de sortie qui ne contient pas de données.

   Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
   Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose
   

2. Reproduisez le problème. Lorsque vous avez terminé, entrez D.

3. Un fichier .zip contenant les journaux d’activité et les fichiers de trace est enregistré dans le répertoire de sortie que vous avez spécifié.

Le service De l’agent de synchronisation de stockage (FileSyncSvc) ne parvient pas à démarrer

Après avoir installé ou mis à niveau l’agent Azure File Sync (v18 ou version ultérieure), vous pouvez rencontrer l’un des symptômes suivants :

• Le service De l’Agent de synchronisation de stockage (FileSyncSvc) ne parvient pas à commencer par l’erreur suivante :

  Error 0x80070057: The parameter is incorrect. 
  

• L’inscription d’un serveur à l’aide de l’applet Register-AzStorageSyncServer de commande échoue avec l’erreur suivante :

  Register-AzStorageSyncServer: Exception of type 'Commands.StorageSync.Interop.Exceptions.ServerRegistrationException' was thrown.
  

• ServerRegistration.exe ou AfsUpdater.exe ne parvient pas à s’ouvrir

• L’installation de l’agent échoue. Le journal d’installation affiche le code d’erreur 0x80c84111 avec le message suivant :

  Exception occurred while configuring MitigationRedirection policy. This could indicate that required windows updates not installed on the computer.
  

Ces problèmes se produisent car l’agent Azure File Sync a une dépendance sur une fonctionnalité de sécurité Windows et les mises à jour de cette fonctionnalité de sécurité ne sont pas installées.

Pour résoudre ce problème, vérifiez que vos mises à jour Windows Server sont installées :

• Catalogue Microsoft Update Windows Server 2016 (dernière mise à jour cumulative)

• Catalogue Microsoft Update Windows Server 2019 (dernière mise à jour cumulative)

  Les mises à jour cumulatives sont publiées mensuellement. Pour déployer la dernière mise à jour, vous pouvez utiliser Windows Update ou le télécharger à partir du catalogue Microsoft Update. Avant l’installation manuelle, passez en revue l’article de la Base de connaissances associée pour vérifier que toutes les conditions préalables sont remplies.Si les mises à jour Windows ne sont pas installées avant d’installer l’agent Azure File Sync, le service Agent de synchronisation de stockage (FileSyncSvc) ne démarre pas.

La mise à jour automatique ne peut pas mettre à niveau un agent Azure File Sync « à expirer » ou expiré

Si la mise à jour automatique ne parvient pas à mettre à niveau votre agent Azure File Sync sur le point d’expirer ou a expiré, vérifiez que les informations d’expiration de l’agent sont correctement appliquées au serveur. Les métadonnées d’expiration sont requises pour que la mise à jour automatique fonctionne comme prévu.

Pour vérifier si les AgentExpirationDate métadonnées sont définies, exécutez la commande suivante à partir d’une session PowerShell avec élévation de privilèges :

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Get-StorageSyncServer

Si les AgentExpirationDate métadonnées ne sont pas définies ou que sa valeur est vide, il peut y avoir un problème réseau qui empêche le serveur de recevoir les données d’expiration. Pour tester la connectivité réseau, exécutez la commande suivante :

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Test-StorageSyncNetworkConnectivity

Si des problèmes de connectivité réseau sont signalés, vous pouvez mettre à jour manuellement l’agent en le téléchargeant à partir du catalogue Microsoft Update.

Après avoir téléchargé la version appropriée de l’agent, reportez-vous à l'article spécifique de la base de connaissances dans le catalogue pour obtenir des instructions d’installation étape par étape.

S’il n’existe aucun problème de connectivité et que les AgentExpirationDate métadonnées ne sont toujours pas définies, contactez la prise en charge d’Azure File Sync pour obtenir une assistance supplémentaire.

Utilisation élevée de la mémoire sur le serveur

Azure File Sync utilise des bases de données ESE (Extensible Storage Engine) pour la synchronisation et la hiérarchisation cloud. Les bases de données ESE peuvent consommer jusqu’à 80 % de la mémoire système pour améliorer les performances. Pour limiter la quantité de mémoire utilisée par les bases de données ESE, vous pouvez configurer le MaxESEDbCachePercent paramètre de Registre sur le serveur.

Pour réduire la limite d’utilisation de la mémoire ESE à 60 %, qui est un bon équilibre entre l’utilisation de la mémoire et le cache suffisant pour maintenir des performances décentes des bases de données, exécutez la commande suivante à partir d’une invite de commandes avec élévation de privilèges :

REG ADD HKLM\Software\Microsoft\Azure\StorageSync /v MaxESEDbCachePercent /t REG_DWORD /d 60

Une fois le paramètre de MaxESEDbCachePercent Registre créé, redémarrez le service FileSyncSvc (Storage Sync Agent).

Voir aussi

• Superviser Azure File Sync
• Dépanner Sauvegarde Azure
• Résoudre les problèmes de niveau de performance d’Azure Files

Contactez-nous pour obtenir de l’aide

Si vous avez des questions, vous pouvez demander le support de la communauté Azure. Vous pouvez également soumettre des commentaires sur les produits à la communauté de commentaires Azure.