Upgrade MX-PDK
Every 6 months or so, there's a new BubbleRAN software release available to all customers with an active BubbleRAN license.
In order to upgrade your system to the latest release you should perform the following steps:
Notify the BubbleRAN team via Discord
Using your dedicated Discord channel you should notify us that you want to perform upgrade of the release.
A member of our team will shortly make the preparations on our Gaia server (used for remote installation) and reply giving you the OK to proceed with the upgrade.
Remove any present network deployment in your cluster
Before going ahead with the upgrade, we strongly recommend removing any network deployment.
Please check if you have any active deployment using brc observe.
If you have made changes on a configmap for a given composition model we recommend to make a back-up since current composition models will overwrite this configmap with new release ones.
To do so you may run kubectl get configmaps -n trirematics model-base-<composition_model> -o yaml > backup_cfg.yaml replacing <composition_model> with the name of the composition model you want to back up (e.g., oai-ran).
Perform the upgrade through cloud-init
Starting from the control-plane node, you should run the following command to re-start your cluster with the upgraded release:
sudo cloud-init clean --logs --seed --reboot
This command will automatically reboot the node and recreate a cluster with the latest software release. In this process, after the server has booted again, and the changes are being applied you can follow the progress with
sudo tail --follow /var/log/cloud-init-output.log
Once you get a message like the following :
Cloud-init v. 23.4.2-br-1-gdc2be105-1~bddeb running 'modules:final' at Sun, 06 Jul 2025 11:17:07 +0000. Up 285.24 seconds.
It means that the upgrade is complete on the control-plane node. Now you can perform the same step on the worker nodes, if any, with the same command.
Once this step is applied on ALL nodes, the upgrade is complete!
You may check the status of your infrastructure running brc extract infra which should show as output the information of all your MX-PDK nodes.