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
+14-9Lines changed: 14 additions & 9 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: 07/16/2025
7
+
ms.date: 07/21/2025
8
8
ms.author: kendownie
9
9
ms.custom: sap:File Sync
10
10
---
@@ -113,30 +113,35 @@ After installing or upgrading the Azure File Sync agent (v18 or later), you migh
113
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
+
116
117
- Windows Server 2016 [Microsoft Update Catalog](https://catalog.update.microsoft.com/Search.aspx?q=cumulative%20windows%20server%202016) (latest cumulative update)
117
118
- 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
119
+
120
+
Cumulative updates are released monthly. To deploy the latest update, you can use Windows Update or download it from the [Microsoft Update Catalog](https://catalog.update.microsoft.com). Before manual installation, review the associated Knowledge Base (KB) article to ensure all prerequisites are met. If Windows updates aren't installed before installing the Azure File Sync agent, the Storage Sync Agent service (FileSyncSvc) will fail to start.
121
+
122
+
## Auto Update can't upgrade a "to be expired" or expired Azure File Sync agent
121
123
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.
124
+
If Auto Update fails to upgrade your Azure File Sync agent that is about to expire or has expired, verify that the agent expiration information is properly applied to the server. The expiration metadata is required for Auto Update to function as expected.
123
125
124
-
To verify whether the `AgentExpirationDate` is set, run the following command from an elevated PowerShell session:
126
+
To verify whether the `AgentExpirationDate`metadata 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:
132
+
133
+
If the `AgentExpirationDate` metadata isn't set or its value is empty, there might be a networking issue that prevents the server from receiving the 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
141
139
-
If connectivity issues aren't found and the `AgentExpirationDate` is still not set, contact Azure File Sync support for further assistance.
142
+
After downloading the appropriate agent version, refer to the specific KB article in the catalog for step-by-step installation instructions.
143
+
144
+
If there are no connectivity issues and the `AgentExpirationDate` metadata is still not set, contact Azure File Sync support for further assistance.
0 commit comments