Résoudre les problèmes d’intégrité et d’erreurs de synchronisation Azure File Sync

Cet article est conçu pour vous aider à résoudre les problèmes de synchronisation courants que vous pouvez rencontrer avec votre déploiement Azure File Sync.

Intégrité de la synchronisation

Si j’ai créé un fichier directement dans mon partage de fichiers Azure via SMB ou via le portail, combien de temps faut-il pour que le fichier soit synchronisé avec les serveurs du groupe de synchronisation ?

Les modifications apportées au partage de fichiers Azure à l’aide du portail Azure ou de SMB ne sont pas immédiatement détectées et répliquées comme les modifications apportées au point de terminaison du serveur. Azure Files n’a pas encore de notifications de modification ou de journalisation. Il n’existe donc aucun moyen de lancer automatiquement une session de synchronisation lorsque des fichiers sont modifiés. Sur Windows Server, Azure File Sync utilise la journalisation USN Windows pour lancer automatiquement une session de synchronisation en cas de modification des fichiers.

Pour détecter les modifications apportées au partage de fichiers Azure, Azure File Sync dispose d’un travail planifié appelé travail de détection des modifications. Un travail de détection des modifications énumère chaque fichier dans le partage de fichiers, puis le compare à la version de synchronisation de ce fichier. Lorsque le travail de détection des modifications détermine que les fichiers ont changé, Azure File Sync lance une session de synchronisation. Le travail de détection des modifications est lancé toutes les 24 heures. Étant donné que le travail de détection des modifications fonctionne en énumérant chaque fichier dans le partage de fichiers Azure, la détection des modifications prend plus de temps dans les espaces de noms plus grands que dans les espaces de noms plus petits. Pour les espaces de noms volumineux, la détermination des fichiers qui ont changé peut prendre plus de temps qu’une fois toutes les 24 heures.

Pour synchroniser immédiatement les fichiers modifiés dans le partage de fichiers Azure, l’applet Invoke-AzStorageSyncChangeDetection de commande PowerShell peut être utilisée pour lancer manuellement la détection des modifications dans le partage de fichiers Azure. Cette applet de commande est destinée aux scénarios où un certain type de processus automatisé apporte des modifications dans le partage de fichiers Azure ou où les modifications sont effectuées par un administrateur (comme le déplacement de fichiers et de répertoires dans le partage). Pour les modifications apportées à l’utilisateur final, il est recommandé d’installer l’agent Azure File Sync sur une machine virtuelle IaaS et de demander aux utilisateurs finaux d’accéder au partage de fichiers via la machine virtuelle IaaS. De cette façon, toutes les modifications se synchronisent rapidement avec d’autres agents sans avoir à utiliser l’applet de Invoke-AzStorageSyncChangeDetection commande. Pour plus d’informations, consultez la documentation Invoke-AzStorageSyncChangeDetection .

Nous explorons l’ajout de la détection des modifications pour un partage de fichiers Azure similaire à USN pour les volumes sur Windows Server. Aidez-nous à hiérarchiser cette fonctionnalité pour le développement futur en la votant dans commentaires de la communauté Azure.

L’intégrité du point de terminaison de serveur est en attente pendant plusieurs heures

Ce problème est attendu si vous créez un point de terminaison cloud et utilisez un partage de fichiers Azure qui contient des données. Le travail d’énumération des modifications cloud qui recherche les modifications dans le partage de fichiers Azure doit se terminer avant que les fichiers puissent être synchronisés entre les points de terminaison cloud et serveur. La durée d’exécution du travail dépend de la taille de l’espace de noms dans le partage de fichiers Azure. L’intégrité du point de terminaison de serveur doit être mise à jour une fois le travail d’énumération de modification terminé.

Pour vérifier l’état du travail d’énumération des modifications cloud, accédez aux propriétés du point de terminaison cloud dans le portail et l’état est fourni dans la section Modifier l’énumération .

Comment surveiller l’intégrité de la synchronisation ?

Replica Sync session completed.
SyncDirection: Upload,
HResult: 0, 
SyncFileCount: 2, SyncDirectoryCount: 0,
AppliedFileCount: 2, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0,
TransferredFiles: 2, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

Replica Sync session completed.
SyncDirection: Upload,
HResult: -2134364065,
SyncFileCount: 0, SyncDirectoryCount: 0, 
AppliedFileCount: 0, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0, 
TransferredFiles: 0, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

Comment surveiller la progression d’une session de synchronisation en cours ?

Replica Sync Progress. 
ServerEndpointName: <CI>sename</CI>, SyncGroupName: <CI>sgname</CI>, ReplicaName: <CI>rname</CI>, 
SyncDirection: Upload, CorrelationId: {AB4BA07D-5B5C-461D-AAE6-4ED724762B65}. 
AppliedItemCount: 172473, TotalItemCount: 624196. AppliedBytes: 51473711577, 
TotalBytes: 293363829906. 
AreTotalCountsFinal: true. 
PerItemErrorCount: 1006.

Comment savoir si mes serveurs sont synchronisés les uns avec les autres ?

Comment puis-je voir s’il existe des fichiers ou dossiers spécifiques qui ne sont pas synchronisés ?

Si le nombre d’erreurs de synchronisation persistante et d’erreurs de synchronisation temporaires dans le portail ou PerItemErrorCount sur le serveur est supérieur à 0 pour une session de synchronisation donnée, cela signifie que la synchronisation de certains éléments échoue. Les fichiers et dossiers peuvent avoir des caractéristiques qui les empêchent de se synchroniser. Ces caractéristiques peuvent être persistantes et nécessiter une action explicite pour reprendre la synchronisation, par exemple en supprimant les caractères non pris en charge du nom du fichier ou du dossier. Ils peuvent également être temporaires, ce qui signifie que le fichier ou le dossier reprend automatiquement la synchronisation ; Par exemple, les fichiers avec des descripteurs ouverts reprennent automatiquement la synchronisation lorsque le fichier est fermé. Lorsque le moteur Azure File Sync détecte un tel problème, un journal des erreurs est généré et peut être analysé pour répertorier les éléments qui ne se synchronisent pas correctement.

Pour afficher les noms des fichiers et répertoires qui ne parviennent pas à se synchroniser, exécutez le script PowerShell FileSyncErrorsReport.ps1 (situé dans le répertoire d’installation de l’agent Azure File Sync) ou utilisez l’applet de Debug-StorageSyncServer commande . Le ItemPath champ indique l’emplacement du fichier par rapport au répertoire de synchronisation racine. Consultez la liste des erreurs courantes par élément pour connaître les étapes de correction.

Pour identifier les fichiers qui ne parviennent pas à se synchroniser sur le serveur à l’aide de l’applet Debug-StorageSyncServer de commande , exécutez les commandes PowerShell suivantes :

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

Erreurs de synchronisation

Résolution des erreurs de synchronisation de fichiers/répertoires

Si la synchronisation d’un fichier ou d’un répertoire échoue en raison d’une erreur, un événement est enregistré dans le journal des événements Microsoft-FileSync-Agent/ItemResults . Cette section décrit les codes d’erreur courants et les étapes de correction pour les erreurs par élément.

Erreurs courantes de synchronisation par élément enregistrées dans le journal des événements ItemResults

Gestion des caractères non pris en charge

L’agent Azure File Sync v17 prend en charge tous les caractères pris en charge par le système de fichiers NTFS , à l’exception des paires de substitution non valides.

Si le portail ou FileSyncErrorsReport.ps1 script PowerShell affiche des erreurs de synchronisation par élément (code d’erreur 0x8007007b, 0x80c80255 ou 0x80070459) en raison de caractères non pris en charge, vérifiez si l’agent Azure File Sync v17 est installé sur le serveur. Si l’agent v17 est installé et que la synchronisation des fichiers échoue toujours en raison de caractères non valides, utilisez le script ScanUnsupportedChars pour renommer les fichiers qui contiennent des caractères non pris en charge.

Erreurs de synchronisation courantes

Cette section décrit les codes d’erreur courants et les étapes de correction lorsqu’une session de synchronisation échoue avec une erreur.

La session de synchronisation a été annulée.

Les sessions de synchronisation peuvent échouer pour diverses raisons, notamment le redémarrage ou la mise à jour du serveur, les instantanés VSS, etc. Bien que cette erreur semble avoir besoin d’un suivi, il est prudent d’ignorer cette erreur, sauf si elle persiste sur une période de plusieurs heures.

La session de synchronisation de fichiers a été annulée par la session de synchronisation d’instantané de volume qui s’exécute une fois par jour pour synchroniser les fichiers avec des descripteurs ouverts.

Aucune action n’est requise. Azure File Sync a une tâche planifiée (VssSyncScheduledTask) qui s’exécute une fois par jour sur le serveur pour synchroniser les fichiers en cours d’utilisation. Lorsque cette tâche planifiée démarre, elle annule la session de synchronisation de chargement actuelle (ce qui entraîne l'0x80c8029c code d’erreur), crée un instantané VSS et démarre une nouvelle session de synchronisation de chargement à l’aide de l’instantané VSS.

Impossible d’établir une connexion avec le service.

Cette erreur peut se produire chaque fois que le service Azure File Sync est inaccessible à partir du serveur. Vous pouvez résoudre cette erreur en procédant comme suit :

1. Vérifiez que le service WindowsFileSyncSvc.exe n’est pas bloqué par votre pare-feu.

2. Vérifiez que le port 443 est ouvert aux connexions sortantes au service Azure File Sync. Vous pouvez le faire avec l’applet de Test-NetConnection commande . L’URL de l’espace <azure-file-sync-endpoint> réservé ci-dessous est disponible dans le document paramètres du proxy et du pare-feu Azure File Sync .

   Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
   

3. Vérifiez que la configuration du proxy est définie comme prévu. Cette opération peut être effectuée avec l’applet de Get-StorageSyncProxyConfiguration commande . Vous trouverez plus d’informations sur la configuration du proxy pour Azure File Sync dans les paramètres du proxy et du pare-feu Azure File Sync.

   $agentPath = "C:\Program Files\Azure\StorageSyncAgent"
   Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
   Get-StorageSyncProxyConfiguration
   

4. Utilisez l’applet de Test-StorageSyncNetworkConnectivity commande pour vérifier la connectivité réseau aux points de terminaison de service. Pour plus d’informations, consultez Tester la connectivité réseau aux points de terminaison de service.

5. Contactez votre administrateur réseau pour obtenir de l’aide supplémentaire pour résoudre les problèmes de connectivité réseau.

La demande de l’utilisateur a été limitée par le service.

Aucune action n’est requise ; le serveur réessayera. Si cette erreur persiste pendant plusieurs heures, créez une demande de support.

Échec de la synchronisation, car l’opération a été abandonnée

Aucune action n’est requise. Si cette erreur persiste pendant plusieurs heures, créez une demande de support.

L’opération a été annulée.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

La synchronisation est bloquée jusqu’à la fin de la détection des modifications après la restauration

Aucune action n’est requise. Lorsqu’un partage de fichiers ou de fichiers (point de terminaison cloud) est restauré à l’aide de sauvegarde Azure, la synchronisation est bloquée jusqu’à ce que la détection des modifications soit terminée sur le partage de fichiers Azure. La détection des modifications s’exécute immédiatement une fois la restauration terminée et la durée est basée sur le nombre de fichiers dans le partage de fichiers.

La synchronisation est bloquée sur le dossier en raison d’une pause lancée dans le cadre de la restauration sur le dossier de synchronisation.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

La synchronisation a échoué, car la base de données de synchronisation a été déchargée.

Cette erreur se produit généralement lorsqu’une application de sauvegarde crée un instantané VSS et que la base de données de synchronisation est déchargée. Si cette erreur persiste pendant plusieurs heures, créez une demande de support.

La synchronisation ne peut pas accéder au partage de fichiers Azure spécifié dans le point de terminaison cloud.

Cette erreur se produit parce que l’agent Azure File Sync ne peut pas accéder au partage de fichiers Azure, ce qui peut être dû au fait que le partage de fichiers Azure ou le compte de stockage qui l’héberge n’existe plus. Vous pouvez résoudre cette erreur en procédant comme suit :

1. Vérifiez que le compte de stockage existe.
2. Vérifiez que le partage de fichiers Azure existe.
3. Vérifiez qu’Azure File Sync a accès au compte de stockage.
4. Vérifiez que les paramètres de sécurité SMB sur le compte de stockage autorisent la version du protocole SMB 3.1.1 , l’authentification NTLM v2 et le chiffrement AES-128-GCM . Pour vérifier les paramètres de sécurité SMB sur le compte de stockage, consultez Paramètres de sécurité SMB.
5. Vérifiez que les paramètres de pare-feu et de réseau virtuel sur le compte de stockage sont correctement configurés (si activé)

La synchronisation a échoué, car la requête n’est pas autorisée à effectuer cette opération.

Cette erreur se produit car l’agent Azure File Sync n’est pas autorisé à accéder au partage de fichiers Azure. Vous pouvez résoudre cette erreur en procédant comme suit :

1. Vérifiez que le compte de stockage existe.
2. Vérifiez que le partage de fichiers Azure existe.
3. Vérifiez que les paramètres de pare-feu et de réseau virtuel sur le compte de stockage sont correctement configurés (si activé)
4. Vérifiez qu’Azure File Sync a accès au compte de stockage.

Impossible de résoudre le nom du compte de stockage utilisé.

1. Vérifiez que vous pouvez résoudre le nom DNS de stockage à partir du serveur.

   Test-NetConnection -ComputerName <storage-account-name>.file.core.windows.net -Port 443
   

2. Vérifiez que le compte de stockage existe.

3. Vérifiez que les paramètres de pare-feu et de réseau virtuel sur le compte de stockage sont correctement configurés (si activé)

Une erreur inconnue s’est produite lors de l’accès au compte de stockage.

1. Vérifiez que le compte de stockage existe.
2. Vérifiez que les paramètres de pare-feu et de réseau virtuel sur le compte de stockage sont correctement configurés (si activé)

La synchronisation a échoué en raison du compte de stockage verrouillé.

Cette erreur se produit car le compte de stockage a un verrou de ressource en lecture seule. Pour résoudre ce problème, supprimez le verrou de ressource en lecture seule sur le compte de stockage.

La synchronisation a échoué en raison d’un problème avec la base de données de synchronisation.

Cette erreur se produit en cas de problème avec la base de données interne utilisée par Azure File Sync. Lorsque ce problème se produit, créez une demande de support et nous vous contacterons pour vous aider à le résoudre.

La version de l’agent Azure File Sync installée sur le serveur n’est pas prise en charge.

Cette erreur se produit si la version de l’agent Azure File Sync installée sur le serveur n’est pas prise en charge. Pour résoudre ce problème, effectuez une mise à niveau vers une version d’agent prise en charge.

Vous avez atteint la limite de stockage du partage de fichiers Azure.

Les sessions de synchronisation échouent avec l’une de ces erreurs lorsque la limite de stockage du partage de fichiers Azure a été atteinte, ce qui peut se produire si un quota est appliqué pour un partage de fichiers Azure ou si l’utilisation dépasse les limites d’un partage de fichiers Azure. Pour plus d’informations, consultez les limites actuelles d’un partage de fichiers Azure.

1. Accédez au groupe de synchronisation dans le service de synchronisation de stockage.

2. Sélectionnez le point de terminaison cloud dans le groupe de synchronisation.

3. Notez le nom du partage de fichiers Azure dans le volet ouvert. Sélectionnez le nom du partage de fichiers pour ouvrir la page des paramètres de partage de fichiers dans le compte de stockage.

   

4. Sélectionnez le partage de fichiers pour obtenir les détails dans la page Vue d’ensemble .

5. Sélectionnez Modifier le quota pour vérifier le quota de partage de fichiers. À moins qu’un autre quota n’ait été spécifié, le quota correspondra à la taille maximale du partage de fichiers Azure.

   

Si le partage de fichiers est plein (la capacité utilisée est égale au quota), libérez de l’espace sur le partage de fichiers. Une façon possible de résoudre ce problème consiste à faire de chaque sous-dossier du point de terminaison de serveur actuel son propre point de terminaison de serveur dans leurs propres groupes de synchronisation distincts. De cette façon, chaque sous-dossier se synchronise avec des partages de fichiers Azure individuels.

Le partage de fichiers Azure est introuvable.

Cette erreur se produit lorsque le partage de fichiers Azure n’est pas accessible. Pour résoudre les problèmes suivants :

1. Vérifiez que le compte de stockage existe.
2. Vérifiez que le partage de fichiers Azure existe.
3. Vérifiez que les paramètres de sécurité SMB sur le compte de stockage autorisent la version du protocole SMB 3.1.1 , l’authentification NTLM v2 et le chiffrement AES-128-GCM . Pour vérifier les paramètres de sécurité SMB sur le compte de stockage, consultez Paramètres de sécurité SMB.

Si le partage de fichiers Azure a été supprimé, vous devez créer un partage de fichiers, puis recréer le groupe de synchronisation.

La synchronisation est suspendue pendant la suspension de cet abonnement Azure.

Cette erreur se produit lorsque l’abonnement Azure est suspendu. La synchronisation est réactivée lorsque l’abonnement Azure est restauré. Pour plus d’informations, consultez Pourquoi mon abonnement Azure est-il désactivé et comment le réactiver ?

Un pare-feu ou des réseaux virtuels sont configurés pour le compte de stockage.

Cette erreur se produit lorsque le partage de fichiers Azure est inaccessible en raison d’un pare-feu de compte de stockage ou parce que le compte de stockage appartient à un réseau virtuel. Vérifiez que les paramètres de pare-feu et de réseau virtuel sur le compte de stockage sont correctement configurés. Pour plus d’informations, consultez Configurer les paramètres de pare-feu et de réseau virtuel.

La synchronisation a échoué en raison d’un problème avec la base de données de synchronisation.

Ces erreurs se résolvent généralement d’elles-mêmes et peuvent se produire dans les cas suivants :

• Nombre élevé de modifications de fichiers sur les serveurs du groupe de synchronisation.
• Un grand nombre d’erreurs sur des fichiers et répertoires individuels.

Si cette erreur persiste pendant plus de quelques heures, créez une demande de support et nous vous contacterons pour vous aider à résoudre ce problème.

La base de données de synchronisation a rencontré une erreur d’E/S occupé du stockage.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

La base de données de synchronisation a rencontré un délai d’expiration d’E/S.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

La base de données de synchronisation a rencontré une erreur d’E/S.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

La synchronisation a échoué, car les données sont endommagées et illisibles.

Cette erreur peut se produire en cas d’altération du système de fichiers sur le volume NTFS où se trouve le point de terminaison de serveur. Pour résoudre cette erreur, exécutez chkdsk sur le volume.

Le serveur n’a pas pu établir une connexion sécurisée. Le service cloud a reçu un certificat inattendu.

Cette erreur peut se produire si votre organisation utilise un proxy de fin tls ou si une entité malveillante intercepte le trafic entre votre serveur et le service Azure File Sync. Si vous êtes certain que cela est attendu (car votre organisation utilise un proxy de fin tls), vous ignorez la vérification du certificat avec un remplacement de registre.

1. Créez la valeur de SkipVerifyingPinnedRootCertificate Registre.

   New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Azure\StorageSync -Name SkipVerifyingPinnedRootCertificate -PropertyType DWORD -Value 1
   

2. Redémarrez le service de synchronisation sur le serveur inscrit.

   Restart-Service -Name FileSyncSvc -Force
   

En définissant cette valeur de Registre, l’agent Azure File Sync accepte tout certificat TLS/SSL approuvé localement lors du transfert de données entre le serveur et le service cloud.

La synchronisation a échoué, car le serveur n’a pas pu décoder la réponse du service Azure File Sync.

Cette erreur se produit généralement si un pare-feu, un proxy ou une passerelle bloque l’accès à l’URL PKI, ou si le serveur PKI est arrêté.

Pour résoudre ce problème, vérifiez que le serveur peut accéder aux URL suivantes :

• https://www.microsoft.com/pki/mscorp/cps
• http://crl.microsoft.com/pki/mscorp/crl/
• http://mscrl.microsoft.com/pki/mscorp/crl/
• http://ocsp.msocsp.com
• http://ocsp.digicert.com/
• http://crl3.digicert.com/

Une fois l’agent Azure File Sync installé, l’URL PKI est utilisée pour télécharger les certificats intermédiaires requis pour communiquer avec le service Azure File Sync et le partage de fichiers Azure. L’URL OCSP est utilisée pour vérifier l’état d’un certificat. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

La synchronisation a échoué en raison d’un problème d’authentification.

Cette erreur se produit généralement parce que l’heure du serveur est incorrecte. Si le serveur s’exécute sur une machine virtuelle, vérifiez que l’heure sur l’hôte est correcte.

La synchronisation a échoué en raison de l’expiration du certificat.

Cette erreur se produit car le certificat utilisé pour l’authentification a expiré.

Pour confirmer que le certificat a expiré, procédez comme suit :

1. Ouvrez le composant logiciel enfichable MMC Certificats, sélectionnez Compte d’ordinateur et accédez à Certificats (ordinateur local)\Personnel\Certificats.
2. Vérifiez si le certificat d’authentification client a expiré.

Si le certificat d’authentification client a expiré, exécutez la commande PowerShell suivante sur le serveur :

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

La synchronisation a échoué en raison du certificat d’authentification introuvable.

Cette erreur se produit car le certificat utilisé pour l’authentification est introuvable.

Pour résoudre ce problème, exécutez la commande PowerShell suivante sur le serveur :

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

La synchronisation a échoué en raison de l’identité d’authentification introuvable.

Cette erreur se produit parce que la suppression du point de terminaison de serveur a échoué et que le point de terminaison est maintenant dans un état partiellement supprimé. Pour résoudre ce problème, réessayez de supprimer le point de terminaison de serveur.

Le volume où se trouve le point de terminaison de serveur est faible sur l’espace disque.

Les sessions de synchronisation échouent avec l’une de ces erreurs, car le volume a un espace disque insuffisant ou la limite de quota de disque est atteinte. Cette erreur se produit généralement parce que les fichiers situés en dehors du point de terminaison de serveur utilisent de l’espace sur le volume. Vérifiez l’espace disque disponible sur le serveur. Vous pouvez libérer de l’espace sur le volume en ajoutant des points de terminaison de serveur supplémentaires, en déplaçant des fichiers vers un autre volume ou en augmentant la taille du volume sur lequel se trouve le point de terminaison de serveur. Si un quota de disque est configuré sur le volume à l’aide du Gestionnaire de ressources du serveur de fichiers ou du quota NTFS, augmentez la limite de quota.

Si la hiérarchisation cloud est activée pour le point de terminaison de serveur, vérifiez que les fichiers sont synchronisés avec le partage de fichiers Azure pour éviter de manquer d’espace disque.

Le service n’est pas encore prêt à être synchronisé avec ce point de terminaison de serveur.

Cette erreur se produit car le point de terminaison cloud a été créé avec du contenu déjà existant sur le partage de fichiers Azure. Azure File Sync doit analyser le partage de fichiers Azure pour rechercher tout le contenu avant d’autoriser le point de terminaison de serveur à poursuivre sa synchronisation initiale. Une fois la détection des modifications terminée sur le partage de fichiers Azure, la synchronisation commence. La détection des modifications peut prendre plus de 24 heures et est proportionnelle au nombre de fichiers et de répertoires sur votre partage de fichiers Azure. Si la hiérarchisation cloud est configurée, les fichiers sont hiérarchisé une fois la synchronisation terminée.

La synchronisation a échoué en raison de problèmes liés à de nombreux fichiers individuels.

Les sessions de synchronisation échouent avec l’une de ces erreurs lorsque de nombreux fichiers ne parviennent pas à se synchroniser avec des erreurs par élément. Effectuez les étapes décrites dans la section Comment puis-je voir s’il existe des fichiers ou dossiers spécifiques qui ne sont pas synchronisés ? pour résoudre les erreurs par élément. Pour les ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED d’erreur de synchronisation, ouvrez un cas de support.

La synchronisation a échoué en raison d’un problème avec le chemin du point de terminaison de serveur.

Vérifiez que le chemin existe, qu’il se trouve sur un volume NTFS local et qu’il ne s’agit pas d’un point d’analyse ou d’un point de terminaison de serveur existant.

Échec de la synchronisation, car la version du pilote de filtre n’est pas compatible avec la version de l’agent

Cette erreur se produit car la version du pilote de filtre de hiérarchisation cloud (StorageSync.sys) chargée n’est pas compatible avec le service Agent de synchronisation de stockage (FileSyncSvc). Si l’agent Azure File Sync a été mis à niveau, redémarrez le serveur pour terminer l’installation. Si l’erreur persiste, désinstallez l’agent, redémarrez le serveur et réinstallez l’agent Azure File Sync.

Le service est actuellement indisponible.

Cette erreur se produit car le service Azure File Sync n’est pas disponible. Cette erreur se résout automatiquement lorsque le service Azure File Sync est à nouveau disponible.

La synchronisation a échoué en raison d’une exception.

Cette erreur se produit car la synchronisation a échoué en raison d’une exception. Si l’erreur persiste pendant plusieurs heures, créez une demande de support.

La synchronisation a échoué, car le compte de stockage a basculé vers une autre région.

Cette erreur se produit parce que le compte de stockage a basculé vers une autre région. Azure File Sync ne prend pas en charge la fonctionnalité de basculement de compte de stockage. Les comptes de stockage contenant des partages de fichiers Azure utilisés comme points de terminaison cloud dans Azure File Sync ne doivent pas être basculés. Cela entraîne l’arrêt de la synchronisation et peut également entraîner une perte de données inattendue dans le cas de nouveaux fichiers hiérarchisé. Pour résoudre ce problème, déplacez le compte de stockage vers la région primaire.

La synchronisation a échoué en raison d’un problème temporaire avec la base de données de synchronisation.

Cette erreur se produit en raison d’un problème interne avec la base de données de synchronisation. Cette erreur se résout automatiquement lors de nouvelles tentatives de synchronisation. Si cette erreur persiste pendant une période prolongée, créez une demande de support et nous vous contacterons pour vous aider à résoudre ce problème.

Échec de la synchronisation en raison d’une modification dans le locataire Microsoft Entra

Vérifiez que la dernière version de l’agent Azure File Sync est installée et accordez à l’application Microsoft.StorageSync l’accès au compte de stockage (consultez Vérifier qu’Azure File Sync a accès au compte de stockage).

Échec de la synchronisation en raison d’une exception de pare-feu et de réseau virtuel non configurée

Cette erreur se produit si les paramètres de pare-feu et de réseau virtuel sont activés sur le compte de stockage et que l’exception « Autoriser les services Microsoft approuvés à accéder à ce compte de stockage » n’est pas cochée. Pour résoudre ce problème, suivez les étapes décrites dans la section Configurer les paramètres de pare-feu et de réseau virtuel du guide de déploiement.

Échec de la synchronisation avec accès refusé en raison des paramètres de sécurité sur le compte de stockage ou des autorisations NTFS sur le serveur.

Cette erreur peut se produire si Azure File Sync ne peut pas accéder au compte de stockage en raison des paramètres de sécurité ou si le compte NT AUTHORITY\SYSTEM n’a pas d’autorisations sur le dossier System Volume Information sur le volume sur le volume où se trouve le point de terminaison de serveur. Si la synchronisation de fichiers individuels échoue avec ERROR_ACCESS_DENIED, effectuez les étapes décrites dans la section Résolution des problèmes par erreurs de synchronisation de fichiers/répertoires .

1. Vérifiez que les paramètres de sécurité SMB sur le compte de stockage autorisent la version du protocole SMB 3.1.1 , l’authentification NTLM v2 et le chiffrement AES-128-GCM . Pour vérifier les paramètres de sécurité SMB sur le compte de stockage, consultez Paramètres de sécurité SMB.

2. Vérifiez que les paramètres de pare-feu et de réseau virtuel sur le compte de stockage sont correctement configurés (si activé)

3. Vérifiez que le compte NT AUTHORITY\SYSTEM dispose d’autorisations sur le dossier System Volume Information sur le volume sur le volume où se trouve le point de terminaison de serveur en effectuant les étapes suivantes :

   1. Téléchargez l’outil Psexec .

   2. Exécutez la commande suivante à partir d’une invite de commandes avec élévation de privilèges pour lancer une invite de commandes à l’aide du compte système : PsExec.exe -i -s -d cmd.

   3. À partir de l’invite de commandes s’exécutant sous le compte système, exécutez la commande suivante pour vérifier que le compte NT AUTHORITY\SYSTEM n’a pas accès au dossier System Volume Information : cacls "drive letter:\system volume information" /T /C.

   4. Si le compte NT AUTHORITY\SYSTEM n’a pas accès au dossier System Volume Information , exécutez la commande suivante : cacls "drive letter:\system volume information" /T /E /G "NT AUTHORITY\SYSTEM:F".

      Si l’étape d échoue avec accès refusé, exécutez la commande suivante pour prendre possession du dossier System Volume Information , puis répétez l’étape d :

      takeown /A /R /F "drive letter:\System Volume Information"

La synchronisation a échoué, car le partage de fichiers Azure a été supprimé et recréé.

Cette erreur se produit car Azure File Sync ne prend pas en charge la suppression et la recréation d’un partage de fichiers Azure dans le même groupe de synchronisation.

Pour résoudre ce problème, supprimez et recréez le groupe de synchronisation en effectuant les étapes suivantes :

1. Supprimez tous les points de terminaison de serveur dans le groupe de synchronisation.
2. Supprimez le point de terminaison cloud.
3. Supprimez le groupe de synchronisation.
4. Si la hiérarchisation cloud a été activée sur un point de terminaison de serveur, supprimez les fichiers hiérarchisé orphelins sur le serveur en effectuant les étapes décrites dans la section Fichiers hiérarchisé ne sont pas accessibles sur le serveur après la suppression d’un point de terminaison de serveur .
5. Recréez le groupe de synchronisation.

Sync a détecté que le réplica a été restauré à un état plus ancien

Aucune action n’est requise. Cette erreur se produit car la synchronisation a détecté que le réplica a été restauré dans un état plus ancien. La synchronisation passe maintenant en mode de rapprochement, où elle recrée la relation de synchronisation en fusionnant le contenu du partage de fichiers Azure et les données sur le point de terminaison de serveur. Lorsque le mode de rapprochement est déclenché, le processus peut prendre beaucoup de temps, en fonction de la taille de l’espace de noms. La synchronisation régulière ne se produit pas tant que le rapprochement n’est pas terminé, et les fichiers qui sont différents (heure ou taille de la dernière modification) entre le partage de fichiers Azure et le point de terminaison de serveur entraînent des conflits de fichiers.

Échec de la synchronisation, car la requête HTTP a été redirigée

Cette erreur se produit car Azure File Sync ne prend pas en charge la redirection HTTP (code d’état 3xx). Pour résoudre ce problème, désactivez la redirection HTTP sur votre serveur proxy ou périphérique réseau.

Erreur de délai d’expiration de session de synchronisation.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

Délai d’expiration de l’opération.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

Erreur de délai d’expiration.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

La synchronisation a échoué, car le chemin du point de terminaison de serveur est introuvable sur le serveur.

Cette erreur se produit si le répertoire utilisé comme chemin d’accès au point de terminaison de serveur a été renommé ou supprimé. Si le répertoire a été renommé, renommez le répertoire avec son nom d’origine et redémarrez le service Agent de synchronisation de stockage (FileSyncSvc).

Si le répertoire a été supprimé, procédez comme suit pour supprimer le point de terminaison de serveur existant et créer un point de terminaison de serveur à l’aide d’un nouveau chemin d’accès :

1. Supprimez le point de terminaison de serveur dans le groupe de synchronisation en suivant les étapes décrites dans Supprimer un point de terminaison de serveur.
2. Créez un point de terminaison de serveur dans le groupe de synchronisation en suivant les étapes décrites dans Ajouter un point de terminaison de serveur.

Échec de l’approvisionnement du point de terminaison de serveur en raison d’un chemin d’accès de serveur vide.

L’approvisionnement du point de terminaison de serveur échoue avec ce code d’erreur si ces conditions sont remplies :

• Ce point de terminaison de serveur a été approvisionné avec le mode de synchronisation initial : serveur faisant autorité
• Le chemin du serveur local est vide ou ne contient aucun élément reconnu comme pouvant être synchronisé.

Cette erreur d’approvisionnement vous empêche de supprimer tout le contenu qui peut être disponible dans un partage de fichiers Azure. Le chargement faisant autorité du serveur est un mode spécial permettant de rattraper un emplacement cloud qui a déjà été initialisé, avec les mises à jour à partir de l’emplacement du serveur. Consultez ce guide de migration pour comprendre le scénario pour lequel ce mode a été créé.

1. Supprimez le point de terminaison de serveur dans le groupe de synchronisation en suivant les étapes décrites dans Supprimer un point de terminaison de serveur.
2. Créez un point de terminaison de serveur dans le groupe de synchronisation en suivant les étapes décrites dans Ajouter un point de terminaison de serveur.

L’abonnement propriétaire du compte de stockage est désactivé.

Vérifiez et vérifiez que l’abonnement dans lequel réside votre compte de stockage est activé.

Le nom de réseau spécifié n’est plus disponible.

Utilisez l’applet de Test-StorageSyncNetworkConnectivity commande pour vérifier la connectivité réseau aux points de terminaison de service. Pour plus d’informations, consultez Tester la connectivité réseau aux points de terminaison de service.

Erreur de session de synchronisation.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

Erreur de session de synchronisation.

Si l’erreur persiste pendant plus d’un jour, créez une demande de support.

Une erreur interne s’est produite.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

Une erreur interne s’est produite.

Si l’erreur persiste pendant plus d’un jour, créez une demande de support.

Une erreur interne s’est produite.

Effectuez une mise à niveau vers la dernière version de l’agent de synchronisation de fichiers. Si l’erreur persiste après la mise à niveau de l’agent, créez une demande de support.

L’opération a échoué en raison d’un échec d’authentification.

Si l’erreur persiste pendant plus d’un jour, créez une demande de support.

Le compte Azure spécifié est désactivé.

Vérifiez et vérifiez que l’abonnement dans lequel réside votre compte de stockage est activé.

Authentification basée sur une clé de compte de stockage bloquée.

Activez « Autoriser l’accès à la clé du compte de stockage » sur le compte de stockage. En savoir plus.

La synchronisation doit mettre à jour la base de données sur le serveur.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

Le volume est hors connexion. Soit il est supprimé, soit il n’est pas prêt ou non connecté.

Vérifiez que le volume où se trouve le point de terminaison de serveur est attaché au serveur.

Accès à la configuration du point de terminaison privé bloqué.

Vérifiez la configuration du point de terminaison privé et autorisez l’accès au service de synchronisation de fichiers. En savoir plus.

La synchronisation doit rapprocher le serveur et les données du partage de fichiers Azure avant que les fichiers puissent être chargés.

Aucune action n’est requise. Cette erreur doit être résolue automatiquement. Si l’erreur persiste pendant plusieurs jours, créez une demande de support.

Les connexions multiples à un serveur ou à une ressource partagée par le même utilisateur, à l’aide de plusieurs noms d’utilisateur, ne sont pas autorisées.

Supprimez toutes les connexions précédentes au serveur ou à la ressource partagée et recommencez.

Le certificat SSL du serveur n’est pas valide ou a expiré.

Exécutez la commande PowerShell suivante sur le serveur pour réinitialiser le certificat :

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

Étapes communes de dépannage

Vérifiez que le compte de stockage existe.

# Variables for you to populate based on your configuration
$region = "<Az_Region>"
$resourceGroup = "<RG_Name>"
$syncService = "<storage-sync-service>"
$syncGroup = "<sync-group>"

# Log into the Azure account
Connect-AzAccount

# Check to ensure Azure File Sync is available in the selected Azure
# region.
$regions = [System.String[]]@()
Get-AzLocation | ForEach-Object { 
    if ($_.Providers -contains "Microsoft.StorageSync") { 
        $regions += $_.Location 
    } 
}

if ($regions -notcontains $region) {
    throw [System.Exception]::new("Azure File Sync is either not available in the " + `
        " selected Azure Region or the region is mistyped.")
}

# Check to ensure resource group exists
$resourceGroups = [System.String[]]@()
Get-AzResourceGroup | ForEach-Object { 
    $resourceGroups += $_.ResourceGroupName 
}

if ($resourceGroups -notcontains $resourceGroup) {
    throw [System.Exception]::new("The provided resource group $resourceGroup does not exist.")
}

# Check to make sure the provided Storage Sync Service
# exists.
$syncServices = [System.String[]]@()

Get-AzStorageSyncService -ResourceGroupName $resourceGroup | ForEach-Object {
    $syncServices += $_.StorageSyncServiceName
}

if ($syncServices -notcontains $syncService) {
    throw [System.Exception]::new("The provided Storage Sync Service $syncService does not exist.")
}

# Check to make sure the provided Sync Group exists
$syncGroups = [System.String[]]@()

Get-AzStorageSyncGroup -ResourceGroupName $resourceGroup -StorageSyncServiceName $syncService | ForEach-Object {
    $syncGroups += $_.SyncGroupName
}

if ($syncGroups -notcontains $syncGroup) {
    throw [System.Exception]::new("The provided sync group $syncGroup does not exist.")
}

# Get reference to cloud endpoint
$cloudEndpoint = Get-AzStorageSyncCloudEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $syncService `
    -SyncGroupName $syncGroup

# Get reference to storage account
$storageAccount = Get-AzStorageAccount | Where-Object { 
    $_.Id -eq $cloudEndpoint.StorageAccountResourceId
}

if ($storageAccount -eq $null) {
    throw [System.Exception]::new("The storage account referenced in the cloud endpoint does not exist.")
}

Vérifiez que le partage de fichiers Azure existe.

$fileShare = Get-AzStorageShare -Context $storageAccount.Context | Where-Object {
    $_.Name -eq $cloudEndpoint.AzureFileShareName -and
    $_.IsSnapshot -eq $false
}

if ($fileShare -eq $null) {
    throw [System.Exception]::new("The Azure file share referenced by the cloud endpoint does not exist")
}

Vérifiez qu’Azure File Sync a accès au compte de stockage.

$role = Get-AzRoleAssignment -Scope $storageAccount.Id | Where-Object { $_.DisplayName -eq "Microsoft.StorageSync" }

if ($role -eq $null) {
    throw [System.Exception]::new("The storage account does not have the Azure File Sync " + `
                "service principal authorized to access the data within the " + ` 
                "referenced Azure file share.")
}

Voir aussi

• Résoudre les problèmes de gestion des groupes de synchronisation Azure File Sync
• Résoudre les problèmes d’installation et d’inscription de serveur de l’agent Azure File Sync
• Résoudre les problèmes de hiérarchisation cloud Azure File Sync
• Surveiller Azure File Sync
• Résoudre les problèmes liés à Azure Files

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.