How-to update your contact information on a Virtual Machine

All virtual machines running on ITS Private Cloud are required to have VM Administrator up-to-date. Based on Virtual Machine Administrator

If you are an administrator of a virtual machine in the ITS Private Cloud, it is important to ensure that your contact information is up-to-date to receive updates in a timely manner.

This tutorial will guide you through the steps to update your contact information, specifically your email address.

Instructions

There are two ways to modify administrator information:

1 Using VSS-CLI commands
2 Using VSS Cloud Portal
3 Bulk update

Using VSS-CLI commands

For this example we will use the of test.user

To view a list of virtual machines with administrator information, enter the following command:
format:
vss-cli --columns moref,name,folder.path,admin,inform compute vm ls -f admin=<EMAIL OR ID>
example:
vss-cli --columns moref,name,folder.path,admin,inform compute vm ls -f admin=test.user
output:
moref name folder.path admin inform --------- --------------- ----------------------------- ----------------------------------------------- ------------------------ vm-552331 2206Z-BLA-Dev TEST > 123 > Services > Dev Test User 1:815-948-1399:test.user@utoronto.ca test.user.2@utoronto.ca vm-829984 2107Y-TEST123 TEST > 123 > Services > DEV Test User 1:815-948-1399:test.user@utoronto.ca test.user.2@utoronto.ca vm-449021 2206X-XYZ-Dev2 TEST > 123 > Services > Dev Test User 1:815-948-1399:test.user@utoronto.ca test.user.2@utoronto.ca
To update the contact information of the admin, provide the ID of the virtual machine you wish to edit. (moref column) vm-55231

format:
vss-cli compute vm set <Virtual_Machine_ID> admin "<COMPLETE_NAME>" <EMAIL> <PHONE_NUMER:XXX-XXX-XXXX>
example:
vss-cli compute vm set vm-55231 admin "Test User X" test.user.5@utoronto.ca 419-341-2341
output:
id : 41063 status : SUBMITTED task_id : dfefdd03-d5c4-4b73-8030-193315f8be38 message : Request has been accepted for processing
Verify the changes have been successfully applied to the virtual machine.
format:
vss-cli compute vm get <Virtual_Machine_ID> admin
example:
vss-cli compute vm get vm-55231 admin
output:
name : Test User X email : test.user.5@utoronto.ca phone : 419-341-2341
To update the email addresses of other virtual machines, simply repeat the steps outlined above for each machine that requires an update. This will ensure that all virtual machines have up-to-date contact information and are receiving important updates from the ITS Private Cloud Portal.

Using VSS Cloud Portal

Open a web browser and log into the VSS Cloud Portal
Select the virtual machine you wish to update by clicking on the edit icon.
Navigate to the ADMIN tab and proceed to update the email address in the Admin email text field.
Click UPDATE button.
Click CONFIRM button to apply and save the changes.
To update the email addresses of other virtual machines, simply repeat the steps outlined above for each machine that requires an update. This will ensure that all virtual machines have up-to-date contact information and are receiving important updates from the ITS Private Cloud Portal.

Bulk update

Bulk update can be achieved with the vss-cli and bash as follows:

#!/bin/bash

# Define the vss-cli command to update the admin
UPDATE_ADMIN_CMD="vss-cli compute vm set"

# Define the VM IDs to update
VM_IDS=`vss-cli --columns moref --table-format plain --no-headers compute vm ls -f admin=oldadmin@mutoronto.ca`

# Define the admin details to update
ADMIN_NAME="John Doe"
ADMIN_EMAIL="john.doe@example.com"
ADMIN_PHONE="123-456-7890"

# Loop through each VM ID and update the admin
for VM_ID in "${VM_IDS[@]}"; do
  echo "Updating admin on VM $VM_ID..."
  $UPDATE_ADMIN_CMD $VM_ID admin "$ADMIN_NAME" "$ADMIN_EMAIL" "$ADMIN_PHONE"
  echo "Admin updated on VM $VM_ID."
done

Virtualization, Servers and Storage

How-to update your contact information on a Virtual Machine

Instructions

Using VSS-CLI commands

Using VSS Cloud Portal

Bulk update

Related articles

Related content