Dela via


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:

  1. 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.
  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.ps1Debug-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 (v18 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 Register-AzStorageSyncServer cmdleten med följande fel:

    Register-AzStorageSyncServer: Exception of type 'Commands.StorageSync.Interop.Exceptions.ServerRegistrationException' was thrown.
    
  • ServerRegistration.exe eller AfsUpdater.exe kan inte öppnas

  • Agentinstallationen misslyckas. Installationsloggen visar felkoden 0x80c84111 med följande meddelande:

    Exception occurred while configuring MitigationRedirection policy. This could indicate that required windows updates not installed on the computer.
    

Dessa problem uppstår eftersom Azure File Sync-agenten har ett 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 2016 Microsoft Update Catalog (senaste kumulativa uppdateringen)
  • Windows Server 2019 Microsoft Update Catalog (senaste kumulativa uppdateringen)
    • Kumulativa uppdateringar släpps varje månad. Om du vill distribuera den senaste uppdateringen kan användarna antingen använda Windows Update eller ladda ned den manuellt från Microsoft Update Catalog. Om du installerar manuellt bör användarna granska den associerade KB-artikeln för att säkerställa att alla krav uppfylls.Om Windows-uppdateringarna inte har installerats innan du installerar Azure File Sync-agenten kommer tjänsten Storage Sync Agent (FileSyncSvc) inte att starta.

Autouppdatering uppgraderar inte 'som snart upphör' eller föråldrad Azure File Sync Agent

Om automatisk uppdatering inte uppgraderar dina Azure File Sync-agenter som snart förfaller eller har förfallit, kontrollerar du om information om agenternas förfallodatum tillämpas korrekt på servern. Förfallometadata krävs för att automatisk uppdatering ska fungera som förväntat.

Kontrollera om AgentExpirationDate är inställt genom att köra följande kommando från en upphöjd PowerShell-session:

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

Om värdet AgentExpirationDate inte har angetts eller är tomt kan det finnas ett nätverksproblem som hindrar servern från att ta emot förfallodata. Testa nätverksanslutningen genom att köra följande kommando:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Test-StorageSyncNetworkConnectivity

Om problem med nätverksanslutningen rapporteras kan du uppdatera agenten manuellt genom att ladda ned den från Microsoft Update Catalog. När du har laddat ned lämplig agentversion kan du läsa den specifika kunskapsbasartikeln i katalogen för stegvisa installationsinstruktioner.

Om anslutningsproblem inte hittas och AgentExpirationDate fortfarande inte har angetts kontaktar du Azure File Sync-supporten för ytterligare hjälp.

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.