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

  • Article

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 :

Problèmes Documentation sur la résolution des problèmes
Problèmes d’installation ou d’inscription de serveur de l’agent Résoudre les problèmes liés à l’installation de l’agent Azure File Sync et à l’inscription du serveur
Problèmes de création de point de terminaison cloud ou de point de terminaison de serveur, ou le serveur inscrit est hors connexion Résoudre les problèmes liés à la gestion des groupes de synchronisation Azure File Sync
Le point de terminaison du serveur a un état d’erreur ou les fichiers ne parviennent pas à se synchroniser Résoudre les erreurs et l’intégrité de synchronisation Azure File Sync
Les fichiers ne sont pas hiérarchisé ou rappelés Résoudre les problèmes liés à la hiérarchisation cloud Azure File Sync
Le service De l’agent de synchronisation de stockage (FileSyncSvc) ne parvient pas à démarrer Résoudre les problèmes d’Azure File Sync
Utilisation élevée de la mémoire sur le serveur Résoudre les problèmes d’Azure File Sync

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 :
  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, FileSyncErrorsReport.ps1 et Test-StorageSyncNetworkConnectivity) dans l’applet Debug-StorageSyncServer de 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 (v17.3 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 de commande Register-AzStorageSyncServer é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

Ce problème se produit, car l’agent Azure File Sync dépend d’une fonctionnalité de sécurité Windows et des mises à jour pour 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 :

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

Contactez-nous pour obtenir de l’aide

Pour toute demande ou assistance, créez une demande de support ou posez une question au support de la communauté Azure. Vous pouvez également soumettre des commentaires sur les produits à la communauté de commentaires Azure.