Introduction
This article describes the improvements and issues that are fixed in the Azure File Sync Agent v10 release that is dated March 2020. Additionally, this article contains installation instructions for the update.
Improvements and issues that are fixed
Improved sync progress in the portal
-
With the V10 agent release, the Azure portal will soon begin to show the type of sync session that is running. E.g. initial download, regular download, background recall (fast disaster recovery cases) and similar.
Improved cloud tiering portal experience
-
If you have files that are failing to tier or recall, you can now view the tiering errors in the server endpoint properties.
-
Additional cloud tiering information is available for a server endpoint:
-
-
Local cache size
-
Cache usage efficiency
-
Cloud tiering policy details: volume size, current free space, or the last accessed time of the oldest file in the local cache.
-
-
These changes will ship in the Azure portal shortly after the initial V10 agent release.
Support for moving the Storage Sync Service and/or storage account to a different Azure Active Directory (AAD) tenant
-
Azure File Sync now supports moving the Storage Sync Service and/or storage account to a different resource group, subscription or Azure AD tenant.
Miscellaneous performance and reliability improvements
-
Change detection on the Azure file share may fail if virtual network (VNET) and firewall rules are configured on the storage account.
-
Reduced memory consumption associated with recall.
-
Improved performance when using the Invoke-AzStorageSyncChangeDetection cmdlet.
-
Other miscellaneous reliability improvements.
More information about the Azure File Sync v10 release
-
This update is available for Windows Server 2012 R2, Windows Server 2016 and Windows Server 2019 installations.
-
Azure File Sync agent version 4.0.1.0 or a later version is required to upgrade existing agent installations.
-
A restart is required for servers that have an existing Azure File Sync agent installation.
-
The agent version for the v10 release is 10.0.0.0.
How to obtain and install the Azure File Sync Agent
The Azure File Sync v10 release is currently being flighted to servers which are configured to automatically update when a new version becomes available. Once fighting completes, this update will be available on Microsoft Update and Microsoft Download Center. Flighting means the release is offered to a limited number of servers first and expands to more severs gradually. It may not be offered to your server right away even if it’s configured to automatically update when a new version becomes available. To immediately install the Azure File Sync v10 release, manually download the update from the Microsoft Update Catalog.
To learn more about Azure File Sync agent auto-update, see automatic agent lifecycle management.
To obtain and install this update, configure your Azure File Sync agent to automatically update when a new version becomes available or manually download the update from the Microsoft Update Catalog.
Configure your Azure File Sync agent to automatically update when a new version becomes available
Agent installation
-
During the Azure File Sync agent installation (version 6.0 or later), select the “Automatically update when a new version becomes available” setting.
Post-agent installation
-
If the agent is already installed (version 6.0 or later), run the following PowerShell commands to configure auto-update:
-
-
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
-
Set-StorageSyncAgentAutoUpdate -PolicyMode InstallLatest -Day <day> -Hour <hour>
-
Manually download and install the Azure File Sync agent update from the Microsoft Update Catalog
Go to the following website to manually download this update from the Microsoft Update Catalog:
Azure File Sync Agent v10 release: March 2020 (KB4522409)
To manually install the update package, run the following command from an elevated command prompt:
-
msiexec.exe /p packagename.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB4522409.log
For example, to install the Azure File Sync agent update for Server 2016, run the following command:
-
msiexec.exe /p StorageSyncAgent_WS2016_KB4522409.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB4522409.log
