Microsoft KB Archive Search

Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

  1. Home
  2. Azure File Sync Agent v7 Release – June 2019

Azure File Sync Agent v7 Release – June 2019

View products that this article applies to.

Introduction

This article describes the improvements and issues that are fixed in the Azure File Sync Agent v7 release that is dated June 2019. Additionally, this article contains installation instructions for the update.

↑ Back to the top

Improvements and issues that are fixed

  • Support for larger file share sizes
    • With the preview of larger, 100 TiB Azure file shares, we are increasing the support limits for file sync as well. In this first step, Azure File Sync now supports up to 50 million files in a single, syncing namespace. Other existing limits, for example the number of items per directory level, still apply.
  • Support for firewall and virtual network setting on storage accounts
  • PowerShell cmdlet to immediately sync files changed in the Azure file share
    • To immediately sync files that are changed in the Azure file share, the Invoke-AzStorageSyncChangeDetection PowerShell cmdlet can be used to manually initiate the detection of changes in the Azure file share. This cmdlet is intended for scenarios where some type of automated process is making changes in the Azure file share or the changes are done by an administrator (like moving files and directories into the share). For end user changes, the recommendation is to install the Azure File Sync agent in an IaaS VM and have end users access the file share through the IaaS VM. This way all changes will quickly sync to other agents without the need to use the Invoke-AzStorageSyncChangeDetection cmdlet. To learn more, see the Invoke-AzStorageSyncChangeDetection documentation.
  • Improved portal experience if you encounter files that are not syncing
    • If you have files that are failing to sync, we now differentiate between transient and persistent errors in the portal. Transient errors usually resolve themselves without the need for admin action. For example, a file that is currently in use will not sync until the file handle is closed. For persistent errors, we now show the number of files impacted by each error. The persistent error count is also displayed in the files not syncing column of all server endpoints in a sync group.
  • Improved Azure Backup file-level restore
    • Individual files restored using Azure Backup are now detected and synced to the server endpoint faster.
  • Improved cloud tiering recall cmdlet reliability
    • Invoke-StorageSyncFileRecall cmdlet now allows customers to specify per file retry count and per file retry delay similar to robocopy. Previously, this cmdlet would recall all tiered files under a given path in random order. With the new -Order parameter, this cmdlet will recall the hottest data first and honor the cloud tiering policy (stop recalling if the date policy is met or the volume free space is met; whichever happens first).
  • Support for TLS 1.2 only (TLS 1.0 and 1.1 is disabled)
    • Azure File Sync now supports using TLS 1.2 only on servers which have TLS 1.0 and 1.1 disabled. Prior to this improvement, server registration would fail if TLS 1.0 and 1.1 was disabled on the server.
  • Miscellaneous performance and reliability improvements for sync and cloud tiering
    • There are several reliability and performance improvements in this release. Some of them are targeted to make cloud tiering more efficient and Azure File Sync as a whole work better in those situations when you have a bandwidth throttling schedule set.

↑ Back to the top

More information about the Azure File Sync v7 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 may be required if files are in use during the update rollup installation.
  • The agent version for the v7 release is 7.0.0.0.

↑ Back to the top

How to obtain and install the Azure File Sync Agent

The Azure File Sync v7 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 that 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 v7 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 the Azure File Sync v7 release, 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:


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 KB4490495.log
For example, to install the Azure File Sync agent update for Server 2016, run the following command:
  • msiexec.exe /p StorageSyncAgent_WS2016_KB4490495.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB4490495.log

↑ Back to the top

Keywords: kbHotfixAuto, CI102823

↑ Back to the top

Article Info
Article ID : 4490495
Revision : 25
Created on : 10/8/2019
Published on : 10/8/2019
Exists online : False
Views : 341