Skip to content

Commit a4a9ded

Browse files
committed
Piyush final edits
1 parent 7bd94cc commit a4a9ded

File tree

1 file changed

+12
-8
lines changed

1 file changed

+12
-8
lines changed

articles/storage/files/storage-files-migration-nfs.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,16 @@ description: Learn how to migrate from Linux file servers to NFS Azure file shar
44
author: khdownie
55
ms.service: azure-file-storage
66
ms.topic: how-to
7-
ms.date: 12/18/2023
7+
ms.date: 12/19/2023
88
ms.author: kendownie
99
---
1010

1111
# Migrate to NFS Azure file shares
1212

13-
This article covers the basic aspects of migrating from Linux file servers to NFS Azure file shares, which are only available as Premium file shares (FileStorage account kind). We'll also compare the open source file copy tools fpsync and rsync to understand how they perform in different situations when copying data to Azure file shares.
13+
This article covers the basic aspects of migrating from Linux file servers to NFS Azure file shares, which are only available as Premium file shares (FileStorage account kind). We'll also compare the open source file copy tools fpsync and rsync to understand how they perform when copying data to Azure file shares.
1414

1515
> [!NOTE]
16-
> The open source tools mentioned in this article are well-known third-party solutions. They aren't developed, owned, or supported by Microsoft, either directly or indirectly. It's the customer's responsibility to examine the software license and support statement provided in the third party's documentation.
16+
> Azure Files doesn't support NFS access control lists (ACLs).
1717
1818
## Applies to
1919

@@ -91,8 +91,8 @@ Make sure your destination (target) Azure file share is mounted to a Linux VM. S
9191

9292
If you're doing a full migration, you'll copy your data in three phases:
9393

94-
1. **Baseline copy:** Copy from source to destination when no data exists on the destination.
95-
1. **Incremental copy:** Copy only the incremental changes from source to destination. This should be done multiple times in order to capture all the changes.
94+
1. **Baseline copy:** Copy from source to destination when no data exists on the destination. For baseline copy, we recommend using fpsync with cpio as the copy tool.
95+
1. **Incremental copy:** Copy only the incremental changes from source to destination. For incremental sync, we recommend using fpsync with rsync as the copy tool. This should be done multiple times in order to capture all the changes.
9696
1. **Final pass:** A final pass is needed to delete any files on the destination that don't exist at the source.
9797

9898
Copying data with fpsync always involves some version of this command:
@@ -103,7 +103,7 @@ fpsync -m <specify copy tool - rsync/cpio/tar> -n <parallel transfers> <absolute
103103

104104
### Baseline copy
105105

106-
For baseline copy, we recommend using fpsync with cpio as the copy tool.
106+
For baseline copy, use fpsync with cpio.
107107

108108
```bash
109109
fpsync -m cpio –n <parallel transfers> <absolute source path> <absolute destination path>
@@ -113,7 +113,7 @@ For more information, see [Cpio and Tar support](http://www.fpart.org/fpsync/#cp
113113

114114
### Incremental copy
115115

116-
For incremental sync, we recommend using fpsync with the default copy tool (rsync). To capture all the changes, we recommend running this several times.
116+
For incremental sync, use fpsync with the default copy tool (rsync). To capture all the changes, we recommend running this several times.
117117

118118
```bash
119119
fpsync –n <parallel transfers> <absolute source path> <absolute destination path>
@@ -142,7 +142,7 @@ The following table lists the different datasets we used to compare copy tool pe
142142

143143
The tests were performed on Azure Standard_D8s_v3 VMs with 8 vCPUs, 32 GiB of memory, and more than 1 TiB of disk space for large datasets. For the target, we configured NFS Azure File shares with more than 1 TiB provisioned size.
144144

145-
### Experiments and results: rsync vs. fpsync+cpio
145+
### Experiments and results: rsync vs. fpsync
146146

147147
Based on our experiments with the above configurations, we observed that fpsync performed best when used with 64 threads with rsync and 16 threads with cpio for an Azure NFS file share mounted with `nconnect=8`. Actual results will vary based on your configuration and datasets.
148148

@@ -189,6 +189,10 @@ The following table summarizes the results:
189189
| 2 (baseline) | 191,345 | 3,906 | 0-32 KiB | 3 GiB | 191.86 mins | 0.27 MiB/s | 8.47 mins | 6.04 MiB/s | 2,164% |
190190
| 3 (baseline) | 5,000 | 1 | 10 MiB | 50 GiB | 8.12 mins | 105.04 MiB/s | 2.76 mins | 308.90 MiB/s | 194% |
191191

192+
## Third-party information disclaimer
193+
194+
The open source tools mentioned in this article are well-known third-party solutions. They aren't developed, owned, or supported by Microsoft, either directly or indirectly. It's the customer's responsibility to examine the software license and support statement provided in the third party's documentation.
195+
192196
## Next steps
193197

194198
- [Improve NFS Azure file share performance](nfs-performance.md)

0 commit comments

Comments
 (0)