Azure File Sync: Solución de problemas de niveles en la nube

La nube por niveles, una característica opcional de Azure File Sync, reduce la cantidad de almacenamiento local necesario al tiempo que mantiene el rendimiento de un servidor de archivos local. Cuando está habilitada, esta característica almacena solo los archivos a los que se accede con frecuencia (en caliente) en el servidor local. Los archivos a los que se accede con poca frecuencia (esporádico) se dividen en espacio de nombres (estructura de archivos y carpetas) y contenido de archivo.

Hay dos rutas de acceso para los errores en la nube por niveles:

• Los archivos pueden no estar en niveles, lo que significa que Azure File Sync intenta colocar un archivo en niveles en Azure Files sin éxito.
• Los archivos no pueden recuperarse, lo que significa que el filtro del sistema de archivos de Azure File Sync (StorageSync.sys) no puede descargar datos cuando un usuario intenta acceder a un archivo que se ha agrupado en niveles.

Hay dos clases principales de errores que pueden producirse a través de cualquiera de las rutas de acceso de error:

• Errores de almacenamiento en la nube
  • Problemas transitorios de disponibilidad del servicio de almacenamiento. Para obtener más información, consulte el Acuerdo de Nivel de Servicio (SLA) para Azure Storage.
  • Recurso compartido de archivos de Azure inaccesible. Este error suele producirse cuando se elimina el recurso compartido de archivos de Azure cuando sigue siendo un punto de conexión en la nube en un grupo de sincronización.
  • Cuenta de almacenamiento inaccesible. Este error suele producirse cuando se elimina la cuenta de almacenamiento mientras sigue teniendo un recurso compartido de archivos de Azure que es un punto de conexión en la nube en un grupo de sincronización.
• Errores del servidor
  • El filtro del sistema de archivos de Azure File Sync (StorageSync.sys) no se carga. Para responder a solicitudes por niveles o recuperación, se debe cargar el filtro del sistema de archivos de Azure File Sync. El filtro que no se carga puede producirse por varias razones, pero la razón más común es que un administrador lo descargó manualmente. El filtro del sistema de archivos de Azure File Sync debe cargarse en todo momento para que Azure File Sync funcione correctamente.
  • Falta un punto de reanálisis, está dañado o, de lo contrario, se ha roto. Un punto de reanálisis es una estructura de datos especial en un archivo que consta de dos partes:

    1. Una etiqueta de reanálisis, que indica al sistema operativo que es posible que el filtro del sistema de archivos de Azure File Sync (StorageSync.sys) tenga que realizar alguna acción en E/S en el archivo.

    2. Reanálisis de datos, que indica al sistema de archivos filtrar el URI del archivo en el punto de conexión de nube asociado (el recurso compartido de archivos de Azure).

       La forma más común de dañar un punto de reanálisis es si un administrador intenta modificar la etiqueta o sus datos.

  • Problemas de conectividad de red. Para escalar o recuperar un archivo, el servidor debe tener conectividad a Internet.

En las secciones siguientes se indica cómo solucionar problemas de nube por niveles y determinar si un problema es un problema de almacenamiento en la nube o un problema de servidor.

Para supervisar la actividad por niveles en un servidor, use el identificador de evento 9003, 9016 y 9029 en el registro de eventos telemetría (ubicado en Applications and Services\Microsoft\FileSync\Agent el Visor de eventos).

• El identificador de evento 9003 proporciona distribución de errores para un punto de conexión de servidor. Por ejemplo, Total Error Count y ErrorCode. Tenga en cuenta que se registra un evento por código de error por hora.
• El identificador de evento 9016 proporciona resultados fantasma para un volumen. Por ejemplo, el porcentaje de espacio libre es, el número de archivos fantasma en la sesión y el número de archivos no se pudo fantasma.
• El identificador de evento 9029 proporciona información de sesión fantasma para un punto de conexión de servidor. Por ejemplo, Número de archivos intentados en la sesión, Número de archivos en capas en la sesión y Número de archivos ya en capas.

Para supervisar la actividad de recuperación en un servidor, use el identificador de evento 9005, 9006, 9009 y 9059 en el registro de eventos telemetría (ubicado en Aplicaciones y servicios\Microsoft\FileSync\Agent en el Visor de eventos).

• El identificador de evento 9005 proporciona confiabilidad de recuperación para un punto de conexión de servidor. Por ejemplo, Total de archivos únicos a los que se ha accedido y Total de archivos únicos con acceso erróneo.
• El identificador de evento 9006 proporciona distribución de errores de recuperación para un punto de conexión de servidor. Por ejemplo, Total de solicitudes con error y ErrorCode. Tenga en cuenta que se registra un evento por código de error por hora.
• El identificador de evento 9009 proporciona información de la sesión de recuperación para un punto de conexión de servidor. Por ejemplo, DurationSeconds, CountFilesRecallSucceeded y CountFilesRecallFailed.
• El identificador de evento 9059 proporciona distribución de recuperación de aplicaciones para un punto de conexión de servidor. Por ejemplo, ShareId, Application Name y TotalEgressNetworkBytes.

1. En el Visor de eventos, vaya al registro de eventos Microsoft-FileSync-Agent/RecallResults .
2. Hay un evento registrado para cada archivo que se recupera. Si el DataTransferHresult campo es 0, la recuperación del archivo se realiza correctamente. Si el DataTransferHresult campo tiene un código de error, compruebe la sección Recuperación de errores y corrección para ver si se muestran los pasos de corrección para el código de error.

Para solucionar problemas de archivos que no se pueden realizar en niveles, siga estos pasos:

1. En el Visor de eventos, vaya al registro de eventos Microsoft-FileSync-Agent/TieringResults .

2. Hay un evento registrado para cada archivo que no puede realizar el nivel. Compruebe la sección Errores y correcciones por niveles para ver si se muestran los pasos de corrección para el código de error.

   También puede usar PowerShell para ver los eventos que se registran en el registro de eventos TieringResults:

   PowerShell

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

Si el contenido no existe para el código de error, siga los pasos generales de solución de problemas:

1. Compruebe que el archivo existe en el recurso compartido de archivos de Azure.

    Nota

   Un archivo debe sincronizarse con un recurso compartido de archivos de Azure para poder hacerlo por niveles.

2. Compruebe que el servidor tiene conectividad a Internet.

3. Compruebe que los controladores de filtro de Azure File Sync (StorageSync.sys y StorageSyncGuard.sys) están en ejecución:

   • En un símbolo del sistema con privilegios elevados, ejecute fltmc. Compruebe que aparecen los controladores de filtro del sistema de archivos StorageSync.sys y StorageSyncGuard.sys .

Para solucionar problemas de archivos que no se pueden recuperar, siga estos pasos:

1. En el Visor de eventos, vaya al registro de eventos Microsoft-FileSync-Agent/RecallResults .

2. Hay un evento registrado para cada archivo que se recupera. Si el DataTransferHresult campo es 0, la recuperación del archivo se realiza correctamente. Si el DataTransferHresult campo tiene un código de error, compruebe la sección Recuperación de errores y corrección para ver si se muestran los pasos de corrección para el código de error.

   También puede usar PowerShell para ver los eventos que se registran en el registro de eventos RecallResults:

   PowerShell

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

Si el contenido no existe para el código de error, siga los pasos generales de solución de problemas:

1. Compruebe que el archivo existe en el recurso compartido de archivos de Azure.
2. Compruebe que el servidor tiene conectividad a Internet.
3. Abra el complemento MMC Servicios y compruebe que el servicio agente de sincronización de almacenamiento (FileSyncSvc) se está ejecutando.
4. Compruebe que los controladores de filtro de Azure File Sync (StorageSync.sys y StorageSyncGuard.sys) están en ejecución:
   • En un símbolo del sistema con privilegios elevados, ejecute fltmc. Compruebe que aparecen los controladores de filtro del sistema de archivos StorageSync.sys y StorageSyncGuard.sys .

Los archivos en capas de un servidor serán inaccesibles si los archivos no se recuperan antes de eliminar un punto de conexión de servidor o si los archivos en capas se restauraron desde la copia de seguridad local (de terceros) en la ubicación del punto de conexión del servidor.

Los siguientes errores se registran si no se puede acceder a los archivos en niveles:

• Al sincronizar un archivo, el código de error -2147023890 (0x800703ee - ERROR_FILE_INVALID) o -2147942467 (0x80070043 - ERROR_BAD_NET_NAME) se registra en el registro de eventos ItemResults .
• Al recuperar un archivo, el código de error -2147023890 (0x800703ee - ERROR_FILE_INVALID) o -2134376393 (0x80c80037 - ECS_E_SYNC_SHARE_NOT_FOUND) se registra en el registro de eventos RecallResults .

Si no se puede acceder a los archivos en capas debido a la eliminación del punto de conexión de servidor, es posible restaurar el acceso a los archivos en niveles si se cumplen las condiciones siguientes:

• El punto de conexión del servidor se eliminó en los últimos 30 días.
• No se eliminó el punto de conexión en la nube.
• No se eliminó el recurso compartido de archivos.
• No se eliminó el grupo de sincronización.

Si se cumplen las condiciones anteriores, puede restaurar el acceso a los archivos del servidor recreando el punto de conexión del servidor en la misma ruta de acceso en el servidor dentro del mismo grupo de sincronización en un plazo de 30 días.

Si no se cumplen las condiciones anteriores o los archivos en capas se restauraron desde una copia de seguridad local (de terceros), la restauración del acceso no es posible, ya que estos archivos en capas del servidor ahora están huérfanos. Siga estas instrucciones para quitar los archivos en capas huérfanos.

Obtención de la lista de archivos huérfanos en capas

1. Ejecute los siguientes comandos de PowerShell para enumerar los archivos en capas huérfanos:

   PowerShell

   Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
   $orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
   $orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
   

2. Guarde el archivo de salidaOrphanTieredFiles.txt en caso de que los archivos deban restaurarse desde la copia de seguridad después de que se eliminen.

Eliminación de archivos huérfanos en capas

Opción 1: Eliminar los archivos en capas huérfanos

Esta opción elimina los archivos en capas huérfanos en Windows Server, pero requiere quitar el punto de conexión del servidor si existe debido a la re-creación después de 30 días o está conectado a un grupo de sincronización diferente. Los conflictos de archivos se producirán si los archivos se actualizan en el recurso compartido de archivos de Windows Server o Azure antes de volver a crear el punto de conexión del servidor.

1. Realice una copia de seguridad del recurso compartido de archivos de Azure y la ubicación del punto de conexión del servidor.

2. Quite el punto de conexión de servidor en el grupo de sincronización (si existe) siguiendo los pasos documentados en Quitar un punto de conexión de servidor.

    Advertencia

   Si el punto de conexión de servidor no se quita antes de usar el Remove-StorageSyncOrphanedTieredFiles cmdlet, al eliminar el archivo huérfano en capas en el servidor se eliminará el archivo completo en el recurso compartido de archivos de Azure.

3. Ejecute los siguientes comandos de PowerShell para enumerar los archivos en capas huérfanos:

   PowerShell

   Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
   $orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
   $orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
   

4. Guarde el archivo de salidaOrphanTieredFiles.txt en caso de que los archivos deban restaurarse desde la copia de seguridad después de que se eliminen.

5. Ejecute los siguientes comandos de PowerShell para eliminar archivos huérfanos en capas:

   PowerShell

   Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
   $orphanFilesRemoved = Remove-StorageSyncOrphanedTieredFiles -Path <folder path containing orphaned tiered files> -Verbose
   $orphanFilesRemoved.OrphanedTieredFiles > DeletedOrphanFiles.txt
   

    Nota:

   • Se eliminarán los archivos en capas modificados en el servidor que no están sincronizados con el recurso compartido de archivos de Azure.
   • Los archivos en niveles accesibles (no huérfanos) no se eliminarán.
   • Los archivos no en capas permanecerán en el servidor.

6. Opcional: vuelva a crear el punto de conexión de servidor si se elimina en el paso 3.

Opción 2: Montar el recurso compartido de archivos de Azure y copiar localmente los archivos huérfanos en el servidor

Esta opción no requiere la eliminación del punto de conexión de servidor, pero requiere suficiente espacio en disco para copiar los archivos completos localmente.

1. Monte el recurso compartido de archivos de Azure en Windows Server que tiene archivos huérfanos en capas.

2. Ejecute los siguientes comandos de PowerShell para enumerar los archivos en capas huérfanos:

   PowerShell

   Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
   $orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
   $orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
   

3. Use el archivo de salidaOrphanTieredFiles.txt para identificar archivos huérfanos en capas en el servidor.

4. Sobrescriba los archivos huérfanos en capas copiando el archivo completo del recurso compartido de archivos de Azure en Windows Server.

Antivirus, copia de seguridad y otras aplicaciones que leen un gran número de archivos provocan recuperaciones no deseadas a menos que respeten el atributo skip offline y omitan la lectura del contenido de esos archivos. Omitir archivos sin conexión para los productos que admiten esta opción ayuda a evitar recuperaciones no intencionadas durante operaciones como exámenes antivirus o trabajos de copia de seguridad.

Consulte con el proveedor de software para obtener información sobre cómo configurar su solución para omitir la lectura de archivos sin conexión.

Las recuperaciones no intencionadas también pueden producirse en otros escenarios, como cuando se examinan archivos en niveles de nube en el Explorador de archivos. Es probable que esto ocurra en Windows Server 2016 si la carpeta contiene archivos ejecutables. El Explorador de archivos se ha mejorado para Windows Server 2019 y versiones posteriores para controlar mejor los archivos sin conexión.

Si desea configurar el antivirus u otras aplicaciones para omitir el examen de los archivos a los que accede Azure File Sync, configure las siguientes exclusiones de proceso:

• C:\Program Files\Azure\StorageSyncAgent\AfsAutoUpdater.exe
• C:\Program Files\Azure\StorageSyncAgent\FileSyncSvc.exe
• C:\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentLauncher.exe
• C:\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentHost.exe
• C:\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentManager.exe
• C:\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentCore.exe
• C:\Program Files\Azure\StorageSyncAgent\MAAgent\Extensions\XSyncMonitoringExtension\AzureStorageSyncMonitor.exe

Puede ver la configuración de TLS en el servidor examinando la configuración del Registro.

Si usa un proxy, consulte la documentación del proxy y asegúrese de que está configurado para usar TLS 1.2.