Skip to content

Commit 634ab45

Browse files
authored
Update file-sync-modify-sync-topology.md
1 parent 438af0d commit 634ab45

File tree

1 file changed

+18
-17
lines changed

1 file changed

+18
-17
lines changed
Lines changed: 18 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,61 @@
11
---
22
title: Modify your Azure File Sync topology
3-
description: Guidance on how to modify your Azure File Sync sync topology
3+
description: Guidance on how to modify your Azure File Sync topology and avoid errors or data loss
44
author: khdownie
55
ms.service: azure-file-storage
6-
ms.topic: conceptual
7-
ms.date: 4/23/2021
6+
ms.topic: how-to
7+
ms.date: 06/05/2024
88
ms.author: kendownie
99
---
1010

11-
# Modify your Azure File Sync topology
11+
# How to modify your Azure File Sync topology
1212

13-
This article covers the most common ways customers would like to modify their Azure File Sync topology and our recommendations for how to do so. If you would like to modify your Azure File Sync topology, refer to the best practices below to avoid errors and/or potential data loss.
13+
This article covers the most common ways customers want to modify their Azure File Sync topology and recommendations for how to do so. If you'd like to modify your Azure File Sync topology, refer to the best practices in this article to avoid errors and/or potential data loss.
1414

15-
## Migrate a server endpoint to a different Azure File Sync Storage Sync Service
15+
## Migrate a server endpoint to a different Storage Sync Service
1616

17-
Once you ensure that your data is up to date on your local server, deprovision your server endpoint. For detailed guidance, see [Deprovision your Azure File Sync server endpoint](./file-sync-server-endpoint-delete.md#scenario-2-you-intend-to-delete-your-server-endpoint-and-stop-using-this-specific-azure-file-share). Then reprovision in the desired sync group and Storage Sync Service.
17+
After you ensure that your data is up to date on your local server, deprovision your server endpoint. For detailed guidance, see [Deprovision your Azure File Sync server endpoint](./file-sync-server-endpoint-delete.md#scenario-2-you-intend-to-delete-your-server-endpoint-and-stop-using-this-specific-azure-file-share). Then reprovision in the desired sync group and Storage Sync Service.
1818

19-
If you would like to migrate all server endpoints associated with a server to a different sync group or Storage Sync Service, see [Deprovision all server endpoints associated with a registered server](#deprovision-all-server-endpoints-associated-with-a-registered-server).
19+
If you want to migrate all server endpoints associated with a server to a different sync group or Storage Sync Service, see [Deprovision all server endpoints associated with a registered server](#deprovision-all-server-endpoints-associated-with-a-registered-server).
2020

2121
## Change the granularity of a server endpoint
2222

2323
After you confirm your data is up to date on your local server (see [Deprovision your Azure File Sync server endpoint](./file-sync-server-endpoint-delete.md#scenario-2-you-intend-to-delete-your-server-endpoint-and-stop-using-this-specific-azure-file-share)), deprovision your server endpoint. Then reprovision at the desired granularity.
2424

2525
## Deprovision Azure File Sync topology
2626

27-
Azure File Sync resources must be deprovisioned in a specific order: server endpoints, sync group, and then Storage Service. While the entire flow is documented below, you may stop at any level you desire.
27+
Azure File Sync resources must be deprovisioned in a specific order: server endpoints, sync group, and then Storage Sync Service. While the entire flow is documented below, you may stop at any level you desire.
2828

2929
First, navigate to the Storage Sync Service resource in the Azure portal and select a sync group in the Storage Sync Service. Follow the steps in [Deprovision your Azure File Sync server endpoint](./file-sync-server-endpoint-delete.md) to ensure data integrity and availability when deleting server endpoints. In order to deprovision your sync group or Storage Sync Service, all server endpoints must be deleted. If you only aim to delete specific server endpoints, you can stop here.
3030

31-
Once you delete all the server endpoints in the sync group, delete the cloud endpoint.
31+
After you delete all the server endpoints in the sync group, delete the cloud endpoint.
3232

3333
Then, delete the sync group.
3434

35-
Repeat these steps for all the sync groups in the Storage Sync Service you would like to delete. Once all the sync groups in that Storage Sync Service have been deleted, delete the Storage Sync Service resource.
35+
Repeat these steps for all the sync groups in the Storage Sync Service that you want to delete. After you've deleted all the sync groups in that Storage Sync Service, delete the Storage Sync Service resource.
3636

3737
## Change a server endpoint path
3838

3939
A server endpoint path is an immutable property. Choosing a different location on the server has consequences for the data in the old location, the Azure file share, and the new location. Most of these behaviors are undefined if you were to simply change the path. You can only remove a server endpoint and then create a new server endpoint with the new path. Carefully consider the sync state of your server to find the right time to perform this large change.
4040

41-
Deleting a server endpoint is not trivial and can lead to data loss if done in the wrong way. The [delete server endpoint article](file-sync-server-endpoint-delete.md) guides you through the process.
41+
Deleting a server endpoint isn't trivial and can lead to data loss if done in the wrong way. The [delete server endpoint article](file-sync-server-endpoint-delete.md) guides you through the process.
4242

43-
If you are currently using the D drive and are planning on migrating to the cloud, see [Make the D: drive of a VM a data disk - Azure Virtual Machines](../../virtual-machines/windows/change-drive-letter.md).
43+
If you're currently using the D drive and plan on migrating to the cloud, see [Make the D: drive of a VM a data disk - Azure Virtual Machines](../../virtual-machines/windows/change-drive-letter.md).
4444

4545
## Rename a sync group
4646

47-
A sync group cannot be renamed. Its name is part of the URL with which the child resources cloud endpoint and server endpoints are stored and managed. Choose the name carefully when you create the resource.
47+
You can't rename a sync group. Its name is part of the URL with which the child resources cloud endpoint and server endpoints are stored and managed. Choose the name carefully when you create the resource.
4848

4949
## Deprovision all server endpoints associated with a registered server
5050

5151
To ensure that your data is safe and fully updated before deprovisioning, see [Deprovision your Azure File Sync server endpoint](./file-sync-server-endpoint-delete.md).
5252

53-
Removing all server endpoints in bulk should not be done, unless this is a test deployment with disposable data on the server and in the cloud. Unregistering the server from the Azure File Sync *Storage Sync Service* causes a bulk removal of all server endpoints. Data loss is a likely consequence of using this method.
53+
Removing all server endpoints in bulk shouldn't be done except in the case of a test deployment with disposable data on the server and in the cloud. Unregistering the server from the Azure File Sync *Storage Sync Service* causes a bulk removal of all server endpoints. If you use this method, you'll likely lose data.
5454

55-
To unregister a server regardless of the negative implications, navigate to your Storage Sync Service resource, and go to the **Registered servers** tab. Select the server you would like to unregister and select **Unregister server**. All server endpoints associated with that server will be removed.
55+
To unregister a server regardless of the negative implications, navigate to your Storage Sync Service resource and go to the **Registered servers** tab. Select the server you'd like to unregister and select **Unregister server**. All server endpoints associated with that server will be removed.
56+
57+
## Next step
5658

57-
## Next steps
5859
* [Deprovision your Azure File Sync server endpoint](./file-sync-server-endpoint-delete.md)
5960

6061

0 commit comments

Comments
 (0)