Risolvere i problemi di Sincronizzazione file di Azure

  • Articolo

È possibile usare Sincronizzazione file di Azure per centralizzare le condivisioni file dell'organizzazione in File di Azure senza rinunciare alla flessibilità, alle prestazioni e alla compatibilità di un file server locale. L'obiettivo di questo articolo è aiutare l'utente a individuare e risolvere i problemi che si possono incontrare con la distribuzione di Sincronizzazione file di Azure. Viene inoltre spiegato come raccogliere i log importanti dal sistema per effettuare un'analisi più approfondita dei problemi.

Documentazione comune sulla risoluzione dei problemi

In base al problema riscontrato, esaminare la documentazione appropriata per la risoluzione dei problemi:

Problemi Documentazione sulla risoluzione dei problemi
Problemi di installazione o registrazione del server dell'agente Risolvere i problemi relativi all'installazione dell'agente Sincronizzazione file di Azure e alla registrazione del server
Problemi di creazione dell'endpoint cloud o dell'endpoint server oppure il server registrato è offline Risolvere i problemi di gestione dei gruppi di sincronizzazione Sincronizzazione file di Azure
L'endpoint server presenta uno stato di errore o i file non vengono sincronizzati Risolvere gli errori e l'integrità della sincronizzazione Sincronizzazione file di Azure
I file non superano il livello o il richiamo Risolvere i problemi di Sincronizzazione file di Azure cloud a livelli
L'avvio del servizio agente di sincronizzazione archiviazione (FileSyncSvc) non riesce Risolvere i problemi di Sincronizzazione file di Azure
Utilizzo elevato della memoria nel server Risolvere i problemi di Sincronizzazione file di Azure

Se non si è certi di dove iniziare, vedere Procedura generale per la risoluzione dei problemi.

Primi passaggi della procedura generale per la risoluzione dei problemi

Se si verificano problemi con Sincronizzazione file di Azure, iniziare completando i passaggi seguenti:

  1. Verificare la presenza di eventuali errori usando il portale di Azure o i registri eventi nel server. Per informazioni su come visualizzare l'integrità dell'ambiente Sincronizzazione file di Azure tramite i registri eventi o portale di Azure, vedere Monitorare Sincronizzazione file di Azure.
  2. Verificare che il servizio Sincronizzazione file di Azure sia in esecuzione nel server:
  3. Verificare che i driver di filtro Sincronizzazione file di Azure (StorageSync.sys e StorageSyncGuard.sys) siano in esecuzione nel server:
    • Al prompt dei comandi con privilegi elevati. eseguire fltmc. Verificare che siano elencati i driver di filtro StorageSync.sys e StorageSyncGuard.sys file system.
  4. Usare il cmdlet Debug-StorageSyncServer nel server per verificare la presenza di problemi comuni.

Cmdlet Debug-StorageSyncServer

Il Debug-StorageSyncServer cmdlet diagnosticare i problemi comuni nel server Sincronizzazione file di Azure, ad esempio errori di configurazione del certificato e ora del server non corretta. È stata anche semplificata Sincronizzazione file di Azure risoluzione dei problemi unendo le funzionalità di alcuni script e cmdlet esistenti (AFSDiag.ps1, FileSyncErrorsReport.ps1 e Test-StorageSyncNetworkConnectivity) nel Debug-StorageSyncServer cmdlet .

Per eseguire la diagnostica nel server, eseguire i comandi di PowerShell seguenti:

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

Per testare la connettività di rete nel server, eseguire i comandi di PowerShell seguenti:

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

Per identificare i file che non riescono a eseguire la sincronizzazione nel server, eseguire i comandi di PowerShell seguenti:

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

Per raccogliere log e tracce nel server, eseguire i comandi di PowerShell seguenti:

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

Come raccogliere log e tracce nel server Sincronizzazione file di Azure

Se il problema non viene risolto dopo aver seguito i passaggi descritti nella documentazione sulla risoluzione dei problemi, eseguire lo strumento AFSDiag e inviare il relativo output del file .zip al tecnico del supporto assegnato al caso per ulteriori diagnosi.

Per eseguire AFSDiag, seguire questa procedura:

  1. Aprire una finestra di PowerShell con privilegi elevati e quindi eseguire i comandi seguenti (premere INVIO dopo ogni comando):

    Nota

    AFSDiag creerà la directory di output e una cartella temporanea al suo interno prima di raccogliere i log ed eliminerà la cartella temporanea dopo l'esecuzione. Specificare un percorso di output che non contenga dati.

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

  2. Riprodurre il problema. Al termine, immettere D.

  3. Nella directory di output specificata verrà salvato un file con estensione zip contenente i log e i file di traccia.

L'avvio del servizio agente di sincronizzazione archiviazione (FileSyncSvc) non riesce

Dopo aver installato o aggiornato l'agente Sincronizzazione file di Azure (v17.3 o versione successiva), è possibile che si verifichi uno dei sintomi seguenti:

  • Il servizio agente di sincronizzazione archiviazione (FileSyncSvc) non viene avviato con l'errore seguente:

    Error 0x80070057: The parameter is incorrect.

  • La registrazione di un server con il cmdlet Register-AzStorageSyncServer ha esito negativo con l'errore seguente:

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

  • ServerRegistration.exe o AfsUpdater.exe non è possibile aprire

Questo problema si verifica perché l'agente Sincronizzazione file di Azure ha una dipendenza da una funzionalità di sicurezza di Windows e gli aggiornamenti per questa funzionalità di sicurezza non vengono installati.

Per risolvere questo problema, verificare che windows Server disponga degli aggiornamenti seguenti installati:

Utilizzo elevato della memoria nel server

Sincronizzazione file di Azure usa database ESE (Extensible Storage Engine) per la sincronizzazione e la suddivisione in livelli cloud. I database ESE possono utilizzare fino all'80% della memoria di sistema per migliorare le prestazioni. Per limitare la quantità di memoria usata dai database ESE, è possibile configurare l'impostazione MaxESEDbCachePercent del Registro di sistema nel server.

Per ridurre il limite di utilizzo della memoria ESE al 60%, che rappresenta un buon equilibrio tra l'utilizzo della memoria e una cache sufficiente per mantenere prestazioni ottimali dei database, eseguire il comando seguente da un prompt dei comandi con privilegi elevati:

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

Dopo aver creato l'impostazione del MaxESEDbCachePercent Registro di sistema, riavviare il servizio Agente di sincronizzazione archiviazione (FileSyncSvc).

Vedi anche

Contattaci per ricevere assistenza

In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.