Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Virtual Machines running on the following domains are entitled to Ubuntu Pro:

  • FD1

  • FD3

  • FD4

(blue star) Requirements

  1. ITS Private Cloud Command Line Interface vss-cli v2023.6.1 or higher:

    Code Block
    vss-cli upgrade
    
    # or
    
    pip3 install --upgrade vss-cli
    
    # or
    
    brew update && brew upgrade vss-cli
  2. VM Running on any Cluster listed above. To verify where your VM is running:

    Code Block
    vss-cli compute vm get {vm_id-or-name} domain
  3. If your VM is not currently running on clusters listed above, do not worry, just request a migration to FD3, for example, and proceed to next step:

    Code Block
    vss-cli --wait compute vm set {vm_id-or-name} domain FD3
  4. Open VMware Tools installed and running. Install and enable VMware Tools as follows:

    Code Block
    sudo apt install open-vm-tools
    
    sudo systemctl enable --now open-vm-tools

Obtain your VM id or name by using the following lookup command:: vss-cli compute vm ls -f ip_address=X.X.X.X which search by IP address and vss-cli compute vm ls -f hostname=myhostname searching by Hostname or simply listing all your VMs with vss-cli compute vm ls.

\uD83D\uDCD8 Instructions

Ubuntu Pro activation is recommended via the ITS Private Cloud on-premise server, although connecting to Canonical Cloud servers offers a simpler alternative.

ITS Private Cloud (Recommended)

  1. To activate your existing virtual instances, just execute the following vss-cli command:

    Code Block
    vss-cli --wait compute vm set {vm_id-or-name} ubuntu-pro attach
  2. From Ubuntu, execute the following commands to enable Ubuntu Pro:

    Code Block
    sudo apt install ubuntu-advantage-pro ubuntu-advantage-tools
  3. Install livepatch from snap as follows:

    Code Block
    snap install canonical-livepatch
  4. Update contract_url in /etc/ubuntu-advantage/uaclient.conf with on-premise instance.

    Code Block
    sudo echo "contract_url: $(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.endpoint")" > /etc/ubuntu-advantage/uaclient.conf
  5. Enable pro with

    Code Block
    sudo pro attach $(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.token")
  6. Configure on-premise livepatch:

    Code Block
    canonical-livepatch config remote-server="$(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.livepatch.endpoint")"
  7. Enable on-premise livepatch:

    Code Block
    canonical-livepatch enable $(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.livepatch.token")
  8. Run apt update:

    Code Block
    sudo apt update

Canonical Cloud

  1. To activate your existing virtual instances, just execute the following vss-cli command:

    Code Block
    vss-cli --wait compute vm set {vm_id-or-name} ubuntu-pro attach
  2. From Ubuntu, execute the following commands to enable Ubuntu Pro:

    Code Block
    sudo apt install ubuntu-advantage-pro ubuntu-advantage-tools
  3. Enable pro with

    Code Block
    sudo pro attach $(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.token")
  4. Run apt update:

    Code Block
    sudo apt update

🧐 Frequently Asked Questions (FAQ)

1. Invalid Token error when running command: sudo pro attach $(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.token")

Solution:

Ensure the virtual machine is running on any of the clusters listed above.

...

Code Block
sudo apt install ubuntu-advantage-pro ubuntu-advantage-tools
sudo pro attach $(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.token")

(question) Questions?

Please feel free to reach out at vss-ubuntu-pub@eis.utoronto.ca

 

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@32c6ab3f
sortmodified
showSpacefalse
reversetrue
typepage
labelskb-how-to-article
cqllabel = "kb-how-to-article" and type = "page" and space = "VSSPublic"