Skip to content

Commit 060c730

Browse files
authored
Merge pull request #9357 from MicrosoftDocs/rladbsal-patch-3
Update file-sync-troubleshoot.md
2 parents ceba92f + c5b376c commit 060c730

File tree

1 file changed

+27
-6
lines changed

1 file changed

+27
-6
lines changed

support/azure/azure-storage/files/file-sync/file-sync-troubleshoot.md

Lines changed: 27 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Troubleshoot common issues that you might encounter with Azure File
44
author: khdownie
55
ms.service: azure-file-storage
66
ms.topic: troubleshooting
7-
ms.date: 01/13/2025
7+
ms.date: 07/16/2025
88
ms.author: kendownie
99
ms.custom: sap:File Sync
1010
---
@@ -89,7 +89,7 @@ To run AFSDiag, perform the steps below:
8989
9090
## Storage Sync Agent service (FileSyncSvc) fails to start
9191
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:
9393
9494
- The Storage Sync Agent service (FileSyncSvc) fails to start with the following error:
9595
@@ -110,12 +110,33 @@ After installing or upgrading the Azure File Sync agent (v17.3 or later), you ma
110110
Exception occurred while configuring MitigationRedirection policy. This could indicate that required windows updates not installed on the computer.
111111
```
112112

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.
114114

115115
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:
125+
126+
```powershell
127+
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
128+
Get-StorageSyncServer
129+
```
130+
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:
131+
132+
```powershell
133+
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
134+
Test-StorageSyncNetworkConnectivity
135+
```
136+
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.
119140

120141
## High memory usage on the server
121142

0 commit comments

Comments
 (0)