Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

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.

(blue star) Requirements

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

    vss-cli upgrade

# or

pip3 install --upgrade vss-cli

# or

brew update && brew upgrade vss-cli

  2. VM Running on Cluster FD3. Check if your Virtual Machine is already on domain FD3: 

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

  3. If your VM is not currently running on Cluster FD3, do not worry, just request a migration to FD3 and proceed to next step:

    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:

    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:

    vss-cli --wait compute vm set {vm_id-or-name} ubuntu-pro attach

  2. From Ubuntu, execute the following commands to enable Ubuntu Pro:

    sudo apt install ubuntu-advantage-pro ubuntu-advantage-tools

  3. Install livepatch from snap as follows: 

    snap install canonical-livepatch

  4. Update contract_url in /etc/ubuntu-advantage/uaclient.conf with on-premise instance.

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

  5. Enable pro with 

    sudo pro attach $(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.token")

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

    sudo sed -i 's/machine \([^ ]*\)/machine https:\/\/\1/' /etc/apt/auth.conf.d/90ubuntu-advantage

  7. Configure on-premise livepatch: 

    canonical-livepatch config remote-server="$(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.livepatch.endpoint")"

  8. Enable on-premise livepatch: 

    canonical-livepatch enable $(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.livepatch.token")

Canonical Cloud

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

    vss-cli --wait compute vm set {vm_id-or-name} ubuntu-pro attach

  2. From Ubuntu, execute the following commands to enable Ubuntu Pro:

    sudo apt install ubuntu-advantage-pro ubuntu-advantage-tools

  3. Enable pro with 

    sudo pro attach $(vmware-rpctool "info-get guestinfo.ut.vss.ubuntu_pro.token")

🧐 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 FD3. 

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

output:

MOREF               : domain-c5877
NAME                : FD3


Run the following command through the vss-cli to attach Ubuntu Pro to your virtual machine

vss-cli --wait compute vm set {vm_id-or-name} ubuntu-pro attach

output:

id                  : B399A
status              : SUBMITTED
task_id             : 29870123-XXXX-4a03-894a-f350481XXXXX
message             : Request has been accepted for processing
⏳ Waiting for request B399A to complete...
🎉 Request B399A completed successfully:
warnings            : Ubuntu Pro settings have been re-applied.
errors              :


Once you receive the confirmation that the Ubuntu Pro token is set up, proceed with updating packages on the desired virtual machine using the following commands:

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

 

  • No labels

University of Toronto - Since 1827