Skip to content

Commit 3290fc6

Browse files
committed
Update rollback and screenshots with new upgrade policing
1 parent 44b95df commit 3290fc6

File tree

5 files changed

+39
-35
lines changed

5 files changed

+39
-35
lines changed
3.74 KB
Loading
124 KB
Loading
9.01 KB
Loading

articles/private-5g-core/upgrade-packet-core-arm-template.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,6 @@ If your environment meets the prerequisites, you're familiar with using ARM temp
2727
- You must have a running packet core. Use Log Analytics or the packet core dashboards to confirm your packet core instance is operating normally.
2828
- 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.
2929
- 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.
3130

3231
## Review the template
3332

@@ -55,9 +54,9 @@ When planning for your upgrade, make sure you're allowing sufficient time for an
5554
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.
5655

5756
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.
6160

6261
### Upgrade ASE
6362

@@ -103,45 +102,48 @@ If you determined in [Plan for your upgrade](#plan-for-your-upgrade) that you ne
103102
Reconfigure your deployment using the information you gathered in [Back up deployment information](#back-up-deployment-information).
104103

105104
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.
109108

110109
### Verify upgrade
111110

112111
Once the upgrade completes, check if your deployment is operating normally.
113112

114113
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).
116115

117116
## Rollback
118117

119118
If you encountered issues after the upgrade, you can roll back the packet core instance to the previous version.
120119

121120
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.
122121

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+
123125
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.
125127

126128
[![Deploy to Azure.](../media/template-deployments/deploy-to-azure.svg)](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)
127129

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).
129131

130132
- **Subscription:** select the Azure subscription you used to create your private mobile network.
131133
- **Resource group:** select the resource group containing the mobile network resource representing your private mobile network.
132134
- **Region:** select **East US**.
133135
- **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.
135137

136138
:::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.":::
137139

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.
140142

141143
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.
142144

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.
145147

146148
## Next steps
147149

articles/private-5g-core/upgrade-packet-core-azure-portal.md

Lines changed: 22 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -60,9 +60,9 @@ When planning for your upgrade, make sure you're allowing sufficient time for an
6060
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.
6161

6262
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.
6666

6767
### Upgrade ASE
6868

@@ -71,20 +71,19 @@ If you determined in [Plan for your upgrade](#plan-for-your-upgrade) that you ne
7171
### Upgrade packet core
7272

7373
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**.
7675

7776
:::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.":::
7877

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.
8079

8180
:::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.":::
8281

8382
> [!NOTE]
8483
> 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.
8584
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.
8887

8988
:::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.":::
9089

@@ -93,40 +92,43 @@ If you determined in [Plan for your upgrade](#plan-for-your-upgrade) that you ne
9392
Reconfigure your deployment using the information you gathered in [Back up deployment information](#back-up-deployment-information).
9493

9594
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.
9998

10099
### Verify upgrade
101100

102101
Once the upgrade completes, check if your deployment is operating normally.
103102

104103
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).
107106

108107
## Rollback
109108

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.
111110

112111
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.
113112

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+
114116
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**.
117119

118120
:::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.":::
119121

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.
121123

122124
:::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.":::
123125

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.
126128

127129
:::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.":::
128130

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.
130132

131133
## Next steps
132134

0 commit comments

Comments
 (0)