Upgrade the packet core instance in a site - ARM template

Each Azure Private 5G Core Preview site contains a packet core instance, which is a cloud-native implementation of the 3GPP standards-defined 5G Next Generation Core (5G NGC or 5GC). You'll need to periodically upgrade your packet core instances to get access to the latest Azure Private 5G Core features and maintain support for your private mobile network. In this how-to guide, you'll learn how to upgrade a packet core instance using an Azure Resource Manager template (ARM template).

An ARM template is a JavaScript Object Notation (JSON) file that defines the infrastructure and configuration for your project. The template uses declarative syntax. In declarative syntax, you describe your intended deployment without writing the sequence of programming commands to create the deployment.

If your environment meets the prerequisites and you're familiar with using ARM templates, select the Deploy to Azure button. The template will open in the Azure portal.

Deploy to Azure.

Prerequisites

  • Contact your Microsoft assigned trials engineer. They'll guide you through the upgrade process and provide you with the required information, including the amount of time you'll need to allow for the upgrade to complete and the new software version number.
  • 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.
  • Identify the name of the site that hosts the packet core instance you want to upgrade.

Review the template

The template used in this quickstart is from Azure Quickstart Templates. To view the template, see azuredeploy.json.

The template modifies the version of an existing Microsoft.MobileNetwork/packetCoreControlPlanes resource. This causes an uninstall and reinstall of the packet core with the new resource version - no other resources are modified during this process, unless you change the configuration of the new version. The resource provides configuration for the control plane network functions of the packet core instance, including IP configuration for the N2 interface.

Deploy the template

  1. Select the following link to sign in to Azure and open the template.

    Deploy to Azure.

  2. Select or enter the following values, using the information you retrieved in Prerequisites.

    • Subscription: select the Azure subscription you used to create your private mobile network.
    • Resource group: select the resource group containing the mobile network resource representing your private mobile network.
    • Region: select East US.
    • Existing packet core: select the name of the packet core instance you want to upgrade.
    • Version: enter the version to which you want to upgrade the packet core instance.

    Screenshot of the Azure portal showing the configuration fields for the upgrade ARM template.

  3. Select Review + create.

  4. Azure will now validate the configuration values you've entered. You should see a message indicating that your values have passed validation.

    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.

  5. Once your configuration has been validated, you can select Create to upgrade the packet core instance. The Azure portal will display a confirmation screen when the packet core instance has been upgraded.

Review deployed resources

  1. Select Go to resource group.

    Screenshot of the Azure portal showing a deployment confirmation for the ARM template.

  2. Select the Packet Core Control Plane resource representing the control plane function of the packet core instance in the site.

  3. Check the Version field under the Configuration heading to confirm that it displays the new software version.

Next steps

You should use Log Analytics or the packet core dashboards to confirm your packet core instance is operating normally after the upgrade.