NOTE: If you’re interested in getting notified for the latest Anbox Cloud releases, make sure you subscribe to notifications on the announcements category on the Anbox Cloud discourse.
Anbox Cloud allows upgrades from older versions to newer version. This describes the steps necessary to perform the upgrade.
The upgrade instructions detail the revisions each charm needs to be upgraded to, to bring it to the latest version. Next to the upgrade of the charms any used images or addons need to be updated as well.
Upgrades are only allowed from the previous version of Anbox Cloud. Skipping versions is not possible and will cause the upgrade process to fail. For example you can only upgrade from 1.0 to 1.1 but not from 1.0 to 1.4.
Warning: Before you perform the upgrade ensure that you perform a backup of critical data you don’t want to lose.
Upgrading all charms
With the 1.8 release of Anbox Cloud you MUST use Juju >= 2.8.6. If your deployment doesn’t yet use Juju 2.8.6 you have to upgrade your controller and all models first. See the Juju documentation for more details on how to upgrade the Juju controller and all models to Juju 2.8.6.
From 1.8.x or 1.9.x
The deployed Juju charms need to be upgraded next. Please execute the following commands in the exact same order as listed here but skip those you don’t use in your deployment:
$ juju upgrade-charm easyrsa --revision=333 $ juju upgrade-charm etcd --revision=540 $ juju upgrade-charm lxd --revision=27 $ juju upgrade-charm ams --revision=30 $ juju upgrade-charm ams-node-controller --revision=24 $ juju upgrade-charm aar --revision=15
If you have the streaming stack deployed you have to upgrade also the following charms:
$ juju upgrade-charm anbox-stream-gateway --revision=37 $ juju upgrade-charm anbox-stream-agent --revision=30 $ juju upgrade-charm coturn --revision=31 $ juju upgrade-charm nats --revision=9
Once the commands are executed, Juju will perform all necessary upgrade steps automatically.
After Juju has settled the workload status will be marked as
blocked and the status will show
UA token missing.
Since the 1.7.0 release of Anbox Cloud a valid Ubuntu Advantage token including the Anbox Cloud entitlement is mandatory. Generally you can get your Ubuntu Advantage token on Ubuntu Advantage but your account has to specifically whitelisted to be entitled for Anbox Cloud. If your account has not yet whitelisted or you’re unsure, please speak with your Canonical account representative.
When you have your Ubuntu Advantage token you can apply it for all relevant charms with the following commands:
$ juju config ams ua_token=<your token> $ juju config lxd ua_token=<your token> $ juju config ams-node-controller ua_token=<your token> $ juju config aar ua_token=<your token> $ juju config anbox-stream-gateway ua_token=<your token> $ juju config anbox-stream-agent ua_token=<your token> $ juju config anbox-cloud-dashboard ua_token=<your token>
When the token is set Juju will continue to upgrade Anbox Cloud and install the latest version of the software components.
Upgrade Debian Packages
Some parts of Anbox Cloud are distributed as Debian packages coming from the Anbox Cloud Archive. In order to apply all pending upgrades, run the following commands on your machines:
$ sudo apt update $ sudo apt upgrade
or apply the updates via Landscape if available.
Upgrade LXD Image
LXD images are automatically being fetched by AMS from the image server once they are published.
Existing applications will be automatically updated by AMS as soon as the new image is uploaded. Watch out for new versions being added for any of the existing applications based on the new image version.
You can check for the status of an existing application by running
$ amc application show <application id or name>
Image Server Access
Starting with Anbox Cloud 1.9.0 you do not need to manually configure the
images.auth configuration option in AMS anymore with your personal username and password. Authentication to the image server is now fully automated via your Ubuntu Advantage subscription.
Existing deployments will be automatically migrated to the new image server endpoint
https://images.anbox-cloud.io/stable/ and authentication based on your Ubuntu Advantage subscription will be setup during the AMS charm upgrade process as well. All you need to have configured for this is the Ubuntu Advantage token on the AMS charm you set during deploying with the deploying command:
$ juju config ams ua_token=<your token>
To verify the migration you can validate that the
images.url configuration option in AMS is now changed to
https://images.anbox-cloud.io/stable/ and the 1.9 images are successfully downloaded.
Image Name Changes
With the 1.4 release the image names have changed. Before they were
As with 1.4 we added Android 10 and will also migrate to the Ubuntu 20.04 release as an option in the future the images are renamed to:
Your applications are not automatically migrated to the new images. Every deployment of Anbox Cloud will automatically download the new images from the image server but applications wont be automatically updated.
Migrating existing applications to the new images can be achieved with the following command:
$ amc application set <application id or name> image <image name>