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/upgrade-packet-core-arm-template.md
+17-15Lines changed: 17 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,6 @@ If your environment meets the prerequisites, you're familiar with using ARM temp
27
27
- You must have a running packet core. Use Log Analytics or the packet core dashboards to confirm your packet core instance is operating normally.
28
28
- 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.
29
29
- Identify the name of the site that hosts the packet core instance you want to upgrade.
30
-
- Make a note of your current packet core version. You'll need this information in case you encounter any issues and need to revert the upgrade.
31
30
32
31
## Review the template
33
32
@@ -55,9 +54,9 @@ When planning for your upgrade, make sure you're allowing sufficient time for an
55
54
The following list contains data that will get lost over a packet core upgrade. Back up any information you'd like to preserve; after the upgrade, you can use this information to reconfigure your packet core instance.
56
55
57
56
1. If you want to keep using the same credentials when signing in to [distributed tracing](distributed-tracing.md), save a copy of the current password to a secure location.
58
-
2. If you want to keep using the same credentials when signing in to the [packet core dashboards](packet-core-dashboards.md), save a copy of the current password to a secure location.
59
-
3. Any customizations made to the packet core dashboards won't be carried over the upgrade. Refer to [Exporting a dashboard](https://grafana.com/docs/grafana/v6.1/reference/export_import/#exporting-a-dashboard) in the Grafana documentation to save a backed-up copy of your dashboards.
60
-
4. Most UEs will automatically re-register and recreate any sessions after the upgrade completes. If you have any special devices that require manual operations to recover from a packet core outage, gather a list of these UEs and their recovery steps.
57
+
1. If you want to keep using the same credentials when signing in to the [packet core dashboards](packet-core-dashboards.md), save a copy of the current password to a secure location.
58
+
1. Any customizations made to the packet core dashboards won't be carried over the upgrade. Refer to [Exporting a dashboard](https://grafana.com/docs/grafana/v6.1/reference/export_import/#exporting-a-dashboard) in the Grafana documentation to save a backed-up copy of your dashboards.
59
+
1. Most UEs will automatically re-register and recreate any sessions after the upgrade completes. If you have any special devices that require manual operations to recover from a packet core outage, gather a list of these UEs and their recovery steps.
61
60
62
61
### Upgrade ASE
63
62
@@ -103,45 +102,48 @@ If you determined in [Plan for your upgrade](#plan-for-your-upgrade) that you ne
103
102
Reconfigure your deployment using the information you gathered in [Back up deployment information](#back-up-deployment-information).
104
103
105
104
1. Follow [Access the distributed tracing web GUI](distributed-tracing.md#access-the-distributed-tracing-web-gui) to restore access to distributed tracing.
106
-
2. Follow [Access the packet core dashboards](packet-core-dashboards.md#access-the-packet-core-dashboards) to restore access to your packet core dashboards.
107
-
3. 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.
108
-
4. If you have UEs that require manual operations to recover from a packet core outage, follow their recovery steps.
105
+
1. Follow [Access the packet core dashboards](packet-core-dashboards.md#access-the-packet-core-dashboards) to restore access to your packet core dashboards.
106
+
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.
107
+
1. If you have UEs that require manual operations to recover from a packet core outage, follow their recovery steps.
109
108
110
109
### Verify upgrade
111
110
112
111
Once the upgrade completes, check if your deployment is operating normally.
113
112
114
113
1. Use [Log Analytics](monitor-private-5g-core-with-log-analytics.md) or the [packet core dashboards](packet-core-dashboards.md) to confirm your packet core instance is operating normally.
115
-
2. Execute the testing plan you prepared in [Plan for your upgrade](#plan-for-your-upgrade).
114
+
1. Execute the testing plan you prepared in [Plan for your upgrade](#plan-for-your-upgrade).
116
115
117
116
## Rollback
118
117
119
118
If you encountered issues after the upgrade, you can roll back the packet core instance to the previous version.
120
119
121
120
Note that any configuration you set while your packet core instance was running a newer version will be lost if you roll back to a version that doesn't support this configuration. Check the packet core release notes for information on when new features were introduced.
122
121
122
+
> [!NOTE]
123
+
> You can roll back your packet core instance to version [PMN-4-18-0](azure-private-5g-core-release-notes-2210.md) or later.
124
+
123
125
1. Ensure you have a backup of your deployment information. If you need to back up again, follow [Back up deployment information](#back-up-deployment-information).
124
-
2. Select the following link to sign in to Azure and open the template.
126
+
1. Select the following link to sign in to Azure and open the template.
125
127
126
128
[](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.mobilenetwork%2Fmobilenetwork-update-packet-core-control-plane%2Fazuredeploy.json/createUIDefinitionUri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.mobilenetwork%2Fmobilenetwork-update-packet-core-control-plane%2FcreateUiDefinition.json)
127
129
128
-
3. Select or enter the following values, using the information you retrieved in [Prerequisites](#prerequisites).
130
+
1. Select or enter the following values, using the information you retrieved in [Prerequisites](#prerequisites).
129
131
130
132
-**Subscription:** select the Azure subscription you used to create your private mobile network.
131
133
-**Resource group:** select the resource group containing the mobile network resource representing your private mobile network.
132
134
-**Region:** select **East US**.
133
135
-**Existing packet core:** select the name of the packet core instance you want to upgrade.
134
-
-**New version:** enter the packet core version you want to downgrade to.
136
+
-**New version:** enter the packet core version you want to downgrade to. This value can be version PMN-4-18-0 or later.
135
137
136
138
:::image type="content" source="media/upgrade-packet-core-arm-template/upgrade-arm-template-configuration-fields.png" alt-text="Screenshot of the Azure portal showing the configuration fields for the upgrade ARM template.":::
137
139
138
-
4. Select **Review + create**.
139
-
5. Azure will now validate the configuration values you've entered. You should see a message indicating that your values have passed validation.
140
+
1. Select **Review + create**.
141
+
1. Azure will now validate the configuration values you've entered. You should see a message indicating that your values have passed validation.
140
142
141
143
If the validation fails, you'll see an error message and the **Configuration** tab(s) containing the invalid configuration will be flagged. Select the flagged tab(s) and use the error messages to correct invalid configuration before returning to the **Review + create** tab.
142
144
143
-
6. Once your configuration has been validated, select **Create** to upgrade the packet core instance. The Azure portal will display a confirmation screen when the packet core instance has been downgraded.
144
-
7. Follow the steps in [Verify upgrade](#verify-upgrade) to check if the rollback was successful.
145
+
1. Once your configuration has been validated, select **Create** to upgrade the packet core instance. The Azure portal will display a confirmation screen when the packet core instance has been downgraded.
146
+
1. Follow the steps in [Verify upgrade](#verify-upgrade) to check if the rollback was successful.
Copy file name to clipboardExpand all lines: articles/private-5g-core/upgrade-packet-core-azure-portal.md
+22-20Lines changed: 22 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -60,9 +60,9 @@ When planning for your upgrade, make sure you're allowing sufficient time for an
60
60
The following list contains data that will get lost over a packet core upgrade. Back up any information you'd like to preserve; after the upgrade, you can use this information to reconfigure your packet core instance.
61
61
62
62
1. If you want to keep using the same credentials when signing in to [distributed tracing](distributed-tracing.md), save a copy of the current password to a secure location.
63
-
2. If you want to keep using the same credentials when signing in to the [packet core dashboards](packet-core-dashboards.md), save a copy of the current password to a secure location.
64
-
3. Any customizations made to the packet core dashboards won't be carried over the upgrade. Refer to [Exporting a dashboard](https://grafana.com/docs/grafana/v6.1/reference/export_import/#exporting-a-dashboard) in the Grafana documentation to save a backed-up copy of your dashboards.
65
-
4. Most UEs will automatically re-register and recreate any sessions after the upgrade completes. If you have any special devices that require manual operations to recover from a packet core outage, gather a list of these UEs and their recovery steps.
63
+
1. If you want to keep using the same credentials when signing in to the [packet core dashboards](packet-core-dashboards.md), save a copy of the current password to a secure location.
64
+
1. Any customizations made to the packet core dashboards won't be carried over the upgrade. Refer to [Exporting a dashboard](https://grafana.com/docs/grafana/v6.1/reference/export_import/#exporting-a-dashboard) in the Grafana documentation to save a backed-up copy of your dashboards.
65
+
1. Most UEs will automatically re-register and recreate any sessions after the upgrade completes. If you have any special devices that require manual operations to recover from a packet core outage, gather a list of these UEs and their recovery steps.
66
66
67
67
### Upgrade ASE
68
68
@@ -71,20 +71,19 @@ If you determined in [Plan for your upgrade](#plan-for-your-upgrade) that you ne
71
71
### Upgrade packet core
72
72
73
73
1. Navigate to the **Packet Core Control Plane** resource that you're interested in upgrading as described in [View the current packet core version](#view-the-current-packet-core-version).
74
-
2. Make a note of your current packet core version. You'll need this information in case you encounter any issues and need to revert the upgrade.
75
-
3. Select **Upgrade version**.
74
+
1. Select **Upgrade version**.
76
75
77
76
:::image type="content" source="media/upgrade-packet-core-azure-portal/upgrade-version.png" alt-text="Screenshot of the Azure portal showing the Upgrade version option.":::
78
77
79
-
4. From the **New version** dropdown list, select the packet core version you want to upgrade to.
78
+
1. From the **New version** list, select the packet core version you want to upgrade to.
80
79
81
80
:::image type="content" source="media/upgrade-packet-core-azure-portal/upgrade-packet-core-version.png" alt-text="Screenshot of the Azure portal showing the New version field on the Upgrade packet core version screen. The recommended up-level version is selected.":::
82
81
83
82
> [!NOTE]
84
83
> If a warning appears about an incompatibility between the selected packet core version and the current Azure Stack Edge version, you'll need to upgrade ASE first. Select **Upgrade ASE** from the warning prompt and follow the instructions in [Update your Azure Stack Edge Pro GPU](/azure/databox-online/azure-stack-edge-gpu-install-update). Once you've finished updating your ASE, go back to the beginning of this step to upgrade packet core.
85
84
86
-
5. Select **Modify**.
87
-
6. Azure will now redeploy the packet core instance at the new software version. The Azure portal will display the following confirmation screen when this deployment is complete.
85
+
1. Select **Modify**.
86
+
1. Azure will now redeploy the packet core instance at the new software version. The Azure portal will display the following confirmation screen when this deployment is complete.
88
87
89
88
:::image type="content" source="media/site-deployment-complete.png" alt-text="Screenshot of the Azure portal showing the confirmation of a successful deployment of a packet core instance.":::
90
89
@@ -93,40 +92,43 @@ If you determined in [Plan for your upgrade](#plan-for-your-upgrade) that you ne
93
92
Reconfigure your deployment using the information you gathered in [Back up deployment information](#back-up-deployment-information).
94
93
95
94
1. Follow [Access the distributed tracing web GUI](distributed-tracing.md#access-the-distributed-tracing-web-gui) to restore access to distributed tracing.
96
-
2. Follow [Access the packet core dashboards](packet-core-dashboards.md#access-the-packet-core-dashboards) to restore access to your packet core dashboards.
97
-
3. 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.
98
-
4. If you have UEs that require manual operations to recover from a packet core outage, follow their recovery steps.
95
+
1. Follow [Access the packet core dashboards](packet-core-dashboards.md#access-the-packet-core-dashboards) to restore access to your packet core dashboards.
96
+
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.
97
+
1. If you have UEs that require manual operations to recover from a packet core outage, follow their recovery steps.
99
98
100
99
### Verify upgrade
101
100
102
101
Once the upgrade completes, check if your deployment is operating normally.
103
102
104
103
1. Navigate to the **Packet Core Control Plane** resource as described in [View the current packet core version](#view-the-current-packet-core-version). Check the **Version** field under the **Configuration** heading to confirm that it displays the new software version.
105
-
2. Use [Log Analytics](monitor-private-5g-core-with-log-analytics.md) or the [packet core dashboards](packet-core-dashboards.md) to confirm your packet core instance is operating normally.
106
-
3. Execute the testing plan you prepared in [Plan for your upgrade](#plan-for-your-upgrade).
104
+
1. Use [Log Analytics](monitor-private-5g-core-with-log-analytics.md) or the [packet core dashboards](packet-core-dashboards.md) to confirm your packet core instance is operating normally.
105
+
1. Execute the testing plan you prepared in [Plan for your upgrade](#plan-for-your-upgrade).
107
106
108
107
## Rollback
109
108
110
-
If you encountered issues after the upgrade, you can roll back the packet core instance to the previous version.
109
+
If you encountered issues after the upgrade, you can roll back the packet core instance to a previous version.
111
110
112
111
Note that any configuration you set while your packet core instance was running a newer version will be lost if you roll back to a version that doesn't support this configuration. Check the packet core release notes for information on when new features were introduced.
113
112
113
+
> [!NOTE]
114
+
> You can roll back your packet core instance to version [PMN-4-18-0](azure-private-5g-core-release-notes-2210.md) or later.
115
+
114
116
1. Ensure you have a backup of your deployment information. If you need to back up again, follow [Back up deployment information](#back-up-deployment-information).
115
-
2. Navigate to the **Packet Core Control Plane** resource that you want to roll back as described in [View the current packet core version](#view-the-current-packet-core-version).
116
-
3. Select **Upgrade version**.
117
+
1. Navigate to the **Packet Core Control Plane** resource that you want to roll back as described in [View the current packet core version](#view-the-current-packet-core-version).
118
+
1. Select **Upgrade version**.
117
119
118
120
:::image type="content" source="media/upgrade-packet-core-azure-portal/upgrade-version.png" alt-text="Screenshot of the Azure portal showing the Upgrade version option.":::
119
121
120
-
4. From the **New version**dropdown list, select the packet core version you want to downgrade to. You collected this value in [Upgrade packet core](#upgrade-packet-core).
122
+
1. From the **New version** list, select the packet core version you want to downgrade to.
121
123
122
124
:::image type="content" source="media/upgrade-packet-core-azure-portal/downgrade-packet-core-version.png" alt-text="Screenshot of the Azure portal showing the New version field on the Upgrade packet core version screen. A down-level version is selected.":::
123
125
124
-
5. Select **Modify**.
125
-
6. Azure will now redeploy the packet core instance at the new software version. The Azure portal will display the following confirmation screen when this deployment is complete.
126
+
1. Select **Modify**.
127
+
1. Azure will now redeploy the packet core instance at the new software version. The Azure portal will display the following confirmation screen when this deployment is complete.
126
128
127
129
:::image type="content" source="media/site-deployment-complete.png" alt-text="Screenshot of the Azure portal showing the confirmation of a successful deployment of a packet core instance.":::
128
130
129
-
7. Follow the steps in [Verify upgrade](#verify-upgrade) to check if the rollback was successful.
131
+
1. Follow the steps in [Verify upgrade](#verify-upgrade) to check if the rollback was successful.
0 commit comments