Skip to content

Commit 689a907

Browse files
authored
Merge pull request #9378 from AmandaAZ/Branch-CI6722
AB#6722: Post Edit PR#9357
2 parents 7b09f31 + 65c3279 commit 689a907

1 file changed

Lines changed: 14 additions & 9 deletions

File tree

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

Lines changed: 14 additions & 9 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: 07/16/2025
7+
ms.date: 07/21/2025
88
ms.author: kendownie
99
ms.custom: sap:File Sync
1010
---
@@ -113,30 +113,35 @@ After installing or upgrading the Azure File Sync agent (v18 or later), you migh
113113
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+
116117
- Windows Server 2016 [Microsoft Update Catalog](https://catalog.update.microsoft.com/Search.aspx?q=cumulative%20windows%20server%202016) (latest cumulative update)
117118
- 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
121123

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

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:
125127

126128
```powershell
127129
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
128130
Get-StorageSyncServer
129131
```
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:
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:
131134

132135
```powershell
133136
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
134137
Test-StorageSyncNetworkConnectivity
135138
```
139+
136140
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.
138141

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

141146
## High memory usage on the server
142147

0 commit comments

Comments
 (0)