Skip to content

Commit 4c21ce3

Browse files
authored
Merge pull request #110539 from ShawnJackson/storage-files-migration-linux-hybrid
edit pass: storage-files-migration-linux-hybrid
2 parents 289e4ee + 63f7b56 commit 4c21ce3

6 files changed

+125
-137
lines changed

articles/storage/files/storage-files-migration-linux-hybrid.md

Lines changed: 60 additions & 69 deletions
Large diffs are not rendered by default.
Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Configuring Azure File Sync
3-
description: Configure Azure File Sync. A common text block, shared between migration docs.
3+
description: Configure Azure File Sync. A common text block, shared across migration docs.
44
author: fauhse
55
ms.service: storage
66
ms.topic: conceptual
@@ -9,10 +9,10 @@ ms.author: fauhse
99
ms.subservice: files
1010
---
1111

12-
This step ties together all resources and folders you've set up on your Windows Server during the previous steps.
12+
This step ties together all resources and folders you've set up on your Windows Server instance during the previous steps.
1313

14-
* Sign into the [Azure portal](https://portal.azure.com).
15-
* Locate your Storage Sync Service resource.
16-
* Create a new *sync group* within the Storage Sync Service resource for each Azure file share. In Azure File Sync terminology, the Azure file share will become a *cloud endpoint* in the sync topology you are describing with the creation of a sync group. As you are creating the sync group, give it a familiar name, such that you recognize which set of files syncs here. Make sure you reference the Azure file share with a matching name.
17-
* Once the sync group is created, you will see a row for it appear in the list of sync groups. Click on the name (a link) to display the contents of the sync group. You will see your Azure file share under "Cloud endpoints".
18-
* Locate the command button to *+ Add Server Endpoint*. The folder on the local server you've provisioned, will become the path for this *server endpoint*.
14+
1. Sign in to the [Azure portal](https://portal.azure.com).
15+
1. Locate your Storage Sync Service resource.
16+
1. Create a new *sync group* within the Storage Sync Service resource for each Azure file share. In Azure File Sync terminology, the Azure file share will become a *cloud endpoint* in the sync topology that you're describing with the creation of a sync group. As you're creating the sync group, give it a familiar name so that you recognize which set of files syncs here. Make sure you reference the Azure file share with a matching name.
17+
1. After the sync group is created, a row for it will appear in the list of sync groups. Select the name (a link) to display the contents of the sync group. You'll see your Azure file share under **Cloud endpoints**.
18+
1. Locate the **+ Add Server Endpoint** button. The folder on the local server that you've provisioned will become the path for this *server endpoint*.
Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Deploying the Azure File Sync agent
3-
description: Deploying the Azure File Sync agent. A common text block, shared between migration docs.
2+
title: Deploy the Azure File Sync agent
3+
description: Deploying the Azure File Sync agent. A common text block, shared across migration docs.
44
author: fauhse
55
ms.service: storage
66
ms.topic: conceptual
@@ -9,30 +9,29 @@ ms.author: fauhse
99
ms.subservice: files
1010
---
1111

12-
In this section, you install the Azure File Sync agent on your Windows Server.
13-
The [deployment guide](../articles/storage/files/storage-sync-files-deployment-guide.md) illustrates that you need to turn off **IE enhanced security**. IE enhanced security is a security measure that is not applicable with Azure File Sync and turning it off allows you to authenticate to Azure without any issues.
12+
In this section, you install the Azure File Sync agent on your Windows Server instance.
1413

15-
Open PowerShell and install the required PowerShell modules with the following commands. Make sure to install the full module and the NuGet provider when prompted:
14+
The [deployment guide](../articles/storage/files/storage-sync-files-deployment-guide.md) illustrates that you need to turn off **Internet Explorer Enhanced Security Configuration**. This security measure is not applicable with Azure File Sync. Turning it off allows you to authenticate to Azure without any issues.
15+
16+
Open PowerShell and install the required PowerShell modules by using the following commands. Make sure to install the full module and the NuGet provider when you're prompted.
1617

1718
```powershell
1819
Install-Module -Name Az -AllowClobber
1920
Install-Module -Name Az.StorageSync
2021
```
2122

22-
If you have any issues reaching the internet from your server, now is the time to solve them. Azure File Sync uses any available network connection to the internet.
23-
Requiring a proxy server to reach the internet is also supported. You can either configure a machine-wide proxy now, or specify a proxy that just file sync will use, during agent installation.
23+
If you have any issues reaching the internet from your server, now is the time to solve them. Azure File Sync uses any available network connection to the internet. Requiring a proxy server to reach the internet is also supported. You can either configure a machine-wide proxy now, or specify a proxy that just Azure File Sync will use, during agent installation.
2424

25-
If that means you need to open up your firewalls for this server, then that might be an acceptable approach to you. At the end of the server installation, after completed server registration, there will be a network connectivity report showing you the exact endpoint URLs in Azure, that file sync needs to communicate with for the region you've selected. The report also tells you the reason why communication is needed. You can use the report to then lock down the firewalls around this server, to specific URLs.
25+
If configuring a proxy means you need to open your firewalls for this server, that might be an acceptable approach to you. At the end of the server installation, after you've completed server registration, a network connectivity report will show you the exact endpoint URLs in Azure that Azure File Sync needs to communicate with for the region you've selected. The report also tells you the reason why communication is needed. You can use the report to lock down the firewalls around this server to specific URLs.
2626

27-
You can also follow a more conservative approach, in which you don't open the firewalls wide, but instead limit the server to communicate to higher-level DNS name spaces - there is more documentation and details available in the [Azure File Sync proxy and firewall settings](../articles/storage/files/storage-sync-files-firewall-and-proxy.md) article. Follow your own networking best practices.
27+
You can also follow a more conservative approach in which you don't open the firewalls wide, but instead limit the server to communicate with higher-level DNS namespaces. For more information, see [Azure File Sync proxy and firewall settings](../articles/storage/files/storage-sync-files-firewall-and-proxy.md). Follow your own networking best practices.
2828

29-
At the end of the server *installation* wizard, a server *registration* wizard will pop up.
30-
Register the server to your Storage Sync Service Azure resource from earlier.
29+
At the end of the server *installation* wizard, a server *registration* wizard will open. Register the server to your Storage Sync Service's Azure resource from earlier.
3130

32-
These steps are described in more detail in the deployment guide, including the above PowerShell modules you should install first:
33-
[Azure File Sync agent install](../articles/storage/files/storage-sync-files-deployment-guide.md).
31+
These steps are described in more detail in the deployment guide, including the PowerShell modules that you should install first:
32+
[Azure File Sync agent installation](../articles/storage/files/storage-sync-files-deployment-guide.md).
3433

35-
The latest agent should be used and can be downloaded from Microsoft Download Center:
36-
[Azure File Sync - agent](https://aka.ms/AFS/agent "Azure File Sync agent download").
34+
Use the latest agent. You can download it from the Microsoft Download Center:
35+
[Azure File Sync Agent](https://aka.ms/AFS/agent "Azure File Sync Agent download").
3736

38-
After a successful installation and server registration, you can check that you have successfully completed this step: Navigate to the Storage Sync Service resource in the Azure portal, then follow the left-hand menu to Registered servers. You will see your server listed there right away.
37+
After a successful installation and server registration, you can check that you have successfully completed this step. Go to the Storage Sync Service resource in the Azure portal, and then follow the left menu to **Registered servers**. You'll see your server listed there.
Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Deploy a Storage Sync Service
3-
description: Deploying the Azure File Sync cloud resource. A Storage Sync Service. A common text block, shared between migration docs.
3+
description: Deploying the Azure File Sync cloud resource, a Storage Sync Service. A common text block, shared across migration docs.
44
author: fauhse
55
ms.service: storage
66
ms.topic: conceptual
@@ -11,12 +11,9 @@ ms.subservice: files
1111

1212
In this step, you need your Azure subscription credentials.
1313

14-
The core resource to configure Azure File Sync is called a "Storage Sync Service".
15-
We recommend you deploy only one for all servers in the company that syncing the same set of files now or in the future. Only create multiple Storage Sync Services if you have distinct sets of servers that must never exchange data. (for example: sync the same Azure file share). Otherwise a single Storage Sync Service is the best practice.
14+
The core resource to configure for Azure File Sync is called a *Storage Sync Service*. We recommend that you deploy only one for all servers that are syncing the same set of files now or in the future. Create multiple Storage Sync Services only if you have distinct sets of servers that must never exchange data (for example: sync the same Azure file share). Otherwise, a single Storage Sync Service is the best practice.
1615

17-
Choose an Azure region for your Storage Sync Service that is close to your office location. All other cloud resources must be deployed in the same region.
16+
Choose an Azure region for your Storage Sync Service that's close to your location. All other cloud resources must be deployed in the same region.
1817
To simplify management, create a new resource group in your subscription that houses sync and storage resources.
1918

20-
The following article describes how to deploy a Storage Sync Service. Only follow this part of the doc. There will be links to other subsections of this doc in later steps.
21-
22-
[Learn how to deploy a Storage Sync Service.](../articles/storage/files/storage-sync-files-deployment-guide.md#deploy-the-storage-sync-service)
19+
For more information, see the [section about deploying the Storage Sync Service](../articles/storage/files/storage-sync-files-deployment-guide.md#deploy-the-storage-sync-service) in the article about deploying Azure File Sync. Follow only this part of the article. There will be links to other sections of the article in later steps.

0 commit comments

Comments
 (0)