Dela via

Felsöka Azure File Sync

  • Artikel

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:

  1. Kontrollera om det finns fel med hjälp av Azure-portalen eller händelseloggar på servern. Information om hur du visar hälsotillståndet för din Azure File Sync-miljö med hjälp av Azure-portalen eller händelseloggar finns i Övervaka Azure File Sync.
  2. Kontrollera att Azure File Sync-tjänsten körs på servern:
  3. 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.
  4. 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:

  1. Ö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

  2. Återskapa problemet. När du är klar anger du D.

  3. 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:

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 om du behöver hjälp

Om du har frågor eller behöver hjälp skapar du en supportbegäran eller frågar Azure Community-support. Du kan också skicka produktfeedback till Azure-feedbackcommunityn.