How-to manage VM Service Tagging (For ITS managed VMs only)
Introduction
The ITS Private Cloud platform introduces a new “VM Service tagging” feature, which is now a mandatory attribute for ITS managed VMs and it allows ITS VM owners to more easily manage and identify the VM’s role with its associated services.
By using the Cloud Portal or CLI or directly to the API, ITS VM admins can tag the services to their VMs by simply selecting a matching service from a pre-populated list of components which is automatically imported from the ITS System Status Page by the Cloud API.
The following how-to guides you through the process of tagging virtual machines with services via the Portal and Command Line interface
Step-by-step guide - Cloud Portal
Existing VM
Login to https://cloud-portal.eis.utoronto.ca
Look for the VM to edit and click the button.
From the VM action section (bottom), click on the ADMIN tab and look for the SERVICE field.
Each item in the dropdown menu is composed of the Service Group/Service just like the System Status website, for instance, lets assume the following VM is part of the ITS Private Cloud Infrastructure/Virtual Server Service:
Click the Update button and confirm the changes:
A new change request will be submitted.
New VM
Login to https://cloud-portal.eis.utoronto.ca
Click on the button to request a virtual machine.
Fill out the Virtual Machine specification as required.
In the Admin tab look for the Service field. Each item in the dropdown menu is composed of the Service Group/Service just like the System Status website, for instance, lets assume the following VM is part of the ITS Private Cloud Infrastructure/Virtual Server Service:
Click on the button CREATE.
A New virtual machine request will be submitted.
Step-by-step guide - Command Line Interface
Existing VM
Login to https://vss-cli.eis.utoronto.ca with your VSS Credentials or use your local VSS CLI install.
Initialize VSS CLI with vss-cli configure mk or skip this step if you have already configured the CLI:
vss-cli configure mk Username []: username Password: Repeat for confirmation:
Each service item in the is composed of the Service Group/Service just like the System Status website, for instance, lets assume the Vm to tag is part of the ITS Private Cloud Infrastructure/Virtual Server Service.
We can use the vss-cli service ls command to search for the service:
vss-cli service ls -f label=Private ID LABEL NAME GROUP ---- ------------------------------------------------------- ------ -------------------------------- 56 ITS Private Cloud Infrastructure/UTORbackup ITS Private Cloud Infrastructure 57 ITS Private Cloud Infrastructure/Virtual Server Service ITS Private Cloud Infrastructure
To tag a vm, the command vss-cli compute vm set {name-or-vm-id} vss-service {service-name-or-id}
vss-cli compute vm set {name-or-vm-id} vss-service "ITS Private Cloud Infrastructure/Virtual Server Service"
A new change request will be submitted.
New VM
Login to https://vss-cli.eis.utoronto.ca with your VSS Credentials or use your local VSS CLI install.
Initialize VSS CLI with vss-cli configure mk or skip this step if you have already configured the CLI:
Each service item in the is composed of the Service Group/Service just like the System Status website, for instance, lets assume the Vm to tag is part of the ITS Private Cloud Infrastructure/Virtual Server Service.
We can use the vss-cli service ls command to search for the service:
All subcommands in the vss-cli compute vm mk support the --vss-service
Any of the previous commands will submit a new Virtual machine request.
Related articles
University of Toronto - Since 1827