Skip to content

Commit 42fc425

Browse files
committed
Add advice on automatic and manual reinstall requirements when modifying packet core
1 parent c960294 commit 42fc425

File tree

4 files changed

+14
-9
lines changed

4 files changed

+14
-9
lines changed
-21.8 KB
Loading
41.5 KB
Loading
41.6 KB
Loading

articles/private-5g-core/modify-packet-core.md

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ If you want to modify a packet core instance's local access configuration, follo
2828
2929
- If you want to make changes to the attached data networks, refer to [Collect data network values](collect-required-information-for-a-site.md#collect-data-network-values) to collect the new values and make sure they're in the correct format.
3030
- 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.
31-
- If you use Azure Active Directory (Azure AD) to authenticate access to your local monitoring tools and you're making a change that triggers a packet core reinstall, ensure your local machine has core kubectl access to the Azure Arc-enabled Kubernetes cluster. This requires a core kubeconfig file, which you can obtain by following [Set up kubectl access](commission-cluster.md#set-up-kubectl-access).
31+
- If you use Azure Active Directory (Azure AD) to authenticate access to your local monitoring tools and you're making a change that requires a packet core reinstall, ensure your local machine has core kubectl access to the Azure Arc-enabled Kubernetes cluster. This requires a core kubeconfig file, which you can obtain by following [Set up kubectl access](commission-cluster.md#set-up-kubectl-access).
3232

3333
## Plan a maintenance window
3434

@@ -38,13 +38,19 @@ The following modifications will trigger a packet core reinstall, during which y
3838
- Detaching a data network from the packet core instance.
3939
- Changing the packet core instance's custom location.
4040

41-
If you're making any of these changes, we recommend modifying your packet core instance during a maintenance window to minimize the impact on your service. The packet core reinstall will take approximately 45 minutes, but this time may vary between systems. You should allow up to two hours for the process to complete.
41+
Additionally, the following changes don't trigger a packet core reinstall, but will require you to manually perform a reinstall to allow the new configuration to take effect:
4242

43-
If you're making a change that doesn't trigger a reinstall, you can skip the next step and move to [Select the packet core instance to modify](#select-the-packet-core-instance-to-modify).
43+
- Connecting a new Azure Stack Edge device.
44+
- Modifying the access network configuration.
45+
- Modifying an attached data network's configuration.
46+
47+
If you're making any of these changes to a healthy packet core instance, we recommend running this process during a maintenance window to minimize the impact on your service. The packet core reinstall will take approximately 45 minutes, but this time may vary between systems. You should allow up to two hours for the process to complete.
48+
49+
If you're making a change that doesn't require a reinstall, you can skip the next step and move to [Select the packet core instance to modify](#select-the-packet-core-instance-to-modify).
4450

4551
## Back up deployment information
4652

47-
The following list contains the data that will be lost over a packet core reinstall. If you're making a change that triggers a reinstall, back up any information you'd like to preserve; after the reinstall, you can use this information to reconfigure your packet core instance.
53+
The following list contains the data that will be lost over a packet core reinstall. If you're making a change that requires a reinstall, back up any information you'd like to preserve; after the reinstall, you can use this information to reconfigure your packet core instance.
4854

4955
1. Depending on your authentication method when signing in to the [distributed tracing](distributed-tracing.md) and [packet core dashboards](packet-core-dashboards.md):
5056
- If you use Azure AD, save a copy of the Kubernetes Secret Object YAML file you created in [Create Kubernetes Secret Objects](enable-azure-active-directory.md#create-kubernetes-secret-objects).
@@ -72,7 +78,8 @@ In this step, you'll navigate to the **Packet Core Control Plane** resource repr
7278

7379
:::image type="content" source="media/modify-packet-core/modify-packet-core-configuration.png" alt-text="Screenshot of the Azure portal showing the Modify packet core option.":::
7480

75-
7. Choose the next step:
81+
7. If you're making a change that requires a packet core reinstall, enable the **Enable changes to configuration that require a reinstall to take effect** toggle.
82+
1. Choose the next step:
7683
- If you want to make changes to the packet core configuration or access network values, go to [Modify the packet core configuration](#modify-the-packet-core-configuration).
7784
- If you want to configure a new or existing data network and attach it to the packet core instance, go to [Attach a data network](#attach-a-data-network).
7885
- If you want to make changes to a data network that's already attached to the packet core instance, go to [Modify attached data network configuration](#modify-attached-data-network-configuration).
@@ -157,7 +164,5 @@ If you made changes that triggered a packet core reinstall, reconfigure your dep
157164

158165
## Next steps
159166

160-
Use Log Analytics or the packet core dashboards to confirm your packet core instance is operating normally after you modify it.
161-
162-
- [Monitor Azure Private 5G Core with Log Analytics](monitor-private-5g-core-with-log-analytics.md)
163-
- [Packet core dashboards](packet-core-dashboards.md)
167+
- If you made a configuration change that requires a manual packet core reinstall, follow [Reinstall the packet core instance in a site](reinstall-packet-core.md).
168+
- 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 after you modify it.

0 commit comments

Comments
 (0)