You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/azure/azure-storage/files/file-sync/file-sync-troubleshoot.md
+27-6Lines changed: 27 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Troubleshoot common issues that you might encounter with Azure File
4
4
author: khdownie
5
5
ms.service: azure-file-storage
6
6
ms.topic: troubleshooting
7
-
ms.date: 01/13/2025
7
+
ms.date: 07/16/2025
8
8
ms.author: kendownie
9
9
ms.custom: sap:File Sync
10
10
---
@@ -89,7 +89,7 @@ To run AFSDiag, perform the steps below:
89
89
90
90
## Storage Sync Agent service (FileSyncSvc) fails to start
91
91
92
-
After installing or upgrading the Azure File Sync agent (v17.3 or later), you may experience one of the following symptoms:
92
+
After installing or upgrading the Azure File Sync agent (v18 or later), you might experience one of the following symptoms:
93
93
94
94
- The Storage Sync Agent service (FileSyncSvc) fails to start with the following error:
95
95
@@ -110,12 +110,33 @@ After installing or upgrading the Azure File Sync agent (v17.3 or later), you ma
110
110
Exception occurred while configuring MitigationRedirection policy. This could indicate that required windows updates not installed on the computer.
111
111
```
112
112
113
-
This issue occurs because the Azure File Sync agent has a dependency on a Windows security feature and updates for this security feature are not installed.
113
+
These issues occur because the Azure File Sync agent has a dependency on a Windows security feature and updates for this security feature aren't installed.
114
114
115
115
To resolve this issue, verify your Windows Server has the following updates installed:
116
-
- Windows Server 2012 R2: [KB5021653](https://support.microsoft.com/topic/kb5021653-out-of-band-update-for-windows-server-2012-r2-november-17-2022-8e6ec2e9-6373-46d7-95bc-852f992fd1ff)
117
-
- Windows Server 2016: [KB5040562](https://support.microsoft.com/topic/kb5040562-servicing-stack-update-for-windows-10-version-1607-and-server-2016-july-9-2024-281c97b9-c566-417e-8406-a84efd30f70c)
118
-
- Windows Server 2019: [KB5005112](https://support.microsoft.com/topic/kb5005112-servicing-stack-update-for-windows-10-version-1809-august-10-2021-df6a9e0d-8012-41f4-ae74-b79f1c1940b2) and [KB5040430](https://support.microsoft.com/topic/july-9-2024-kb5040430-os-build-17763-6054-0bb10c24-db8c-47eb-8fa9-9ebc06afa4e7)
116
+
- Windows Server 2016 [Microsoft Update Catalog](https://catalog.update.microsoft.com/Search.aspx?q=cumulative%20windows%20server%202016) (latest cumulative update)
117
+
- Windows Server 2019 [Microsoft Update Catalog](https://catalog.update.microsoft.com/Search.aspx?q=cumulative%20windows%20server%202019) (latest cumulative update)
118
+
- Cumulative updates are released monthly. To deploy the latest update, users can either use Windows Update or manually download it from the [Microsoft Update Catalog](https://catalog.update.microsoft.com). If installing manually, users should review the associated KB article to ensure all prerequisites are met. If the Windows Updates aren't installed prior to installing the Azure File Sync agent, the Storage Sync Agent service (FileSyncSvc) will fail to start.
119
+
120
+
## Auto Update not upgrading ‘to be expired’ or expired Azure File Sync Agent
121
+
122
+
If Auto Update isn't upgrading your ‘to be expired’ or expired Azure File Sync agent, check if the agent expiration information is properly applied to the server. The expiration metadata is required for Auto Update to function as expected.
123
+
124
+
To verify whether the `AgentExpirationDate` is set, run the following command from an elevated PowerShell session:
If the `AgentExpirationDate` value isn't set or is empty, there might be a networking issue preventing the server from receiving expiration data. To test network connectivity, run the following command:
If network connectivity issues are reported, you can manually update the agent by downloading it from the [Microsoft Update Catalog](https://catalog.update.microsoft.com/Search.aspx?q=azure%20file%20sync).
137
+
After downloading the appropriate agent version, refer to the specific **Knowledge Base** article listed in the catalog for step-by-step installation instructions.
138
+
139
+
If connectivity issues aren't found and the `AgentExpirationDate` is still not set, contact Azure File Sync support for further assistance.
0 commit comments