Skip to content

Commit 95e3b23

Browse files
authored
Merge pull request #198185 from jeffpatt24/patch-6
Update storage-sync-files-agent-update-policy.md
2 parents 23ed9ee + 9877f70 commit 95e3b23

File tree

1 file changed

+13
-11
lines changed

1 file changed

+13
-11
lines changed

includes/storage-sync-files-agent-update-policy.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,24 +2,26 @@
22
author: roygara
33
ms.service: storage
44
ms.topic: include
5-
ms.date: 12/11/2018
5+
ms.date: 5/13/2022
66
ms.author: rogarana
77
---
8-
The Azure File Sync agent is updated on a regular basis to add new functionality and to address issues. We recommend you configure Microsoft Update to get updates for the Azure File Sync agent as they're available.
8+
The Azure File Sync agent is updated on a regular basis to add new functionality and to address issues. We recommend updating the Azure File Sync agent as new versions are available.
99

1010
#### Major vs. minor agent versions
11-
* Major agent versions often contain new features and have an increasing number as the first part of the version number. For example: \*2.\*.\*\*
12-
* Minor agent versions are also called "patches" and are released more frequently than major versions. They often contain bug fixes and smaller improvements but no new features. For example: \*\*.3.\*\*
11+
* Major agent versions often contain new features and have an increasing number as the first part of the version number. For example: 14.0.0.0
12+
* Minor agent versions are also called "patches" and are released more frequently than major versions. They often contain bug fixes and smaller improvements but no new features. For example: 14.1.0.0
1313

1414
#### Upgrade paths
15-
There are four approved and tested ways to install the Azure File Sync agent updates.
16-
1. **(Preferred) Configure Microsoft Update to automatically download and install agent updates.**
17-
We always recommend taking every Azure File Sync update to ensure you have access to the latest fixes for the server agent. Microsoft Update makes this process seamless, by automatically downloading and installing updates for you.
18-
2. **Use AfsUpdater.exe to download and install agent updates.**
15+
There are five approved and tested ways to install the Azure File Sync agent updates.
16+
1. **Use Azure File Sync agent auto-upgrade feature to install agent updates.**
17+
The Azure File Sync agent will auto-upgrade. You can select to install the latest agent version when available or update when the currently installed agent is near expiration. To learn more, see [Automatic agent lifecycle management](#automatic-agent-lifecycle-management).
18+
2. **Configure Microsoft Update to automatically download and install agent updates.**
19+
We recommend installing every Azure File Sync update to ensure you have access to the latest fixes for the server agent. Microsoft Update makes this process seamless, by automatically downloading and installing updates for you.
20+
3. **Use AfsUpdater.exe to download and install agent updates.**
1921
The AfsUpdater.exe is located in the agent installation directory. Double-click the executable to download and install agent updates.
20-
3. **Patch an existing Azure File Sync agent by using a Microsoft Update patch file, or a .msp executable. The latest Azure File Sync update package can be downloaded from the [Microsoft Update Catalog](https://www.catalog.update.microsoft.com/Search.aspx?q=Azure%20File%20Sync).**
22+
4. **Patch an existing Azure File Sync agent by using a Microsoft Update patch file, or a .msp executable. The latest Azure File Sync update package can be downloaded from the [Microsoft Update Catalog](https://www.catalog.update.microsoft.com/Search.aspx?q=Azure%20File%20Sync).**
2123
Running a .msp executable will upgrade your Azure File Sync installation with the same method used automatically by Microsoft Update in the previous upgrade path. Applying a Microsoft Update patch will perform an in-place upgrade of an Azure File Sync installation.
22-
4. **Download the newest Azure File Sync agent installer from the [Microsoft Download Center](https://go.microsoft.com/fwlink/?linkid=858257).**
24+
5. **Download the newest Azure File Sync agent installer from the [Microsoft Download Center](https://go.microsoft.com/fwlink/?linkid=858257).**
2325
To upgrade an existing Azure File Sync agent installation, uninstall the older version and then install the latest version from the downloaded installer. The server registration, sync groups, and any other settings are maintained by the Azure File Sync installer.
2426

2527
#### Automatic agent lifecycle management
@@ -55,7 +57,7 @@ Azure File Sync is a cloud service, which continuously introduces new features a
5557
- Major agent versions are supported for at least six months from the date of initial release.
5658
- We guarantee there is an overlap of at least three months between the support of major agent versions.
5759
- Warnings are issued for registered servers using a soon-to-be expired agent at least three months prior to expiration. You can check if a registered server is using an older version of the agent under the registered servers section of a Storage Sync Service.
58-
- The lifetime of a minor agent version is bound to the associated major version. For example, when agent version 3.0 is released, agent versions 2.\* will all be set to expire together.
60+
- The lifetime of a minor agent version is bound to the associated major version. For example, when agent version 12.0.0.0 is set to expire, agent versions 12.\*.\*.\* will all be set to expire together.
5961

6062
> [!Note]
6163
> Installing an agent version with an expiration warning will display a warning but succeed. Attempting to install or connect with an expired agent version is not supported and will be blocked.

0 commit comments

Comments
 (0)