Udostępnij za pośrednictwem

Rozwiązywanie problemów z usługą Azure File Sync

  • Artykuł

Za pomocą usługi Azure File Sync można scentralizować udziały plików organizacji w usłudze Azure Files, zachowując jednocześnie elastyczność, wydajność i zgodność lokalnego serwera plików. Ten artykuł jest przeznaczony do rozwiązywania i rozwiązywania problemów, które mogą wystąpić podczas wdrażania usługi Azure File Sync. Opisujemy również sposób zbierania ważnych dzienników z systemu, jeśli wymagane jest dokładniejsze badanie problemu.

Wspólna dokumentacja rozwiązywania problemów

Na podstawie problemu, którego dotyczy problem, zapoznaj się z odpowiednią dokumentacją rozwiązywania problemów:

Problemy Dokumentacja rozwiązywania problemów
Problemy z instalacją agenta lub rejestracją serwera Rozwiązywanie problemów z instalacją agenta usługi Azure File Sync i rejestracją serwera
Problemy z tworzeniem punktu końcowego w chmurze lub punktu końcowego serwera albo zarejestrowany serwer jest w trybie offline Rozwiązywanie problemów z zarządzaniem grupami synchronizacji usługi Azure File Sync
Punkt końcowy serwera ma stan błędu lub nie można zsynchronizować plików Rozwiązywanie problemów z kondycją i błędami synchronizacji usługi Azure File Sync
Nie można umieścić plików w warstwie lub odwołać Rozwiązywanie problemów z obsługą warstw w chmurze usługi Azure File Sync
Nie można uruchomić usługi agenta synchronizacji magazynu (FileSyncSvc) Rozwiązywanie problemów z usługą Azure File Sync
Wysokie użycie pamięci na serwerze Rozwiązywanie problemów z usługą Azure File Sync

Jeśli nie masz pewności, gdzie rozpocząć, zobacz Ogólne kroki rozwiązywania problemów.

Pierwsze kroki ogólnego rozwiązywania problemów

Jeśli występują problemy z usługą Azure File Sync, rozpocznij od wykonania następujących kroków:

  1. Sprawdź błędy przy użyciu witryny Azure Portal lub dzienników zdarzeń na serwerze. Aby uzyskać informacje na temat wyświetlania kondycji środowiska usługi Azure File Sync przy użyciu witryny Azure Portal lub dzienników zdarzeń, zobacz Monitorowanie usługi Azure File Sync.
  2. Sprawdź, czy usługa Azure File Sync jest uruchomiona na serwerze:
  3. Sprawdź, czy sterowniki filtrów usługi Azure File Sync (StorageSync.sys i StorageSyncGuard.sys) są uruchomione na serwerze:
    • W wierszu polecenia z podwyższonym poziomem uprawnień uruchom polecenie fltmc. Sprawdź, czy są wyświetlane sterowniki filtrów systemu plików StorageSync.sys i StorageSyncGuard.sys .
  4. Użyj polecenia cmdlet Debug-StorageSyncServer na serwerze, aby sprawdzić typowe problemy.

Debugowanie polecenia cmdlet StorageSyncServer

Polecenie Debug-StorageSyncServer cmdlet zdiagnozuje typowe problemy na serwerze usługi Azure File Sync, takie jak błędna konfiguracja certyfikatu i niepoprawny czas serwera. Uprościliśmy również rozwiązywanie problemów z usługą Azure File Sync, scalając funkcje niektórych istniejących skryptów i poleceń cmdlet (AFSDiag.ps1, FileSyncErrorsReport.ps1 i Test-StorageSyncNetworkConnectivity) do Debug-StorageSyncServer polecenia cmdlet .

Aby uruchomić diagnostykę na serwerze, uruchom następujące polecenia programu PowerShell:

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

Aby przetestować łączność sieciową na serwerze, uruchom następujące polecenia programu PowerShell:

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

Aby zidentyfikować pliki, które nie można zsynchronizować na serwerze, uruchom następujące polecenia programu PowerShell:

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

Aby zebrać dzienniki i ślady na serwerze, uruchom następujące polecenia programu PowerShell:

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

Jak zbierać dzienniki i ślady na serwerze usługi Azure File Sync

Jeśli problem nie został rozwiązany po wykonaniu kroków w dokumentacji rozwiązywania problemów, uruchom narzędzie AFSDiag i wyślij dane wyjściowe pliku .zip do inżyniera pomocy technicznej przypisanego do Twojej sprawy w celu dalszej diagnostyki.

Aby uruchomić narzędzie AFSDiag, wykonaj poniższe kroki:

  1. Otwórz okno programu PowerShell z podwyższonym poziomem uprawnień, a następnie uruchom następujące polecenia (naciśnij Enter po każdym poleceniu):

    Uwaga

    Narzędzie AFSDiag utworzy katalog wyjściowy i folder tymczasowy w nim przed zebraniem dzienników i usunie folder tymczasowy po wykonaniu. Określ lokalizację wyjściową, która nie zawiera danych.

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

  2. Odtwórz problem. Po zakończeniu wprowadź D.

  3. Plik ZIP zawierający dzienniki i pliki śledzenia zostanie zapisany w określonym przez Ciebie katalogu wyjściowym.

Nie można uruchomić usługi agenta synchronizacji magazynu (FileSyncSvc)

Po zainstalowaniu lub uaktualnieniu agenta usługi Azure File Sync (wersja 17.3 lub nowsza) może wystąpić jeden z następujących objawów:

  • Nie można uruchomić usługi agenta synchronizacji magazynu (FileSyncSvc) z następującym błędem:

    Error 0x80070057: The parameter is incorrect.

  • Zarejestrowanie serwera przy użyciu polecenia cmdlet Register-AzStorageSyncServer kończy się niepowodzeniem z powodu następującego błędu:

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

  • Nie można otworzyć ServerRegistration.exe lub AfsUpdater.exe

Ten problem występuje, ponieważ agent usługi Azure File Sync ma zależność od funkcji zabezpieczeń systemu Windows i aktualizacje tej funkcji zabezpieczeń nie są zainstalowane.

Aby rozwiązać ten problem, sprawdź, czy system Windows Server ma zainstalowane następujące aktualizacje:

Wysokie użycie pamięci na serwerze

Usługa Azure File Sync używa rozszerzalnych baz danych aparatu magazynu (ESE) na potrzeby synchronizacji i obsługi warstw w chmurze. Bazy danych ESE mogą zużywać do 80% pamięci systemowej, aby zwiększyć wydajność. Aby ograniczyć ilość pamięci używanej przez bazy danych ESE, możesz skonfigurować MaxESEDbCachePercent ustawienie rejestru na serwerze.

Aby zmniejszyć limit użycia pamięci ESE do 60%, co jest dobrą równowagą między użyciem pamięci i wystarczającą ilością pamięci podręcznej, aby utrzymać przyzwoitą wydajność baz danych, uruchom następujące polecenie w wierszu polecenia z podwyższonym poziomem uprawnień:

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

Po utworzeniu MaxESEDbCachePercent ustawienia rejestru uruchom ponownie usługę Agent synchronizacji magazynu (FileSyncSvc).

Zobacz też

Skontaktuj się z nami, aby uzyskać pomoc

Jeśli masz pytania lub potrzebujesz pomocy, utwórz wniosek o pomoc techniczną lub zadaj pomoc techniczną społeczności platformy Azure. Możesz również przesłać opinię o produkcie do społeczności opinii na temat platformy Azure.