Устранение неполадок службы "Синхронизация файлов Azure"

Сводка

Используйте службу Синхронизация файлов Azure, чтобы централизованно хранить файловые ресурсы организации в службе файлов Azure, обеспечивая гибкость, производительность и совместимость локального файлового сервера. Эта статья поможет устранить неполадки, которые могут возникнуть при развертывании службы "Синхронизация файлов Azure". Он также описывает, как собирать важные журналы из системы, если требуется более глубокое исследование проблемы.

Общая документация по устранению неполадок

В зависимости от проблемы, которую вы столкнулись, ознакомьтесь с соответствующей документацией по устранению неполадок:

Если вы не знаете, где начать работу, ознакомьтесь с общими инструкциями по устранению неполадок.

Общие действия по устранению неполадок

Если у вас возникли проблемы с синхронизацией файлов Azure, выполните следующие действия.

1. Проверьте наличие ошибок с помощью портала Azure или журналов событий на сервере. Сведения о том, как просмотреть работоспособность среды Синхронизация файлов Azure с помощью портал Azure или журналов событий, см. в разделе "Мониторинг Синхронизация файлов Azure".
2. Убедитесь, что служба Синхронизация файлов Azure запущена на сервере:
   • Откройте оснастку служб MMC и убедитесь, что служба агента синхронизации хранилища (FileSyncSvc) запущена. Если служба не запущена и не запускается, см. раздел "Служба агента синхронизации хранилища" (FileSyncSvc) не запускается.
3. Убедитесь, что драйверы фильтров Синхронизация файлов Azure (StorageSync.sys и StorageSyncGuard.sys) выполняются на сервере:
   • В командной строке с повышенными привилегиями запустите fltmc. Убедитесь, что перечислены драйверы фильтров файловой системы StorageSync.sys и StorageSyncGuard.sys .
4. Используйте командлет Debug-StorageSyncServer на сервере, чтобы проверить наличие распространенных проблем.

Командлет Debug-StorageSyncServer

Командлет Debug-StorageSyncServer диагностирует распространенные проблемы на сервере синхронизации файлов Azure, такие как неправильно настроенный сертификат и неправильное время сервера. Чтобы упростить устранение неполадок синхронизации файлов Azure, она объединяет функции некоторых существующих скриптов и командлетов (AFSDiag.ps1, FileSyncErrorsReport.ps1и Test-StorageSyncNetworkConnectivity).

Чтобы запустить диагностику на сервере, выполните следующие команды PowerShell:

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

Чтобы проверить сетевое подключение на сервере, выполните следующие команды PowerShell:

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

Чтобы определить файлы, которые не удалось синхронизировать на сервере, выполните следующие команды PowerShell:

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

Чтобы собрать журналы и трассировки на сервере, выполните следующие команды PowerShell:

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

Сбор журналов и трассировок на сервере синхронизации файлов Azure

Если проблема не устранена после выполнения действий, описанных в документации по устранению неполадок, запустите средство AFSDiag и отправьте файл .zip с выходными данными инженеру, назначенному на ваше дело, для дальнейшей диагностики.

Чтобы запустить AFSDiag, выполните действия, описанные в следующем разделе:

1. Откройте окно PowerShell с повышенными привилегиями и выполните следующие команды (нажмите клавишу ВВОД после каждой команды):

   Примечание.

   AFSDiag создает выходной каталог и папку temp в ней перед сбором журналов. Он удаляет папку temp после выполнения. Укажите выходное расположение, которое не содержит данных.

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

2. Воспроизведите проблему. По завершении введите D.

3. ZIP-файл, содержащий журналы и файлы трассировки, сохраняется в указанном вами каталоге выходных данных.

Не удается запустить службу агента синхронизации хранилища (FileSyncSvc)

После установки или обновления агента синхронизации файлов Azure (версии 18 или более поздней версии) может возникнуть один из следующих симптомов:

• Служба агента синхронизации хранилища (FileSyncSvc) не запускается со следующей ошибки:

  Error 0x80070057: The parameter is incorrect. 
  

• Регистрация сервера с помощью командлета Register-AzStorageSyncServer завершается с следующей ошибкой.

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

• ServerRegistration.exe или AfsUpdater.exe не удается открыть

• Установка агента завершается сбоем. В журнале установки отображается код ошибки 0x80c84111 со следующим сообщением:

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

Эти проблемы возникают, так как агент синхронизации файлов Azure зависит от функции безопасности Windows и обновлений этой функции безопасности не установлены.

Чтобы устранить эту проблему, убедитесь, что в Windows Server установлены следующие обновления:

• Каталог Центра обновления Майкрософт Для Windows Server 2016 (последнее накопительное обновление)

• Каталог Центра обновления Майкрософт для Windows Server 2019 (последнее накопительное обновление)

  Накопительные обновления выпускаются ежемесячно. Чтобы развернуть последнее обновление, можно использовать Центр обновления Windows или скачать его из каталога центра обновления Майкрософт. Перед установкой вручную ознакомьтесь со связанной статьей базы знаний (КБ), чтобы убедиться, что выполнены все предварительные требования.Если обновления Windows не установлены перед установкой агента синхронизации файлов Azure, служба агента синхронизации хранилища (FileSyncSvc) не запускается.

Автоматическое обновление не может обновить агента синхронизации файлов Azure, срок действия которого скоро истечет, или у которого срок действия уже истек.

Если автоматическому обновлению не удается обновить агент синхронизации файлов Azure, срок действия которого истекает или уже истек, убедитесь, что сведения об истечении срока действия агента правильно применены к серверу. Автоматическое обновление нуждается в метаданных об истечении срока действия для корректной работы.

Чтобы проверить, заданы ли метаданные AgentExpirationDate , выполните следующую команду из сеанса PowerShell с повышенными привилегиями:

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

Если метаданные AgentExpirationDate не заданы или его значение пустым, проблема сети может препятствовать серверу получать данные об истечении срока действия. Чтобы проверить сетевое подключение, выполните следующую команду:

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

Если тест сообщает о проблемах с сетевым подключением, вы можете вручную обновить агент, скачав его из каталога Центра обновления Майкрософт.

Скачав соответствующую версию агента, ознакомьтесь с конкретной статьей базы знаний в каталоге для получения пошаговых инструкций по установке.

Если нет проблем с подключением, и AgentExpirationDate метаданные по-прежнему не заданы, обратитесь в службу поддержки Azure File Sync за помощью.

Высокая загрузка памяти на сервере

Служба синхронизации файлов Azure использует базы данных Extensible Storage Engine (ESE) для синхронизации и облачного распределения данных по уровням. Базы данных ESE могут использовать до 80% системной памяти для повышения производительности. Чтобы ограничить объем памяти, используемой базами данных ESE, можно настроить MaxESEDbCachePercent параметр реестра на сервере.

Чтобы уменьшить предел использования памяти ESE до 60%, что является хорошим балансом между использованием памяти и достаточным кэшем для обеспечения достойной производительности баз данных, выполните следующую команду из командной строки с повышенными привилегиями:

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

После создания MaxESEDbCachePercent параметра реестра перезапустите службу агента синхронизации хранилища (FileSyncSvc).

См. также

• Мониторинг Синхронизации файлов Azure
• Устранение неполадок файлов Azure
• Устранение проблем с производительностью в Azure Files