Compartir a través de

Solución de problemas de Azure Files Sync

  • Artículo

Puede usar Azure File Sync para centralizar los recursos compartidos de archivos de su organización en Azure Files sin renunciar a la flexibilidad, el rendimiento y la compatibilidad de un servidor de archivos local. Este artículo está diseñado para ayudarle a solucionar problemas que podrían producirse con la implementación de Azure File Sync. Se describe cómo recopilar registros importantes del sistema si es necesario investigar los problemas en mayor profundidad.

Documentación de solución de problemas común

En función del problema que experimenta, revise la documentación de solución de problemas adecuada:

Issues Documentación de solución de problemas
Problemas de instalación del agente o registro del servidor Solución de problemas de instalación del agente y registro del servidor de Azure File Sync
Problemas de creación de puntos de conexión de nube o de punto de conexión de servidor, o bien el servidor registrado está sin conexión Solución de problemas de la administración de grupos de sincronización de Azure File Sync
El punto de conexión del servidor tiene un estado de error o los archivos no se pueden sincronizar Solución de problemas de estado y errores de sincronización de Azure File Sync
Los archivos no se pueden organizar por niveles o recuperarlos Solución de problemas de la organización de la nube por niveles de Azure File Sync
No se puede iniciar el servicio del agente de sincronización de almacenamiento (FileSyncSvc) Solución de problemas de Azure File Sync
Uso elevado de memoria en el servidor Solución de problemas de Azure File Sync

Si no está seguro de dónde empezar, consulte Solución de problemas general de los primeros pasos.

Primeros pasos generales para solucionar problemas

Si tiene problemas con Azure File Sync, empiece por completar los pasos siguientes:

  1. Compruebe si hay errores mediante Azure Portal o registros de eventos en el servidor. Para obtener información sobre cómo ver el estado del entorno de Azure File Sync mediante Azure Portal o los registros de eventos, consulte Supervisión de Azure File Sync.
  2. Compruebe que el servicio Azure File Sync se está ejecutando en el servidor:
  3. Compruebe que los controladores de filtro de Azure File Sync (StorageSync.sys y StorageSyncGuard.sys) se ejecutan en el servidor:
    • En un símbolo del sistema con privilegios elevados, ejecute fltmc. Compruebe que se muestran los controladores de filtro del sistema de archivos StorageSync.sys y StorageSyncGuard.sys .
  4. Use el cmdlet Debug-StorageSyncServer en el servidor para comprobar si hay problemas comunes.

Cmdlet Debug-StorageSyncServer

El Debug-StorageSyncServer cmdlet diagnosticará problemas comunes en el servidor de Azure File Sync, como la configuración incorrecta del certificado y la hora del servidor incorrecta. También hemos simplificado la solución de problemas de Azure File Sync mediante la combinación de la funcionalidad de algunos scripts y cmdlets existentes (AFSDiag.ps1, FileSyncErrorsReport.ps1 y Test-StorageSyncNetworkConnectivity) en el Debug-StorageSyncServer cmdlet .

Para ejecutar diagnósticos en el servidor, ejecute los siguientes comandos de PowerShell:

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

Para probar la conectividad de red en el servidor, ejecute los siguientes comandos de PowerShell:

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

Para identificar los archivos que no se pueden sincronizar en el servidor, ejecute los siguientes comandos de PowerShell:

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

Para recopilar los registros y seguimientos en el servidor, ejecute los siguientes comandos de PowerShell:

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

Recopilación de registros y seguimientos en el servidor de Azure File Sync

Si el problema no se resuelve después de seguir los pasos descritos en la documentación de solución de problemas, ejecute la herramienta AFSDiag y envíe su salida de archivo .zip al ingeniero de soporte técnico asignado a su caso para un diagnóstico adicional.

Para ejecutar AFSDiag, siga estos pasos:

  1. Abra una ventana de PowerShell con privilegios elevados y ejecute los siguientes comandos (presione Entrar después de cada comando):

    Nota:

    AFSDiag creará el directorio de salida y una carpeta temporal en el mismo antes de recopilar los registros, y eliminará la carpeta temporal después de la ejecución. Especifique una ubicación de salida que no contenga datos.

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

  2. Reproduzca el problema. Cuando termine, escriba D.

  3. Un archivo .zip que contiene los archivos de seguimiento y registros se guarda en el directorio de salida que especificó.

No se puede iniciar el servicio del agente de sincronización de almacenamiento (FileSyncSvc)

Después de instalar o actualizar el agente de Azure File Sync (v17.3 o posterior), puede experimentar uno de los siguientes síntomas:

  • El servicio agente de sincronización de almacenamiento (FileSyncSvc) no se inicia con el siguiente error:

    Error 0x80070057: The parameter is incorrect.

  • El registro de un servidor mediante el cmdlet Register-AzStorageSyncServer produce el siguiente error:

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

  • ServerRegistration.exe o AfsUpdater.exe no se puede abrir

Este problema se produce porque el agente de Azure File Sync tiene una dependencia de una característica de seguridad de Windows y no se instalan las actualizaciones de esta característica de seguridad.

Para resolver este problema, compruebe que Windows Server tiene instaladas las siguientes actualizaciones:

Uso elevado de memoria en el servidor

Azure File Sync usa bases de datos del motor de almacenamiento extensible (ESE) para la sincronización y la nube por niveles. Las bases de datos ESE pueden consumir hasta el 80 % de la memoria del sistema para mejorar el rendimiento. Para limitar la cantidad de memoria usada por las bases de datos ESE, puede configurar la configuración del MaxESEDbCachePercent Registro en el servidor.

Para reducir el límite de uso de memoria de ESE al 60 %, que es un buen equilibrio entre el uso de memoria y la memoria caché suficiente para mantener un rendimiento decente de las bases de datos, ejecute el siguiente comando desde un símbolo del sistema con privilegios elevados:

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

Una vez creada la configuración del MaxESEDbCachePercent Registro, reinicie el servicio Agente de sincronización de almacenamiento (FileSyncSvc).

Consulte también

Ponte en contacto con nosotros para obtener ayuda

Si tiene preguntas o necesita ayuda, cree una solicitud de soporte o busque consejo en la comunidad de Azure. También puede enviar comentarios sobre el producto con los comentarios de la comunidad de Azure.