Delen via

Problemen oplossen met Azure File Sync

  • Artikel

U kunt Azure File Sync gebruiken om de bestandsshares van uw organisatie te centraliseren in Azure Files en tegelijkertijd de flexibiliteit, prestaties en compatibiliteit van een on-premises bestandsserver te behouden. Dit artikel is ontworpen om u te helpen bij het oplossen van problemen die kunnen optreden met uw Azure File Sync-implementatie. We beschrijven ook hoe u belangrijke logboeken van het systeem verzamelt als een dieper onderzoek van het probleem vereist is.

Algemene documentatie voor probleemoplossing

Bekijk de juiste documentatie voor probleemoplossing op basis van het probleem dat u ondervindt:

Problemen Documentatie voor probleemoplossing
Problemen met agentinstallatie of serverregistratie Problemen met de installatie en serverregistratie van de Azure File Sync-agent oplossen
Problemen met het maken van cloudeindpunten of servereindpunten, of de geregistreerde server is offline Problemen met azure File Sync-synchronisatiegroepbeheer oplossen
Servereindpunt heeft een foutstatus of bestanden kunnen niet worden gesynchroniseerd Status en fouten van Azure File Sync-synchronisatie oplossen
Bestanden kunnen niet worden gelaagd of ingetrokken Problemen met azure File Sync-cloudlagen oplossen
De Storage Sync Agent-service (FileSyncSvc) kan niet worden gestart Problemen oplossen met Azure File Sync
Hoog geheugengebruik op de server Problemen oplossen met Azure File Sync

Als u niet zeker weet waar u moet beginnen, raadpleegt u de eerste stappen voor het oplossen van algemene problemen.

Algemene eerste stappen voor probleemoplossing

Als u problemen ondervindt met Azure File Sync, voert u eerst de volgende stappen uit:

  1. Controleer op eventuele fouten met behulp van de Azure-portal of gebeurtenislogboeken op de server. Zie Azure File Sync bewaken voor informatie over het weergeven van de status van uw Azure File Sync-omgeving met behulp van de Azure-portal of gebeurtenislogboeken.
  2. Controleer of de Azure File Sync-service wordt uitgevoerd op de server:
  3. Controleer of de Azure File Sync-filterstuurprogramma's (StorageSync.sys en StorageSyncGuard.sys) worden uitgevoerd op de server:
    • Voer fltmc uit vanaf een opdrachtprompt met verhoogde bevoegdheid. Controleer of de stuurprogramma's voor StorageSync.sys en StorageSyncGuard.sys bestandssysteemfilters worden vermeld.
  4. Gebruik de cmdlet Debug-StorageSyncServer op de server om te controleren op veelvoorkomende problemen.

Debug-StorageSyncServer-cmdlet

De Debug-StorageSyncServer cmdlet diagnosticeert veelvoorkomende problemen op de Azure File Sync-server, zoals onjuiste configuratie van certificaten en onjuiste servertijd. We hebben het oplossen van problemen met Azure File Sync ook vereenvoudigd door de functionaliteit van sommige bestaande scripts en cmdlets (AFSDiag.ps1, FileSyncErrorsReport.ps1 en Test-StorageSyncNetworkConnectivity) samen te voegen in de Debug-StorageSyncServer cmdlet.

Voer de volgende PowerShell-opdrachten uit om diagnostische gegevens uit te voeren op de server:

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

Voer de volgende PowerShell-opdrachten uit om de netwerkverbinding op de server te testen:

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

Voer de volgende PowerShell-opdrachten uit om bestanden te identificeren die niet kunnen worden gesynchroniseerd op de server:

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

Voer de volgende PowerShell-opdrachten uit om logboeken en traceringen op de server te verzamelen:

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

Logboeken en traceringen verzamelen op de Azure File Sync-server

Als uw probleem niet is opgelost nadat u de stappen in de documentatie voor probleemoplossing hebt uitgevoerd, voert u het HULPPROGRAMMA AFSDiag uit en verzendt u de uitvoer van het .zip-bestand naar de ondersteuningstechnicus die aan uw aanvraag is toegewezen voor verdere diagnose.

Voer de onderstaande stappen uit om AFSDiag uit te voeren:

  1. Open een PowerShell-venster met verhoogde bevoegdheid en voer de volgende opdrachten uit (druk op Enter na elke opdracht):

    Notitie

    AFSDiag maakt de uitvoermap en een tijdelijke map erin voordat u logboeken verzamelt en verwijdert de tijdelijke map na uitvoering. Geef een uitvoerlocatie die geen gegevens bevat.

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

  2. Reproduceer het probleem. Wanneer u klaar bent, voert u D in.

  3. Er wordt een .zip-bestand met logboeken en traceringsbestanden opgeslagen in de uitvoermap die u hebt opgegeven.

De Storage Sync Agent-service (FileSyncSvc) kan niet worden gestart

Nadat u de Azure File Sync-agent (v17.3 of hoger) hebt geïnstalleerd of bijgewerkt, kan een van de volgende symptomen optreden:

  • De Storage Sync Agent-service (FileSyncSvc) kan niet worden gestart met de volgende fout:

    Error 0x80070057: The parameter is incorrect.

  • Het registreren van een server met behulp van de cmdlet Register-AzStorageSyncServer mislukt met de volgende fout:

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

  • ServerRegistration.exe of AfsUpdater.exe kan niet worden geopend

Dit probleem treedt op omdat de Azure File Sync-agent afhankelijk is van een Windows-beveiligingsfunctie en updates voor deze beveiligingsfunctie niet zijn geïnstalleerd.

Als u dit probleem wilt oplossen, controleert u of op uw Windows Server de volgende updates zijn geïnstalleerd:

Hoog geheugengebruik op de server

Azure File Sync maakt gebruik van ESE-databases (Extensible Storage Engine) voor synchronisatie en cloudlagen. De ESE-databases kunnen tot 80% van het systeemgeheugen verbruiken om de prestaties te verbeteren. Als u de hoeveelheid geheugen wilt beperken die door de ESE-databases wordt gebruikt, kunt u de MaxESEDbCachePercent registerinstelling op de server configureren.

Als u de limiet voor ESE-geheugengebruik wilt beperken tot 60%, wat een goede balans is tussen het geheugengebruik en voldoende cache om de goede prestaties van de databases te behouden, voert u de volgende opdracht uit vanaf een opdrachtprompt met verhoogde bevoegdheid:

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

Zodra de MaxESEDbCachePercent registerinstelling is gemaakt, start u de Storage Sync Agent-service (FileSyncSvc) opnieuw op.

Zie ook

Contact met ons opnemen voor ondersteuning

Als u vragen hebt of hulp nodig hebt, maakt u een ondersteuningsaanvraag of stelt u ondersteuning voor de Azure-community. U kunt ook productfeedback verzenden naar de Azure-feedbackcommunity.