You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/private-5g-core/region-move-private-mobile-network-resources.md
+20-39Lines changed: 20 additions & 39 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,36 +1,29 @@
1
1
---
2
-
title: Move your resources to a different region
2
+
title: Move Azure Private 5G Core private mobile network resources between regions
3
3
titleSuffix: Azure Private 5G Core Preview
4
-
description: In this how-to guide, you'll learn how to move your Azure Private 5G Core resources to a different region.
4
+
description: In this how-to guide, you'll learn how to move your private mobile network resources to a different region.
5
5
author: b-branco
6
6
ms.author: biancabranco
7
7
ms.service: private-5g-core
8
8
ms.topic: how-to
9
9
ms.date: 01/04/2023
10
-
ms.custom: template-how-to
10
+
ms.custom: subject-moving-resources
11
11
---
12
12
13
-
# Move your Azure Private 5G Core resources to a different region
13
+
# Move your private mobile network resources to a different region
14
14
15
-
In this how-to guide, you'll learn how to move your Azure Private 5G Core resources to a different region. This involves exporting your resources from the source region's resource group and recreating them in a new resource group deployed in the target region.
15
+
In this how-to guide, you'll learn how to move your private mobile network resources to a different region. This involves exporting your resources from the source region's resource group and recreating them in a new resource group deployed in the target region.
16
16
17
-
If you also want to move your Arc-enabled Kubernetes cluster, contact your support representative.
17
+
You might move your resources to another region for a number of reasons. For example, to take advantage of a new Azure region, to create a backup of your deployment, to meet internal policy and governance requirements, or in response to capacity planning requirements.
18
+
19
+
If you also want to move your Arc-enabled Kubernetes cluster, contact your support representative.
18
20
19
21
## Prerequisites
20
22
21
23
- Ensure you can sign in to the Azure portal using an account with access to the active subscription you used to create your private mobile network. This account must have the built-in Contributor or Owner role at the subscription scope.
22
24
- Refer to [Products available by region](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/) to ensure Azure Private 5G Core supports the region to which you want to move your resources.
23
25
- Verify pricing and charges associated with the target region to which you want to move your resources.
24
26
- Choose a name for your new resource group in the target region. This must be different to the source region's resource group name.
25
-
- If you want to move your Arc-enabled Kubernetes cluster, ensure you have access to [Azure CLI](/cli/azure/get-started-with-azure-cli).
26
-
27
-
## Plan a maintenance window
28
-
29
-
Depending on the resources you want to move and whether you want the deployment in the source region to remain operational during and after the region move, you may need to plan for a service outage.
30
-
31
-
If you're moving your Arc-enabled Kubernetes cluster, we recommend performing the move during a maintenance window to minimize the impact on your service. You should allow up to two hours for the process to complete. <!-- TODO: check outage time advice -->
32
-
33
-
If you're not moving your Arc-enabled Kubernetes cluster and you want the deployment in the source region to remain operational during the region move, you'll have the option to move your resources without causing an outage in the original deployment. This will involve making additional changes to your deployment's template to delete all SIMs and custom location entries.
34
27
35
28
## Back up deployment information
36
29
@@ -44,22 +37,14 @@ The following list contains the data that will be lost over the region move. Bac
44
37
45
38
## Prepare to move your resources
46
39
47
-
### Optionally, delete the custom location
48
-
49
-
Only follow this step if you want to move your Arc-enabled Kubernetes cluster. Deleting the custom location will initiate an outage in the source region.
50
-
51
-
1. Log in to Azure CLI.
52
-
1. Delete the custom location you want to move:
53
-
54
-
```azurecli
55
-
az customlocation delete -n <custom location name> -g <resource group name>
56
-
```
57
-
58
40
### Remove SIMs and custom location
59
41
60
-
If you want to avoid an outage in the source region's deployment during the region move, skip this step. You'll need to make additional modifications to the export template in [Prepare template](#prepare-template).
42
+
> [!IMPORTANT]
43
+
> Completing this step will initiate an outage in the source region.
44
+
>
45
+
> If you want your source deployment to stay operational during the region move, skip this step and move to [Generate template](#generate-template). You'll need to make additional modifications to the template in [Prepare template](#prepare-template).
61
46
62
-
Before moving your resources, you'll need to delete all SIMs in your deployment. If you didn't delete the custom location in the previous step, you'll also need to uninstall all packet core instances you want to move by changing their **Custom ARC location** field to **None**.
47
+
Before moving your resources, you'll need to delete all SIMs in your deployment. You'll also need to uninstall all packet core instances you want to move by changing their **Custom ARC location** field to **None**.
63
48
64
49
1. Follow [Delete SIMs](manage-existing-sims.md#delete-sims) to delete all the SIMs in your deployment.
65
50
1. For each site that you want to move, follow [Modify the packet core instance in a site](modify-packet-core.md) to modify your packet core instance with the changes below. You can ignore the sections about attaching and modifying data networks.
@@ -83,19 +68,12 @@ Your mobile network resources can now be exported via an Azure Resource Manager
83
68
84
69
## Move resources to a new region
85
70
86
-
### Optionally, move the Arc-enabled Kubernetes cluster
87
-
88
-
You can skip this step if you don't want to move your Arc-enabled Kubernetes cluster
89
-
90
-
1. Move the Arc-enabled Kubernetes cluster by following the steps in [Move Arc-enabled Kubernetes clusters across Azure regions](/azure/azure-arc/kubernetes/move-regions).
91
-
1. Follow the steps in TODO <!-- TODO: link to MOP once ASE setup docs are ready --> to recreate the Arc-enabled Kubernetes cluster.
92
-
93
71
### Prepare template
94
72
95
73
You'll need to customize your template to ensure all your resources are correctly deployed to the new region.
96
74
97
75
1. Open the *template.json* file you downloaded in [Generate template](#generate-template).
98
-
1. Find every instance of the original region's code name and replace it with the target region you're moving your deployment to. This involves updating the **location** parameter for every resource. See TODO:link for instructions on how to obtain the target region's code name.
76
+
1. Find every instance of the original region's code name and replace it with the target region you're moving your deployment to. This involves updating the **location** parameter for every resource. See [Region code names](region-code-names.md) for instructions on how to obtain the target region's code name.
99
77
1. Find every instance of the original region's resource group name and replace it with the target region's resource group name you defined in [Prerequisites](#prerequisites).
100
78
1. If you skipped [Remove SIMs and custom location](#remove-sims-and-custom-location) because you need your deployment to stay online in the original region, make the additional changes to the template:
101
79
1. Remove all the SIM resources.
@@ -118,7 +96,7 @@ You'll need to customize your template to ensure all your resources are correctl
118
96
119
97
## Configure custom location
120
98
121
-
You can now install your packet core instances in the new region. If you moved your Arc-enabled Kubernetes cluster, you'll also need to reinstall the packet core instances that use it in the original region.
99
+
You can now install your packet core instances in the new region.
122
100
123
101
For each site in your deployment, follow [Modify the packet core instance in a site](modify-packet-core.md) to reconfigure your packet core custom location. In *Modify the packet core configuration*, set the **Custom ARC location** field to the custom location value you noted down in [Remove SIMs and custom location](#remove-sims-and-custom-location). You can ignore the sections about attaching and modifying data networks.
124
102
@@ -136,8 +114,11 @@ Configure your deployment in the new region using the information you gathered i
136
114
1. If you backed up any packet core dashboards, follow [Importing a dashboard](https://grafana.com/docs/grafana/v6.1/reference/export_import/#importing-a-dashboard) in the Grafana documentation to restore them.
137
115
1. If you have UEs that require manual operations to recover from a packet core outage, follow their recovery steps.
138
116
117
+
## Verify
118
+
119
+
Use [Azure Monitor](monitor-private-5g-core-with-log-analytics.md) or the [packet core dashboards](packet-core-dashboards.md) to confirm your deployment is operating normally after the region move.
120
+
139
121
## Next steps
140
122
141
-
- Use [Azure Monitor](monitor-private-5g-core-with-log-analytics.md) or the [packet core dashboards](packet-core-dashboards.md) to confirm your deployment is operating normally after the region move.
142
-
- If you no longer require a deployment in the source region, [delete the original resource group](/azure/azure-resource-manager/management/manage-resource-groups-portal).
123
+
If you no longer require a deployment in the source region, [delete the original resource group](/azure/azure-resource-manager/management/manage-resource-groups-portal).
143
124
<!-- TODO: Learn more about reliability in Azure Private 5G Core. -->
0 commit comments