Felsöka Azure File Sync
Du kan använda Azure File Sync för att centralisera organisationens filresurser i Azure Files, samtidigt som du behåller flexibiliteten, prestandan och kompatibiliteten hos en lokal filserver. Den här artikeln är utformad för att hjälpa dig att felsöka och lösa problem som du kan stöta på med din Azure File Sync-distribution. Vi beskriver också hur du samlar in viktiga loggar från systemet om en djupare undersökning av problemet krävs.
Vanliga felsökningsdokumentation
Baserat på det problem du upplever läser du lämplig felsökningsdokumentation:
Problem | Felsökningsdokumentation |
---|---|
Problem med agentinstallation eller serverregistrering | Felsöka installation och serverregistrering av Azure File Sync-agenten |
Problem med att skapa molnslutpunkter eller serverslutpunkter, eller så är den registrerade servern offline | Felsöka grupphantering för Azure File Sync-synkronisering |
Serverslutpunkten har en felstatus, eller så kan filer inte synkroniseras | Felsöka hälsotillstånd och fel för Synkronisering av Azure File Sync |
Filer kan inte nivåindela eller återkalla | Felsöka azure file sync-molnnivåindelning |
Tjänsten Storage Sync Agent (FileSyncSvc) startar inte | Felsöka Azure File Sync |
Hög minnesanvändning på servern | Felsöka Azure File Sync |
Om du är osäker på var du ska börja kan du läsa De första stegen för allmän felsökning.
De första stegen för allmän felsökning
Om du har problem med Azure File Sync börjar du med att utföra följande steg:
- Kontrollera om det finns fel med hjälp av Azure Portal- eller händelseloggarna på servern. Information om hur du visar hälsotillståndet för din Azure File Sync-miljö med hjälp av Azure Portal- eller händelseloggarna finns i Övervaka Azure File Sync.
- Kontrollera att Azure File Sync-tjänsten körs på servern:
- Öppna MMC-snapin-modulen Services och kontrollera att tjänsten Storage Sync Agent (FileSyncSvc) körs. Om tjänsten inte körs och det inte går att starta kan du läsa Storage Sync Agent-tjänsten (FileSyncSvc) misslyckas med att starta.
- Kontrollera att Azure File Sync-filterdrivrutinerna (StorageSync.sys och StorageSyncGuard.sys) körs på servern:
- Kör
fltmc
från en upphöjd kommandotolk. Kontrollera att StorageSync.sys- och StorageSyncGuard.sys filsystemfilterdrivrutinerna visas.
- Kör
- Använd cmdleten Debug-StorageSyncServer på servern för att söka efter vanliga problem.
Cmdleten Debug-StorageSyncServer
Cmdleten Debug-StorageSyncServer
diagnostiserar vanliga problem på Azure File Sync-servern, till exempel felkonfiguration av certifikat och felaktig servertid. Vi har också förenklat felsökningen av Azure File Sync genom att slå samman funktionerna i vissa befintliga skript och cmdletar (AFSDiag.ps1, FileSyncErrorsReport.ps1 och Test-StorageSyncNetworkConnectivity
) i cmdletenDebug-StorageSyncServer
.
Kör följande PowerShell-kommandon för att köra diagnostik på servern:
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -Diagnose
Testa nätverksanslutningen på servern genom att köra följande PowerShell-kommandon:
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -TestNetworkConnectivity
Om du vill identifiera filer som inte kan synkroniseras på servern kör du följande PowerShell-kommandon:
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -FileSyncErrorsReport
Kör följande PowerShell-kommandon för att samla in loggar och spårningar på servern:
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose
Samla in loggar och spårningar på Azure File Sync-servern
Om problemet inte har lösts efter att du har följt stegen i felsökningsdokumentationen kör du verktyget AFSDiag och skickar dess .zip filutdata till supportteknikern som tilldelats ditt ärende för ytterligare diagnos.
Utför stegen nedan för att köra AFSDiag:
Öppna ett upphöjt PowerShell-fönster och kör sedan följande kommandon (tryck på Retur efter varje kommando):
Kommentar
AFSDiag skapar utdatakatalogen och en temporär mapp i den innan loggarna samlas in och den temporära mappen tas bort efter körningen. Ange en utdataplats som inte innehåller data.
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll" Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose
Återskapa problemet. När du är klar anger du D.
En zip-fil som innehåller loggar och spårningsfiler sparas i den utdatakatalog som du har angett.
Tjänsten Storage Sync Agent (FileSyncSvc) startar inte
När du har installerat eller uppgraderat Azure File Sync-agenten (v17.3 eller senare) kan du uppleva något av följande symptom:
Tjänsten Storage Sync Agent (FileSyncSvc) kan inte starta med följande fel:
Error 0x80070057: The parameter is incorrect.
Det går inte att registrera en server med hjälp av cmdleten Register-AzStorageSyncServer med följande fel:
Register-AzStorageSyncServer: Exception of type 'Commands.StorageSync.Interop.Exceptions.ServerRegistrationException' was thrown.
ServerRegistration.exe eller AfsUpdater.exe kan inte öppnas
Det här problemet beror på att Azure File Sync-agenten är beroende av en Windows-säkerhetsfunktion och uppdateringar för den här säkerhetsfunktionen inte installeras.
Lös problemet genom att kontrollera att windows-servern har följande uppdateringar installerade:
- Windows Server 2012 R2: KB5021653
- Windows Server 2016: KB5040562
- Windows Server 2019: KB5005112 och KB5040430
Hög minnesanvändning på servern
Azure File Sync använder ESE-databaser (Extensible Storage Engine) för synkronisering och molnnivåindelning. ESE-databaserna kan förbruka upp till 80 % av systemminnet för att förbättra prestandan. Om du vill begränsa mängden minne som används av ESE-databaserna kan du konfigurera registerinställningen MaxESEDbCachePercent
på servern.
Om du vill minska ESE-minnesanvändningsgränsen till 60 %, vilket är en bra balans mellan minnesanvändning och tillräckligt med cacheminne för att upprätthålla anständiga prestanda för databaserna, kör du följande kommando från en upphöjd kommandotolk:
REG ADD HKLM\Software\Microsoft\Azure\StorageSync /v MaxESEDbCachePercent /t REG_DWORD /d 60
När registerinställningen MaxESEDbCachePercent
har skapats startar du om tjänsten Storage Sync Agent (FileSyncSvc).
Se även
Kontakta oss för att få hjälp
Om du har frågor eller behöver hjälp skapar du en supportförfrågan eller frågar Azure community support. Du kan också skicka produktfeedback till Azure-feedbackcommunityn.