How to update your Ubuntu Pro token¶

When you change your Ubuntu Pro subscription tier, your Ubuntu Pro token will change too. This guide explains how to update the token on your Ubuntu machines while ensuring that the same Ubuntu Pro tools remain enabled as before.

Check which Ubuntu Pro tools are enabled¶

First, we need to check which Ubuntu Pro tools are enabled in your environment by running the following command in your terminal:

$ pro status

You will get an output like this:

SERVICE          ENTITLED  STATUS       DESCRIPTION
esm-apps         yes       enabled      Expanded Security Maintenance for Applications
esm-infra        yes       enabled      Expanded Security Maintenance for Infrastructure
fips-updates     yes       disabled     FIPS compliant crypto packages with stable security updates
landscape        yes       enabled      Management and administration tool for Ubuntu
livepatch        yes       enabled      Canonical Livepatch service
realtime-kernel* yes       disabled     Ubuntu kernel with PREEMPT_RT patches integrated
usg              yes       disabled     Security compliance and audit tools

Take note of the enabled services. In the above output, for example, I can see that ESM Apps, ESM Infra, Landscape and Livepatch are enabled.

Update your Default settings¶

From there, navigate to Default settings and update the default tools to match the output from the previous step:

../_images/Pro-token-default-settings.png

If we continue with my own example, I would set ESM Apps, ESM Infra and Livepatch as default tools.

Landscape does not need to be set as a default tool because any Landscape registration will remain valid as long as an active Ubuntu Pro token is present on the registered machine.

Update the Ubuntu Pro token on a test machine¶

Copy your new Ubuntu Pro token from the Ubuntu Pro dashboard, then apply it to a test machine:

$ sudo pro detach && sudo pro attach NEW_TOKEN

Then verify that the correct tools are enabled:

$ sudo pro status

Update the Ubuntu Pro token across your Ubuntu environment¶

Once you are happy that the default settings for your new Ubuntu Pro token have been correctly updated, proceed with applying your new Ubuntu Pro token across your remaining Ubuntu machines:

$ sudo pro detach && sudo pro attach NEW_TOKEN

For machines registered to Landscape, we also want to restart Landscape client:

sudo systemctl enable landscape-client
sudo systemctl start landscape-client

If you need to update the token on lots of machines at once, you can run these commands using Landscape’s scripts functionality or any other scripting tool in use in your Ubuntu environment.

Congratulations - you have successfully updated your Ubuntu Pro token!¶

Good job - your new Ubuntu Pro token is now attached to your Ubuntu machines. You may have new tools available in your updated subscription; for a list of all tools included in your subscription, run the ‘pro status’ command again.

If you want to learn more about any Ubuntu Pro tool, review What is included in Ubuntu Pro?