System upgrade
To use the latest features that Azure Private 5G Core offers and to maintain the support you need for your private mobile network, plan to upgrade your packet core to new releases as they're available.
When a new version is available, Azure Private 5G Core displays a message for the relevant Packet Core Control Plane resource through the Azure portal, reminding you to upgrade. The network functions of a site won't be available while you upgrade the packet core instance of the site, so plan your upgrade carefully before starting the upgrade process.
A new version of the packet core may not be compatible with the version of the underlying system that you use. In that case, you'll need to upgrade the underlying system first. The Azure portal will warn you about the incompatibility between the new version and the underlying ASE system.
Tip
You can check the current version of a packet core instance and list all the available packet core versions with the Azure Private 5G Core REST API.
Plan to upgrade a packet core instance
To minimize the impact of an upgrade to your network services, plan your upgrade process beforehand.
Follow these guidelines while you plan:
Set aside an upgrade window with sufficient time reserved.
Based on your network configuration, the upgrade windows can be up to a few hours. The network functions won't be available during the upgrade and possible rollback.
Check if you need to upgrade the underlying system first.
Back up necessary deployment information.
Some configuration information will be overwritten during the upgrade. The information you may need to back up includes:
- The authentication information for the packet core dashboards and the distributed tracing tool:
- The Kubernetes Secret Object YAML file if you use the Microsoft Entra authentication method.
- The sign-in credentials if you use the local usernames/passwords authentication method.
- The customizations you made to the packet core dashboards. See the Grafana documentation for instructions on saving a backed-up copy of your dashboards.
- The traces you want to retain for the distributed tracing tool.
- The recovery steps for any UEs that can't automatically re-register. For details, check relevant UE documentation.
- The authentication information for the packet core dashboards and the distributed tracing tool:
For a private mobile network that has multiple sites, upgrade the packet core instance in one site first.
After the upgrade of the site, summarize what you've learned and then proceed to upgrade the packet core instances in other sites accordingly.
Check local alarms, dashboard activities, and test UE devices, to make sure everything works as expected after the upgrade. If UE devices aren't attached, use the local distributed tracing tool or the integrated diagnostic capture tool for further investigation.
For example, you can check the network statistics through the platform metrics or the packet core dashboards.
Upgrade a packet core instance
To upgrade a packet core instance, take these steps:
Back up necessary deployment information.
Open the Packet Core Control Plan resource representing the packet core instance that you want to upgrade, as shown in the following screenshot:
Select the Upgrade version button.
The Upgrade packet core version box is displayed, as shown in the following screenshot:
Select the version to which you want to upgrade, and then select Modify.
Once the upgrade is done, restore the backed-up deployment information as necessary.
Follow your test plan to make sure your network works as expected after the upgrade.
For detailed instructions, see Upgrade the packet core instance in a site.
If you're familiar with ARM templates, you can also use an ARM template to upgrade a packet core instance. The article Upgrade the packet core instance in a site - ARM template describes an example ARM template that you can use.
Roll back a packet core instance
If you encounter issues after an upgrade, you can roll back the packet core instance to the previous version.
The rollback process is almost the same as the upgrade process. The only difference is that you'll select a lower version to which to roll back.
Similar to the upgrade process, you'll need to plan for the rollback. For example, if you made any configuration changes for the new version of the packet core, you'll need to do necessary backup before the rollback.
For detailed instructions, see Upgrade the packet core instance in a site.
Reinstall a packet core instance
If you're experiencing issues with your deployment, reinstalling the packet core may help return it to a good state.
When you reinstall a packet core instance, Azure Private 5G Core first uninstalls the current instance, and then installs a new instance with the existing site configuration.
To reinstall a packet core instance, follow the instructions for planning and performing an upgrade. The only difference from the upgrade process is that instead of the Upgrade version button, you'll need to select the Reinstall packet core button, as shown in the following screenshot:
Upgrade the underlying system
If the version of the packet core to which you want to upgrade requires a new version of Azure Stack Edge (ASE), you'll need to upgrade the ASE before upgrading the packet core instance. The article Packet core and ASE compatibility provides more information about this version dependency.
When you upgrade the ASE, the Azure Kubernetes services running on it will be automatically upgraded.
Note
Your packet core instance will be affected during the upgrade of its underlying ASE. Plan your service maintenance window as necessary.
For detailed instructions about upgrading ASE, see Update your Azure Stack Edge Pro GPU.