Partager via

Résoudre les problèmes liés à Azure File Sync

  • Article

Vous pouvez utiliser Azure File Sync pour centraliser les partages de fichiers de votre organisation dans Azure Files, tout en conservant la flexibilité, les performances et la compatibilité d’un serveur de fichiers local. Cet article est conçu pour vous aider à résoudre les problèmes que vous pouvez rencontrer avec votre déploiement Azure File Sync. Nous décrivons également comment collecter des journaux importants à partir du système si une investigation plus approfondie du problème est nécessaire.

Documentation de dépannage courante

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

Problèmes Documentation de résolution des problèmes
Problèmes d’installation de l’agent ou d’inscription de serveur Résoudre les problèmes d’installation et d’inscription de serveur de l’agent Azure File Sync
Problèmes de création de point de terminaison de serveur ou de point de terminaison cloud, ou le serveur inscrit est hors connexion Résoudre les problèmes de gestion des groupes de synchronisation Azure File Sync
Le point de terminaison de serveur présente un état d’erreur ou la synchronisation des fichiers échoue Résoudre les problèmes d’intégrité et d’erreurs de synchronisation Azure File Sync
Échec de hiérarchisation ou de rappel des fichiers Résoudre les problèmes de hiérarchisation cloud Azure File Sync
Utilisation élevée de la mémoire sur le serveur Résoudre les problèmes liés à Azure File Sync

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

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

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

  1. Recherchez les erreurs à l’aide du portail Azure ou des journaux d’événements sur le serveur. Pour plus d’informations sur la façon d’afficher l’intégrité de votre environnement Azure File Sync à l’aide du portail Azure ou des journaux des événements, consultez Surveiller Azure File Sync.
  2. Vérifiez que le service Azure File Sync est en cours d’exécution sur le serveur :
    • Ouvrez le composant logiciel enfichable MMC Services et vérifiez que le service Agent de synchronisation de stockage (FileSyncSvc) est en cours d’exécution.
  3. Vérifiez que les pilotes de filtre Azure File Sync (StorageSync.sys et StorageSyncGuard.sys) s’exécutent sur le serveur :
    • À une invite de commandes avec élévation de privilèges, exécutez fltmc. Vérifiez que les pilotes de filtre de système de fichiersStorageSync.syset 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 du serveur incorrecte. 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.ps1et Test-StorageSyncNetworkConnectivity) dans l’applet Debug-StorageSyncServer de commande.

Pour exécuter des 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 technique 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) :

    Remarque

    AFSDiag crée le répertoire de sortie et un dossier temporaire dans celui-ci avant de collecter les journaux et supprime le dossier temporaire après l’exécution. 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 qui contient des journaux et des fichiers de trace est enregistré dans le répertoire de sortie que vous avez spécifié.

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 paramètre de MaxESEDbCachePercent Registre sur le serveur.

Pour réduire la limite d’utilisation de la mémoire ESE à 60 %, ce qui est un bon équilibre entre l’utilisation de la mémoire et un 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 Agent de synchronisation de stockage (FileSyncSvc).

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.