Versions Compared

Key

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

Take advantage of the new Ubuntu Pro offering from the ITS Private Cloud to enable Enhanced Security, Performance Optimization and Streamlined Management by following the next steps.

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 FD3. Check if your Virtual Machine is already on domain FD3listed 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 Cluster FD3 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")

    Update /etc/apt/auth.conf.d/90ubuntu-advantage as follows:

    Code Block
    sudo sed -i 's/machine \([^ ]*\)/machine https:\/\/\1/' /etc/apt/auth.conf.d/90ubuntu-advantage
  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 in cluster FD3on any of the clusters listed above.

Code Block
vss-cli compute vm get {vm_id-or-name} domain

...

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

  1. Error: Failed to attach machine. See https://ubuntu.com/pro/dashboard" 

    Solution:
    Ensure you can connect to the contract url: https://vss-ubuntu-pro.eis.utoronto.ca

    Try the following command:

    Code Block
    curl https://vss-ubuntu-pro.eis.utoronto.ca

    output:

    Code Block
    404 page not found


    If your output is different, this means that you have a firewall or proxy configuration that is not allowing you to connect to our Ubuntu Pro instance. Feel free to contact us to troubleshoot further this issue.

(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"