Page Comparison

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

1. Login to https://cloud-portal.eis.utoronto.ca

2. Look for the VM to edit and click theImage Modified button.

3. From the VM action section (bottom), click on the ADMIN tab and look for the SERVICE field.

4. Each item in the dropdown menu is composed of the Service Group/Service just like the System Statuswebsite, for instance, lets assume the following VM is part of the ITS Private Cloud Infrastructure/Virtual Server Service:

...

1. 1. Image AddedImage Added

2. Click the Update button and confirm the changes:

...

1. 1. Image Added

2. A new change request will be submitted.

New VM

1. Login to https://cloud-portal.eis.utoronto.ca

2. Click on the Image Modified button to request a virtual machine.

3. Fill out the Virtual Machine specification as required.

4. 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 Statuswebsite, for instance, lets assume the following VM is part of the ITS Private Cloud Infrastructure/Virtual Server Service:

...

1. Image AddedImage Added

2. Click on the button CREATE.

3. A New virtual machine request will be submitted.

Step-by-step guide - Command Line Interface

Existing VM

1. Login to https://vss-cli.eis.utoronto.ca with your VSS Credentials or use your local VSS CLI install.

2. Initialize VSS CLI with vss-cli configure mk or skip this step if you have already configured the CLI:
   

   Code Block

...

1. vss-cli configure mk Username []: username Password: Repeat for confirmation:

2. Each service item in the is composed of the Service Group/Service just like the System Statuswebsite, for instance, lets assume the Vm to tag is part of the ITS Private Cloud Infrastructure/Virtual Server Service.

3. We can use the vss-cli service ls command to search for the service:

   Code Block
   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

4. To tag a vm, the command vss-cli compute vm set {name-or-vm-id} vss-service {service-name-or-id}

   Code Block
   vss-cli compute vm set {name-or-vm-id} vss-service "ITS Private Cloud Infrastructure/Virtual Server Service"

5. A new change request will be submitted.

New VM

1. Login to https://vss-cli.eis.utoronto.ca with your VSS Credentials or use your local VSS CLI install.

2. Initialize VSS CLI with vss-cli configure mk or skip this step if you have already configured the CLI:

   Code Block

...

1. vss-cli configure mk Username []: username Password: Repeat for confirmation:

2. Each service item in the is composed of the Service Group/Service just like the System Statuswebsite, for instance, lets assume the Vm to tag is part of the ITS Private Cloud Infrastructure/Virtual Server Service.

3. We can use the vss-cli service ls command to search for the service:

   Code Block
   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

4. All subcommands in the vss-cli compute vm mk support the --vss-service 

   Code Block

   vss-cli compute vm mk --help Usage: vss-cli compute vm mk [OPTIONS] COMMAND [ARGS]... Manage virtual machine attributes such as cpu, memory, disk, network backing, cd, etc.. Options: -u, --user-meta TEXT User metadata in key=value format. These tags are stored in the request. --help Show this message and exit. Commands: from-clone Create vm from clone from-file Create virtual machine from VSS CLI specification. from-image Create vm from OVA/OVF image. from-spec Create vm from another vm spec from-template Create vm from template shell Create empty virtual machine

5. Any of the previous commands will submit a new Virtual machine request.

Related articles

...