|
2 | 2 | author: roygara
|
3 | 3 | ms.service: storage
|
4 | 4 | ms.topic: include
|
5 |
| -ms.date: 12/11/2018 |
| 5 | +ms.date: 5/13/2022 |
6 | 6 | ms.author: rogarana
|
7 | 7 | ---
|
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. |
9 | 9 |
|
10 | 10 | #### 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 |
13 | 13 |
|
14 | 14 | #### 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.** |
19 | 21 | 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).** |
21 | 23 | 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).** |
23 | 25 | 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.
|
24 | 26 |
|
25 | 27 | #### Automatic agent lifecycle management
|
@@ -55,7 +57,7 @@ Azure File Sync is a cloud service, which continuously introduces new features a
|
55 | 57 | - Major agent versions are supported for at least six months from the date of initial release.
|
56 | 58 | - We guarantee there is an overlap of at least three months between the support of major agent versions.
|
57 | 59 | - 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. |
59 | 61 |
|
60 | 62 | > [!Note]
|
61 | 63 | > 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