Skip to content

Commit b501c62

Browse files
authored
Merge pull request #200396 from jeffpatt24/patch-1
Update file-sync-deployment-guide.md
2 parents 97d1971 + 998e9ea commit b501c62

File tree

3 files changed

+20
-7
lines changed

3 files changed

+20
-7
lines changed

articles/storage/file-sync/file-sync-deployment-guide.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to deploy Azure File Sync, from start to finish, using th
44
author: khdownie
55
ms.service: storage
66
ms.topic: how-to
7-
ms.date: 05/27/2022
7+
ms.date: 06/03/2022
88
ms.author: kendownie
99
ms.subservice: files
1010
ms.custom: devx-track-azurepowershell, devx-track-azurecli
@@ -24,7 +24,9 @@ We strongly recommend that you read [Planning for an Azure Files deployment](../
2424
1. An **Azure file share** in the same region that you want to deploy Azure File Sync. For more information, see:
2525
- [Region availability](file-sync-planning.md#azure-file-sync-region-availability) for Azure File Sync.
2626
- [Create a file share](../files/storage-how-to-create-file-share.md?toc=%2fazure%2fstorage%2ffilesync%2ftoc.json) for a step-by-step description of how to create a file share.
27-
2. **SMB security settings** on the storage account must allow **SMB 3.1.1** protocol version, **NTLM v2** authentication and **AES-128-GCM** encryption. To check the SMB security settings on the storage account, see [SMB security settings](../files/files-smb-protocol.md#smb-security-settings).
27+
2. The following **storage account** settings must be enabled to allow Azure File Sync access to the storage account:
28+
- **SMB security settings** must allow **SMB 3.1.1** protocol version, **NTLM v2** authentication and **AES-128-GCM** encryption. To check the SMB security settings on the storage account, see [SMB security settings](../files/files-smb-protocol.md#smb-security-settings).
29+
- **Allow storage account key access** must be **Enabled**. To check this setting, navigate to your storage account and select Configuration under the Settings section.
2830
3. At least one supported instance of **Windows Server** to sync with Azure File Sync. For more information about supported versions of Windows Server and recommended system resources, see [Windows file server considerations](file-sync-planning.md#windows-file-server-considerations).
2931
4. **Optional**: If you intend to use Azure File Sync with a Windows Server Failover Cluster, the **File Server for general use** role must be configured prior to installing the Azure File Sync agent on each node in the cluster. For more information on how to configure the **File Server for general use** role on a Failover Cluster, see [Deploying a two-node clustered file server](/windows-server/failover-clustering/deploy-two-node-clustered-file-server).
3032

@@ -36,7 +38,9 @@ We strongly recommend that you read [Planning for an Azure Files deployment](../
3638
1. An **Azure file share** in the same region that you want to deploy Azure File Sync. For more information, see:
3739
- [Region availability](file-sync-planning.md#azure-file-sync-region-availability) for Azure File Sync.
3840
- [Create a file share](../files/storage-how-to-create-file-share.md?toc=%2fazure%2fstorage%2ffilesync%2ftoc.json) for a step-by-step description of how to create a file share.
39-
2. **SMB security settings** on the storage account must allow **SMB 3.1.1** protocol version, **NTLM v2** authentication and **AES-128-GCM** encryption. To check the SMB security settings on the storage account, see [SMB security settings](../files/files-smb-protocol.md#smb-security-settings).
41+
2. The following **storage account** settings must be enabled to allow Azure File Sync access to the storage account:
42+
- **SMB security settings** must allow **SMB 3.1.1** protocol version, **NTLM v2** authentication and **AES-128-GCM** encryption. To check the SMB security settings on the storage account, see [SMB security settings](../files/files-smb-protocol.md#smb-security-settings).
43+
- **Allow storage account key access** must be **Enabled**. To check this setting, navigate to your storage account and select Configuration under the Settings section.
4044
3. At least one supported instance of **Windows Server** to sync with Azure File Sync. For more information about supported versions of Windows Server and recommended system resources, see [Windows file server considerations](file-sync-planning.md#windows-file-server-considerations).
4145

4246
4. **Optional**: If you intend to use Azure File Sync with a Windows Server Failover Cluster, the **File Server for general use** role must be configured prior to installing the Azure File Sync agent on each node in the cluster. For more information on how to configure the **File Server for general use** role on a Failover Cluster, see [Deploying a two-node clustered file server](/windows-server/failover-clustering/deploy-two-node-clustered-file-server).
@@ -75,7 +79,9 @@ We strongly recommend that you read [Planning for an Azure Files deployment](../
7579
1. An **Azure file share** in the same region that you want to deploy Azure File Sync. For more information, see:
7680
- [Region availability](file-sync-planning.md#azure-file-sync-region-availability) for Azure File Sync.
7781
- [Create a file share](../files/storage-how-to-create-file-share.md?toc=%2fazure%2fstorage%2ffilesync%2ftoc.json) for a step-by-step description of how to create a file share.
78-
2. **SMB security settings** on the storage account must allow **SMB 3.1.1** protocol version, **NTLM v2** authentication and **AES-128-GCM** encryption. To check the SMB security settings on the storage account, see [SMB security settings](../files/files-smb-protocol.md#smb-security-settings).
82+
2. The following **storage account** settings must be enabled to allow Azure File Sync access to the storage account:
83+
- **SMB security settings** must allow **SMB 3.1.1** protocol version, **NTLM v2** authentication and **AES-128-GCM** encryption. To check the SMB security settings on the storage account, see [SMB security settings](../files/files-smb-protocol.md#smb-security-settings).
84+
- **Allow storage account key access** must be **Enabled**. To check this setting, navigate to your storage account and select Configuration under the Settings section.
7985
3. At least one supported instance of **Windows Server** to sync with Azure File Sync. For more information about supported versions of Windows Server and recommended system resources, see [Windows file server considerations](file-sync-planning.md#windows-file-server-considerations).
8086
8187
4. **Optional**: If you intend to use Azure File Sync with a Windows Server Failover Cluster, the **File Server for general use** role must be configured prior to installing the Azure File Sync agent on each node in the cluster. For more information on how to configure the **File Server for general use** role on a Failover Cluster, see [Deploying a two-node clustered file server](/windows-server/failover-clustering/deploy-two-node-clustered-file-server).

articles/storage/file-sync/file-sync-server-endpoint-create.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,14 @@ As part of this section, a choice can be made for how content from the Azure fil
9191
:::column-end:::
9292
:::row-end:::
9393

94-
Once you selected an initial download option, you cannot change it after you confirm to create the server endpoint. How files appear on the server after initial download finishes, depends on your use of the cloud tiering feature and whether or not you opted to [proactively recall changes in the cloud](file-sync-cloud-tiering-overview.md#proactive-recalling). The latter is a feature useful for sync groups with multiple server endpoints in different geographic locations.
94+
Once you select an initial download option, you cannot change it after you confirm to create the server endpoint.
95+
96+
> [!NOTE]
97+
> To improve the file download performance when adding a server endpoint to a sync group, use the [Invoke-StorageSyncFileRecall](file-sync-how-to-manage-tiered-files.md#how-to-recall-a-tiered-file-to-disk) cmdlet.
98+
99+
### File download behavior once initial download completes
100+
101+
How files appear on the server after initial download finishes, depends on your use of the cloud tiering feature and whether or not you opted to [proactively recall changes in the cloud](file-sync-cloud-tiering-overview.md#proactive-recalling). The latter is a feature useful for sync groups with multiple server endpoints in different geographic locations.
95102

96103
* **Cloud tiering is enabled** </br> New and changed files from other server endpoints will appear as tiered files on this server endpoint. These changes will only come down as full files if you opted for [proactive recall](file-sync-cloud-tiering-overview.md#proactive-recalling) of changes in the Azure file share by other server endpoints.
97104
* **Cloud tiering is disabled** </br> New and changed files from other server endpoints will appear as full files on this server endpoint. They will not appear as tiered files first and then recalled. Tiered files with cloud tiering off are a fast disaster recovery feature and appear only during initial provisioning.

includes/storage-files-sync-create-server-endpoint.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,13 @@ The **Add server endpoint** blade opens, enter the following information to crea
2525
- **Date Policy**: Files are tiered to the cloud if they haven't been accessed (that is, read or written to) for the specified number of days. For example, if you noticed that files that have gone more than 15 days without being accessed are typically archival files, you should set your date policy to 15 days.
2626
- **Initial Sync**: The Initial Sync section is available only for the first server endpoint in a sync group (section changes to Initial Download when creating more than one server endpoint in a sync group). Within the Initial Sync section, you can select the **Initial Upload** and **Initial Download** behavior.
2727
- **Intial Upload**: You can select how the server initially uploads the data to the Azure file share:
28-
- Option #1 (Default): Merge the content of this server path with the content in the Azure file share. Files with the same name and path will lead to conflicts if their content is different. Both versions of those files will be stored next to each other. If your server path or Azure file share are empty, always choose this option.
28+
- Option #1: Merge the content of this server path with the content in the Azure file share. Files with the same name and path will lead to conflicts if their content is different. Both versions of those files will be stored next to each other. If your server path or Azure file share are empty, always choose this option.
2929
- Option #2: Authoritatively overwrite files and folders in the Azure file share with content in this server’s path. This option avoids file conflicts.
3030

3131
To learn more, see [Intial sync](../articles/storage/file-sync/file-sync-server-endpoint-create.md#initial-sync-section).
3232

3333
- **Intial Download**: You can select how the server initially downloads the Azure file share data:
34-
- Option #1 (Default): Download the namespace first and then recall the file content, as much as will fit on the local disk.
34+
- Option #1: Download the namespace first and then recall the file content, as much as will fit on the local disk.
3535
- Option #2: Download the namespace only. The file content will be recalled when accessed.
3636
- Option #3: Avoid tiered files. Files will only appear on the server once they are fully downloaded.
3737

0 commit comments

Comments
 (0)