Skip to content

Commit 470740a

Browse files
author
Simonx Xu
authored
Merge pull request #9326 from AmandaAZ/Branch-PostEdit
AB#6638: Post Edit for PR#9320
2 parents aa6c0b6 + 9f3b11b commit 470740a

1 file changed

Lines changed: 11 additions & 11 deletions

File tree

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

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Troubleshoot Azure File Sync agent installation and server registration
33
description: Troubleshoot common issues with installing the Azure File Sync agent and registering Windows Server with the Storage Sync Service.
44
author: khdownie
55
ms.service: azure-file-storage
6-
ms.date: 07/11/2025
6+
ms.date: 07/14/2025
77
ms.author: kendownie
88
ms.custom: sap:File Sync
99
---
@@ -124,26 +124,26 @@ To learn about installing the Azure File Sync Agent for Windows, see [Install an
124124
1. Navigate to your **Arc Server** in the Azure portal.
125125
1. Go to the **Extensions** blade for the server.
126126
1. Locate `AzureFileSyncAgentExtension` and select **View Details** under the **Status** column.
127-
1. Review the **Error Message** field for detailed information on why the extension deployment failed.
127+
1. Review the **Error Message** field for detailed information about the cause of the extension deployment failure.
128128

129129
> [!IMPORTANT]
130-
> The failed extension must be uninstalled and then reinstalled **after** performing the required remediation steps. Save the error message details for troubleshooting or when contacting Azure File Sync support. Uninstalling the extension will remove these details.
130+
> The failed extension must be uninstalled and then reinstalled after performing the required remediation steps. Save error message details for troubleshooting or contacting Azure File Sync support, as uninstalling the failed extension will delete these details.
131131
132132
#### Error code reference and remediation
133133

134-
| **Error Message** | **Error Code** | **Remediation Steps** |
134+
| **Error Message** | **Error Code** | **Remediation steps** |
135135
|-------------------|----------------|------------------------|
136-
| Cannot install Azure File Sync agent because .NET Framework 4.7.2 or later is required. Install the latest .NET Framework and try again | 206 | Install .NET Framework 4.7.2 or higher. Reboot the machine afterward. |
136+
| Cannot install Azure File Sync agent because .NET Framework 4.7.2 or later is required. Install the latest .NET Framework and try again | 206 | Install .NET Framework 4.7.2 or later, then restart your computer. |
137137
| Azure File Sync agent is already installed. No further action needed. | 0 | No action required. The extension is installed, but no customization is applied. |
138138
| The Azure File Sync agent is only supported on RTM (Release to Manufacturing) versions of supported operating systems. | 51 | Azure File Sync agent and extension are supported only on RTM versions of Windows Server 2016, 2019, 2022, and 2025. |
139-
| Proxy settings error. `UseCustomProxy` is enabled but ProxyAddress is missing or invalid. ProxyAddress must be specified without port and length must be less than 255 characters. | 201 | Ensure `ProxyAddress` is specified. Must be under 255 characters. |
140-
| Proxy settings error. `UseCustomProxy` is enabled but ProxyPort is missing or invalid. Proxy port must be a number between 1 and 65535 | 202 | Provide a valid `ProxyPort` (numeric value between 1 and 65535) when `UseCustomProxy` is enabled. |
139+
| Proxy settings error. `UseCustomProxy` is enabled but ProxyAddress is missing or invalid. ProxyAddress must be specified without port and length must be less than 255 characters. | 201 | Ensure that the `ProxyAddress` is specified and doesn't exceed 255 characters in length. |
140+
| Proxy settings error. `UseCustomProxy` is enabled but ProxyPort is missing or invalid. Proxy port must be a number between 1 and 65535 | 202 | Provide a valid `ProxyPort` (a numeric value between 1 and 65535) when `UseCustomProxy` is enabled. |
141141
| Proxy settings error. `ProxyAuthRequired` is enabled but ProxyUsername is missing or invalid. `ProxyUsername` length must be between 3 and 255 characters | 203 | Ensure `ProxyUsername` is specified and its length is between 3 and 255 characters. |
142142
| Proxy settings error. `ProxyAuthRequired` is enabled but ProxyPassword is missing or empty | 204 | Provide a non-empty `ProxyPassword` when `ProxyAuthRequired` is enabled. |
143-
| A system reboot is pending due to Storage Sync file rename operations. Restart your server before installing the Azure File Sync agent. | 83 | A reboot is required. Restart the server before attempting agent installation again. |
144-
| The file signature is not valid. Or Signature validation failed for the downloaded MSI file | 86 | The installer file might be corrupted or tampered with. Re-download the MSI file from a trusted source. |
145-
| Certificate chain validation failed. | 86 | Ensure the required root certificates are installed. Refer to [this documentation](/azure/aks/aksarc/aks-edge-howto-offline-install).<br><br>**If using a proxy**, ensure the following domains are bypassed:<br>`login.microsoftonline.com`, `management.azure.com`, `go.microsoft.com`, `download.microsoft.com`, `download.windowsupdate.com`, `crl.microsoft.com`, `oneocsp.microsoft.com`, `ocsp.msocsp.com`, `www.microsoft.com`.<br><br>Restart the machine to apply any updates. |
146-
| Azure File Sync agent download or configuration failed. Details: Failed to configure auto update settings: Agent install directory not found in registry. Please check the installation. | 214 | 1. Open an elevated PowerShell session and check if .NET 4.7.2 or higher is installed:<br>```$releaseKey = (Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" -ErrorAction SilentlyContinue).Release```<br>2. If `$releaseKey` is less than `461808`, .NET 4.7.2 isn't installed.<br>3. Download and install .NET Framework 4.7.2 or later from the [official .NET download site](https://dotnet.microsoft.com/download/dotnet-framework). |
143+
| A system reboot is pending due to Storage Sync file rename operations. Restart your server before installing the Azure File Sync agent. | 83 | A reboot is required. Restart the server before installing the agent again. |
144+
| The file signature is not valid. Or Signature validation failed for the downloaded MSI file | 86 | The installer file might be corrupted or tampered with. Download the MSI file again from a trusted source. |
145+
| Certificate chain validation failed. | 86 | Ensure the required root certificates are installed. Refer to [Prerequisites for AKS Edge Essentials offline installation](/azure/aks/aksarc/aks-edge-howto-offline-install).<br><br>If using a proxy, ensure the following domains are bypassed:<br>`login.microsoftonline.com`, `management.azure.com`, `go.microsoft.com`, `download.microsoft.com`, `download.windowsupdate.com`, `crl.microsoft.com`, `oneocsp.microsoft.com`, `ocsp.msocsp.com`, `www.microsoft.com`.<br><br>Restart the computer to apply any updates. |
146+
| Azure File Sync agent download or configuration failed. Details: Failed to configure auto update settings: Agent install directory not found in registry. Please check the installation. | 214 | Open an elevated PowerShell session and check if .NET 4.7.2 or higher is installed:<br>```$releaseKey = (Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" -ErrorAction SilentlyContinue).Release```<br><br>If `$releaseKey` is less than `461808`, .NET 4.7.2 isn't installed. In this case, download and install .NET Framework 4.7.2 or later from the [official .NET download site](https://dotnet.microsoft.com/download/dotnet-framework). |
147147

148148
## Server registration
149149

0 commit comments

Comments
 (0)