Skip to content

Commit e35e3ab

Browse files
Merge pull request #267640 from jeffpatt24/patch-5
Update file-sync-release-notes.md
2 parents dcff30f + a529a54 commit e35e3ab

File tree

1 file changed

+3
-84
lines changed

1 file changed

+3
-84
lines changed

articles/storage/file-sync/file-sync-release-notes.md

Lines changed: 3 additions & 84 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: storage
55
author: wmgries
66
ms.service: azure-file-storage
77
ms.topic: conceptual
8-
ms.date: 1/11/2024
8+
ms.date: 2/28/2024
99
ms.author: wgries
1010
---
1111

@@ -27,14 +27,13 @@ The following Azure File Sync agent versions are supported:
2727
| V15.2 Release - [KB5013875](https://support.microsoft.com/topic/9159eee2-3d16-4523-ade4-1bac78469280)| 15.2.0.0 | November 21, 2022 | Supported - Agent version will expire on March 19, 2024 |
2828
| V15.1 Release - [KB5003883](https://support.microsoft.com/topic/45761295-d49a-431e-98ec-4fb3329b0544)| 15.1.0.0 | September 19, 2022 | Supported - Agent version will expire on March 19, 2024 |
2929
| V15 Release - [KB5003882](https://support.microsoft.com/topic/2f93053f-869b-4782-a832-e3c772a64a2d)| 15.0.0.0 | March 30, 2022 | Supported - Agent version will expire on March 19, 2024 |
30-
| V14.1 Release - [KB5001873](https://support.microsoft.com/topic/d06b8723-c4cf-4c64-b7ec-3f6635e044c5)| 14.1.0.0 | December 1, 2021 | Supported - Agent version will expire on February 8, 2024 |
31-
| V14 Release - [KB5001872](https://support.microsoft.com/topic/92290aa1-75de-400f-9442-499c44c92a81)| 14.0.0.0 | October 29, 2021 | Supported - Agent version will expire on February 8, 2024 |
3230

3331
## Unsupported versions
3432
The following Azure File Sync agent versions have expired and are no longer supported:
3533

3634
| Milestone | Agent version number | Release date | Status |
3735
|----|----------------------|--------------|------------------|
36+
| V14 Release | 14.0.0.0 | N/A | Not Supported - Agent versions expired on February 8, 2024 |
3837
| V13 Release | 13.0.0.0 | N/A | Not Supported - Agent versions expired on August 8, 2022 |
3938
| V12 Release | 12.0.0.0 - 12.1.0.0 | N/A | Not Supported - Agent versions expired on May 23, 2022 |
4039
| V11 Release | 11.1.0.0 - 11.3.0.0 | N/A | Not Supported - Agent versions expired on March 28, 2022 |
@@ -72,6 +71,7 @@ The following release notes are for Azure File Sync version 17.2.0.0 (released F
7271
The Azure File Sync v17.2 release is a rollup update for the v17.0 and v17.1 releases:
7372
- [Azure File Sync Agent v17 Release - December 2023](https://support.microsoft.com/topic/azure-file-sync-agent-v17-release-december-2023-flighting-2d8cba16-c035-4c54-b35d-1bd8fd795ba9)
7473
- [Azure File Sync Agent v17.1 Release - February 2024](https://support.microsoft.com/topic/azure-file-sync-agent-v17-1-release-february-2024-security-only-update-bd1ce41c-27f4-4e3d-a80f-92f74817c55b)
74+
7575
**Note**: If your server has v17.1 agent installed, you don't need to install the v17.2 agent.
7676

7777
### Evaluation tool
@@ -396,84 +396,3 @@ The following items don't sync, but the rest of the system continues to operate
396396
### Cloud tiering
397397
- If a tiered file is copied to another location by using Robocopy, the resulting file isn't tiered. The offline attribute might be set because Robocopy incorrectly includes that attribute in copy operations.
398398
- When copying files using robocopy, use the /MIR option to preserve file timestamps. This will ensure older files are tiered sooner than recently accessed files.
399-
400-
## Version 14.1.0.0
401-
The following release notes are for Azure File Sync version 14.1.0.0 (released December 1, 2021). This release contains improvements for the Azure File Sync agent. These notes are in addition to the release notes listed for version 14.0.0.0.
402-
403-
### Improvements and issues that are fixed
404-
- Tiered files deleted on Windows Server 2022 are not detected by cloud tiering filter driver
405-
- This issue occurs because the DeleteFile API on Windows Server 2022 uses the FILE_DISPOSITION_INFORMATION_EX class to delete files. The v14.1 release adds support for detecting tiered files deleted using the FILE_DISPOSITION_INFORMATION_EX class.
406-
407-
> [!Note]
408-
> This issue can also impact Windows 2016 and Windows Server 2019 if a tiered file is deleted using the FILE_DISPOSITION_INFORMATION_EX class.
409-
410-
## Version 14.0.0.0
411-
The following release notes are for Azure File Sync version 14.0.0.0 (released October 29, 2021). This release contains improvements for the Azure File Sync service and agent.
412-
413-
### Improvements and issues that are fixed
414-
- Reduced transactions when cloud change enumeration job runs
415-
- Azure File Sync has a cloud change enumeration job that runs every 24 hours to detect changes made directly in the Azure file share and sync those changes to servers in your sync groups. We have made improvements to reduce the number of transactions when this job runs.
416-
417-
- Improved server endpoint deprovisioning guidance in the portal
418-
- When removing a server endpoint via the portal, we now provide step by step guidance based on the reason behind deleting the server endpoint, so that you can avoid data loss and ensure your data is where it needs to be (server or Azure file share). This feature also includes new PowerShell cmdlets (Get-StorageSyncStatus & New-StorageSyncUploadSession) that you can use on your local server to aid you through the deprovisioning process.
419-
420-
- Invoke-AzStorageSyncChangeDetection cmdlet improvements
421-
- Prior to the v14 release, if you made changes directly in the Azure file share, you could use the Invoke-AzStorageSyncChangeDetection cmdlet to detect the changes and sync them to the servers in your sync group. However, the cmdlet would fail to run if the path specified contained more than 10,000 items. We have improved the Invoke-AzStorageSyncChangeDetection cmdlet and the 10,000 item limit no longer applies when scanning the entire share. To learn more, see the [Invoke-AzStorageSyncChangeDetection](/powershell/module/az.storagesync/invoke-azstoragesyncchangedetection) documentation.
422-
423-
- Miscellaneous improvements
424-
- Azure File Sync is now supported in West US 3 region.
425-
- Fixed a bug that caused the FileSyncErrorsReport.ps1 script to not provide the list of all per-item errors.
426-
- Reduced transactions when a file consistently fails to upload due to a per-item sync error.
427-
- Reliability and telemetry improvements for cloud tiering and sync.
428-
429-
### Evaluation Tool
430-
Before deploying Azure File Sync, you should evaluate whether it's compatible with your system using the Azure File Sync evaluation tool. This tool is an Azure PowerShell cmdlet that checks for potential issues with your file system and dataset, such as unsupported characters or an unsupported OS version. For installation and usage instructions, see [Evaluation Tool](file-sync-planning.md#evaluation-cmdlet) section in the planning guide.
431-
432-
### Agent installation and server configuration
433-
For more information on how to install and configure the Azure File Sync agent with Windows Server, see [Planning for an Azure File Sync deployment](file-sync-planning.md) and [How to deploy Azure File Sync](file-sync-deployment-guide.md).
434-
435-
- A restart is required for servers that have an existing Azure File Sync agent installation if the agent version is less than version 12.0.
436-
- The agent installation package must be installed with elevated (admin) permissions.
437-
- The agent is not supported on Nano Server deployment option.
438-
- The agent is supported only on Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, and Windows Server 2022.
439-
- The agent requires at least 2 GiB of memory. If the server is running in a virtual machine with dynamic memory enabled, the VM should be configured with a minimum 2048 MiB of memory. See [Recommended system resources](file-sync-planning.md#recommended-system-resources) for more information.
440-
- The Storage Sync Agent (FileSyncSvc) service does not support server endpoints located on a volume that has the system volume information (SVI) directory compressed. This configuration will lead to unexpected results.
441-
442-
### Interoperability
443-
- Antivirus, backup, and other applications that access tiered files can cause undesirable recall unless they respect the offline attribute and skip reading the content of those files. For more information, see [Troubleshoot Azure File Sync](/troubleshoot/azure/azure-storage/file-sync-troubleshoot?toc=/azure/storage/file-sync/toc.json).
444-
- File Server Resource Manager (FSRM) file screens can cause endless sync failures when files are blocked because of the file screen.
445-
- Running sysprep on a server that has the Azure File Sync agent installed is not supported and can lead to unexpected results. The Azure File Sync agent should be installed after deploying the server image and completing sysprep mini-setup.
446-
447-
### Sync limitations
448-
The following items don't sync, but the rest of the system continues to operate normally:
449-
- Files with unsupported characters. See [Troubleshooting guide](/troubleshoot/azure/azure-storage/file-sync-troubleshoot-sync-errors?toc=/azure/storage/file-sync/toc.json#handling-unsupported-characters) for a list of unsupported characters.
450-
- Files or directories that end with a period.
451-
- Paths that are longer than 2,048 characters.
452-
- The system access control list (SACL) portion of a security descriptor that's used for auditing.
453-
- Extended attributes.
454-
- Alternate data streams.
455-
- Reparse points.
456-
- Hard links.
457-
- Compression (if it's set on a server file) isn't preserved when changes sync to that file from other endpoints.
458-
- Any file that's encrypted with EFS (or other user mode encryption) that prevents the service from reading the data.
459-
460-
> [!Note]
461-
> Azure File Sync always encrypts data in transit. Data is always encrypted at rest in Azure.
462-
463-
### Server endpoint
464-
- A server endpoint can be created only on an NTFS volume. ReFS, FAT, FAT32, and other file systems aren't currently supported by Azure File Sync.
465-
- Cloud tiering is not supported on the system volume. To create a server endpoint on the system volume, disable cloud tiering when creating the server endpoint.
466-
- Failover Clustering is supported only with clustered disks, but not with Cluster Shared Volumes (CSVs).
467-
- A server endpoint can't be nested. It can coexist on the same volume in parallel with another endpoint.
468-
- Do not store an OS or application paging file within a server endpoint location.
469-
470-
### Cloud endpoint
471-
- Azure File Sync supports making changes to the Azure file share directly. However, any changes made on the Azure file share first need to be discovered by an Azure File Sync change detection job. A change detection job is initiated for a cloud endpoint once every 24 hours. To immediately sync files that are changed in the Azure file share, the [Invoke-AzStorageSyncChangeDetection](/powershell/module/az.storagesync/invoke-azstoragesyncchangedetection) PowerShell cmdlet can be used to manually initiate the detection of changes in the Azure file share. In addition, changes made to an Azure file share over the REST protocol will not update the SMB last modified time and will not be seen as a change by sync.
472-
- The storage sync service and/or storage account can be moved to a different resource group, subscription, or Azure AD tenant. After the storage sync service or storage account is moved, you need to give the Microsoft.StorageSync application access to the storage account (see [Ensure Azure File Sync has access to the storage account](/troubleshoot/azure/azure-storage/file-sync-troubleshoot-sync-errors?toc=/azure/storage/file-sync/toc.json#troubleshoot-rbac)).
473-
474-
> [!Note]
475-
> When creating the cloud endpoint, the storage sync service and storage account must be in the same Azure AD tenant. Once the cloud endpoint is created, the storage sync service and storage account can be moved to different Azure AD tenants.
476-
477-
### Cloud tiering
478-
- If a tiered file is copied to another location by using Robocopy, the resulting file isn't tiered. The offline attribute might be set because Robocopy incorrectly includes that attribute in copy operations.
479-
- When copying files using robocopy, use the /MIR option to preserve file timestamps. This will ensure older files are tiered sooner than recently accessed files.

0 commit comments

Comments
 (0)