Skip to content

Commit bd0e8df

Browse files
authored
Merge pull request #264123 from khdownie/kendownie012424-3
Storage Mover Files migration
2 parents 459c229 + 16d3cde commit bd0e8df

File tree

3 files changed

+89
-8
lines changed

3 files changed

+89
-8
lines changed

articles/storage/files/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,8 @@
4949
href: migrate-files-between-shares.md
5050
- name: Target a cloud-only deployment
5151
items:
52+
- name: Use Azure Storage Mover to migrate to SMB Azure file shares
53+
href: migrate-files-storage-mover.md
5254
- name: Use Robocopy to migrate to SMB Azure file shares
5355
href: storage-files-migration-robocopy.md
5456
- name: Migrate from an on-premises NAS to Azure file shares with DataBox
Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
title: Migrate to SMB Azure file shares using Azure Storage Mover
3+
description: Learn how to migrate on-premises file shares to SMB Azure file shares with full fidelity using Azure Storage Mover, a fully managed migration service.
4+
ms.service: azure-file-storage
5+
ms.topic: how-to
6+
ms.date: 01/24/2024
7+
ms.author: kendownie
8+
author: khdownie
9+
---
10+
11+
# Migrate to SMB Azure file shares using Azure Storage Mover
12+
13+
This migration guide describes how to migrate on-premises files to SMB Azure file shares with full fidelity using [Azure Storage Mover](../../storage-mover/service-overview.md), a fully managed migration service. You can use Azure Storage Mover to migrate from any SMB source share, including Windows Server, Linux, or NAS. You must have port 443 open outbound on the source in order to use Azure Storage Mover for Azure Files migrations. However, you don't need an SMB connection to your Azure file share because Azure Storage Mover uses the FileREST API to move the data instead of SMB.
14+
15+
> [!NOTE]
16+
> If you're using or plan to use Azure File Sync for cloud tiering and on-premises caching, you can use Azure File Sync to migrate [on-premises NAS](storage-files-migration-nas-hybrid.md) or [Windows Server](../file-sync/file-sync-extend-servers.md) file shares instead of using Azure Storage Mover. If you don't plan to use Azure File Sync long term, use Azure Storage Mover for your migration.
17+
18+
## Applies to
19+
20+
| File share type | SMB | NFS |
21+
|-|:-:|:-:|
22+
| Standard file shares (GPv2), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
23+
| Standard file shares (GPv2), GRS/GZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
24+
| Premium file shares (FileStorage), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
25+
26+
## Why use Azure Storage Mover for Azure Files migrations?
27+
28+
There are several reasons to use Azure Storage Mover to migrate your on-premises SMB file shares to Azure Files.
29+
30+
- It's faster than other methods such as Robocopy that depend on SMB to move the data to the cloud.
31+
- [Supported file metadata](storage-files-migration-overview.md#supported-metadata) is copied with full fidelity. Unlike object storage in Azure Blobs, an Azure file share can natively store file metadata, and it's important to make sure metadata gets copied from source to target during a migration.
32+
- It scales well, having been tested with 100 million namespace items (files and folders) from an SMB mount to Azure Files.
33+
34+
## Prerequisites
35+
36+
To use Azure Storage Mover to migrate your SMB file shares, the following are required:
37+
38+
- An Azure subscription and resource group. [Review required permissions](../../storage-mover/deployment-planning.md#permissions).
39+
- An Azure storage account with at least one SMB Azure file share.
40+
- Your local network must allow the Storage Mover agent to communicate with Azure. Port 443 (TLS) must be open outbound, and your firewall rules shouldn't limit traffic to Azure. Use the connectivity checker on the Storage Mover agent console to learn about the endpoint URLs in Azure that you must allow.
41+
42+
> [!NOTE]
43+
> Azure Storage Mover supports using an SMB mount as the source and an SMB Azure file share as the target. Migrating data between other source-target pairs, such as source data on an NFS share to an Azure file share target, isn't currently supported.
44+
45+
## Migrate files and metadata using Azure Storage Mover
46+
47+
To migrate your data to Azure Files, follow these steps.
48+
49+
1. First, [create an Azure Storage Mover resource](../../storage-mover/storage-mover-create.md).
50+
51+
1. Next, [deploy one or more Storage Mover agents](../../storage-mover/agent-deploy.md) close to your on-premises migration sources. These are virtual machines (VMs) that can run on Hyper-V or VMware hypervisors.
52+
53+
1. To utilize your agent for a migration and manage it from the cloud, you need to [register the agent VM(s) with your Azure Storage Mover resource](../../storage-mover/agent-register.md). You need to connect locally over SSH to the agent for registration, and all subsequent steps are managed from the Azure portal, Azure PowerShell, or Azure CLI.
54+
55+
1. Now you must [define your source and target endpoints](../../storage-mover/endpoint-manage.md) in preparation for migrating your data. When creating the target endpoint, select **File share** for **Target type**.
56+
57+
1. [Create a project](../../storage-mover/project-manage.md) to collate the shares that need to be migrated together.
58+
59+
1. [Create an Azure Key Vault](../../key-vault/general/quick-create-portal.md) and place two secrets in it: one for the username and one for the password the agent can use to access the source SMB share.
60+
61+
1. [Define your first migration job](../../storage-mover/job-definition-create.md) in your Storage Mover project, using the source and target pair you've created. For the first migration job, it's best to use the Azure portal. You'll create multiple resources within your Storage Mover resource. There will be a source endpoint and a target endpoint, as well as a few migration settings you should review carefully. In addition, you'll reference the Azure Key Vault secrets when creating your migration job.
62+
63+
1. Once your migration job and its settings are as you want them, you can start the job. Telemetry and copy logs will help you monitor the progress and success of your migration job. If you want to estimate the time required to perform your migration job, see [Azure Storage Mover scale and performance targets](../../storage-mover/performance-targets.md#performance-baselines).
64+
65+
## Verify that the migration succeeded
66+
67+
When the migration job is complete, you should find all the files and folders in your Azure file share, with full fidelity. Review the copy logs to make sure nothing was left behind.
68+
69+
## Next steps
70+
71+
Make sure you've [enabled backup](../../backup/azure-file-share-backup-overview.md) for your Azure file shares.
72+
73+
## See also
74+
75+
- [What is Azure Storage Mover?](../../storage-mover/service-overview.md)
76+
- [Plan a successful Azure Storage Mover deployment](../../storage-mover/deployment-planning.md)
77+
- [Migrate to Azure file shares using Robocopy](storage-files-migration-robocopy.md)
78+
- [Migrate files from one Azure file share to another when using Azure File Sync](../file-sync/file-sync-share-to-share-migration.md)

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

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to migrate to SMB Azure file shares and find your migrati
44
author: khdownie
55
ms.service: azure-file-storage
66
ms.topic: conceptual
7-
ms.date: 12/14/2023
7+
ms.date: 01/24/2024
88
ms.author: kendownie
99
---
1010

@@ -13,6 +13,7 @@ ms.author: kendownie
1313
This article covers the basic aspects of a migration to SMB Azure file shares and contains a table of migration guides. These guides help you move your files into Azure file shares. The guides are organized based on where your data is and what deployment model (cloud-only or hybrid) you're moving to.
1414

1515
## Applies to
16+
1617
| File share type | SMB | NFS |
1718
|-|:-:|:-:|
1819
| Standard file shares (GPv2), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
@@ -82,8 +83,8 @@ How to use the table:
8283

8384
1. Choose one of these targets:
8485

85-
- A hybrid deployment using Azure File Sync to cache the content of Azure file shares on-premises
86-
- Azure file shares in the cloud
86+
- **Hybrid deployment:** Use Azure File Sync to cache the content of Azure file shares on-premises and tier less frequently used files to the cloud.
87+
- **Cloud-only deployment:** Azure file shares in the cloud, with no on-premises caching.
8788

8889
Select the target column that matches your choice.
8990

@@ -94,10 +95,10 @@ A scenario without a link doesn't yet have a published migration guide. Check th
9495
| Source | Target: </br>Hybrid deployment </br>(Azure Files + Azure File Sync) | Target: </br>Cloud-only deployment </br>(Azure Files)|
9596
|:---|:--|:--|
9697
| | Recommended tool combination:| Recommended tool combination: |
97-
| Windows Server 2012 R2 and later | <ul><li>[Azure File Sync](../file-sync/file-sync-deployment-guide.md)</li><li>[Azure File Sync and Azure DataBox](storage-files-migration-server-hybrid-databox.md)</li></ul> | <ul><li>Via Azure Storage Mover</li><li>[Via RoboCopy to a mounted Azure file share](storage-files-migration-robocopy.md)</li><li>Via Azure File Sync: Follow same steps as [Azure File Sync hybrid deployment](../file-sync/file-sync-deployment-guide.md) and [decommission server endpoint](../file-sync/file-sync-server-endpoint-delete.md) at the end.</li></ul> |
98-
| Windows Server 2012 and earlier | <ul><li>Via DataBox and Azure File Sync to recent server OS</li><li>Via Storage Migration Service to recent server with Azure File Sync, then upload</li></ul> | <ul><li>Via Azure Storage Mover</li><li>Via Storage Migration Service to recent server with Azure File Sync</li><li>[Via RoboCopy to a mounted Azure file share](storage-files-migration-robocopy.md)</li></ul> |
99-
| Network-attached storage (NAS) | <ul><li>Via Storage Mover upload + Azure File Sync</li><li>[Via Azure File Sync upload](storage-files-migration-nas-hybrid.md)</li><li>[Via DataBox + Azure File Sync](storage-files-migration-nas-hybrid-databox.md)</li></ul> | <ul><li>Via Azure Storage Mover</li><li>[Via DataBox](storage-files-migration-nas-cloud-databox.md)</li><li>[Via RoboCopy to a mounted Azure file share](storage-files-migration-robocopy.md)</li></ul> |
100-
| Linux (SMB only) | <ul><li>[Azure File Sync and RoboCopy](storage-files-migration-linux-hybrid.md)</li></ul> | <ul><li>Via Azure Storage Mover</li><li>[Via RoboCopy to a mounted Azure file share](storage-files-migration-robocopy.md)</li></ul> |
98+
| Windows Server 2012 R2 and later | <ul><li>[Azure File Sync](../file-sync/file-sync-deployment-guide.md)</li><li>[Azure File Sync and Azure DataBox](storage-files-migration-server-hybrid-databox.md)</li></ul> | <ul><li>Via [Azure Storage Mover](migrate-files-storage-mover.md)</li><li>[Via RoboCopy to a mounted Azure file share](storage-files-migration-robocopy.md)</li><li>Via Azure File Sync: Follow same steps as [Azure File Sync hybrid deployment](../file-sync/file-sync-deployment-guide.md) and [decommission server endpoint](../file-sync/file-sync-server-endpoint-delete.md) at the end.</li></ul> |
99+
| Windows Server 2012 and earlier | <ul><li>Via DataBox and Azure File Sync to recent server OS</li><li>Via Storage Migration Service to recent server with Azure File Sync, then upload</li></ul> | <ul><li>Via [Azure Storage Mover](migrate-files-storage-mover.md)</li><li>Via Storage Migration Service to recent server with Azure File Sync</li><li>[Via RoboCopy to a mounted Azure file share](storage-files-migration-robocopy.md)</li></ul> |
100+
| Network-attached storage (NAS) | <ul><li>Via Storage Mover upload + Azure File Sync</li><li>[Via Azure File Sync upload](storage-files-migration-nas-hybrid.md)</li><li>[Via DataBox + Azure File Sync](storage-files-migration-nas-hybrid-databox.md)</li></ul> | <ul><li>Via [Azure Storage Mover](migrate-files-storage-mover.md)</li><li>[Via DataBox](storage-files-migration-nas-cloud-databox.md)</li><li>[Via RoboCopy to a mounted Azure file share](storage-files-migration-robocopy.md)</li></ul> |
101+
| Linux (SMB only) | <ul><li>[Azure File Sync and RoboCopy](storage-files-migration-linux-hybrid.md)</li></ul> | <ul><li>Via [Azure Storage Mover](migrate-files-storage-mover.md)</li><li>[Via RoboCopy to a mounted Azure file share](storage-files-migration-robocopy.md)</li></ul> |
101102

102103
## Migration toolbox
103104

@@ -146,7 +147,7 @@ This section describes tools that help you plan and run migrations.
146147

147148
#### Azure Storage Mover
148149

149-
Azure Storage Mover is a relatively new, fully managed migration service that enables you to migrate files and folders to SMB Azure file shares with the same level of file fidelity as the underlying Azure file share. Folder structure and metadata values such as file and folder timestamps, ACLs, and file attributes are maintained.
150+
Azure Storage Mover is a relatively new, fully managed migration service that enables you to migrate files and folders to SMB Azure file shares with the same level of file fidelity as the underlying Azure file share. Folder structure and metadata values such as file and folder timestamps, ACLs, and file attributes are maintained. To learn how to use Azure Storage Mover with Azure Files, see [Migrate to SMB Azure file shares using Azure Storage Mover](migrate-files-storage-mover.md).
150151

151152
#### RoboCopy
152153

0 commit comments

Comments
 (0)