Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
Troubleshoot Azure File Sync
Summary
Use Azure File Sync to centralize your organization's file shares in Azure Files, while keeping the flexibility, performance, and compatibility of an on-premises file server. This article helps you troubleshoot and resolve problems that you might encounter with your Azure File Sync deployment. It also describes how to collect important logs from the system if a deeper investigation of the problem is required.
Common troubleshooting documentation
Based on the problem you're experiencing, review the appropriate troubleshooting documentation:
| Problems | Troubleshooting documentation |
|---|---|
| Agent installation or server registration problems | Troubleshoot Azure File Sync agent installation and server registration |
| Cloud endpoint or server endpoint creation problems, or the registered server is offline | Troubleshoot Azure File Sync sync group management |
| Server endpoint has an error status, or files fail to sync | Troubleshoot Azure File Sync sync health and errors |
| Files fail to tier or recall | Troubleshoot Azure File Sync cloud tiering |
| Storage Sync Agent service (FileSyncSvc) fails to start | Storage Sync Agent service (FileSyncSvc) fails to start |
| High memory usage on the server | Troubleshoot high memory usage |
If you're unsure where to start, see General troubleshooting steps.
Tip
Use Azure Copilot to help diagnose and fix your Azure File Sync environment. For more information, see Manage and troubleshoot storage accounts using Azure Copilot.
General troubleshooting steps
If you're experiencing problems with Azure File Sync, start by completing the following steps:
- Check for any errors by using the Azure portal or event logs on the server. For information about how to view the health of your Azure File Sync environment by using the Azure portal or event logs, see Monitor Azure File Sync.
- Verify the Azure File Sync service is running on the server:
- Open the Services MMC snap-in and verify the Storage Sync Agent service (FileSyncSvc) is running. If the service isn't running and fails to start, see Storage Sync Agent service (FileSyncSvc) fails to start.
- Verify the Azure File Sync filter drivers (StorageSync.sys and StorageSyncGuard.sys) are running on the server:
- At an elevated command prompt, run
fltmc. Verify the StorageSync.sys and StorageSyncGuard.sys file system filter drivers are listed.
- At an elevated command prompt, run
- Use the Debug-StorageSyncServer cmdlet on the server to check for common problems.
Troubleshooting resources
Feedback
Was this page helpful?