Page Comparison

If you do not have a virtual machine with operating system installed, please refer to Deploying a Development Environment.

This version of the VSS CLI supports managing virtual machines not only using the UUID and Moref but using names. In case of multiple results, the CLI prompts to select the right instance.

vss-cli compute vm ls -f name=Front

moref    name              folder.path                  cpu_count    memory_gb  power_state    ip_address
-------  ----------------  -------------------------  -----------  -----------  -------------  ------------
vm-2182  2004T-Frontend-1  VSS > Development > Dev03            1            1  poweredOff

Usage: vss-cli compute vm mk from-clone [OPTIONS] [NAME]

  Clone virtual machine from running or powered off vm.

  If name argument is not specified, -clone suffix will be added to
  resulting virtual machine.

Options:
  -s, --source TEXT               Source virtual machine or template MOREF or
                                  UUID.  [required]
  -d, --description TEXT          A brief description.  [required]
  -b, --client TEXT               Client department.
  -a, --admin TEXT                Admin name, phone number and email separated
                                  by `:` i.e. "John
                                  Doe:416-123-1234:john.doe@utoronto.ca"
  -r, --inform TEXT               Informational contact emails in comma
                                  separated
  -u, --usage [Test|Prod|Dev|QA]  Vm usage.
  -o, --os TEXT                   Guest operating system id.
  -m, --memory INTEGER            Memory in GB.
  -c, --cpu INTEGER               Cpu count.
  --cores-per-socket INTEGER      Cores per socket.
  -f, --folder TEXT               Logical folder moref name or path.
  --scsi TEXT                     SCSI Controller Spec <type>=<sharing>.
  -i, --disk TEXT                 Disk spec
                                  <capacity>=<backing_mode>=<backing_sharing>.
                                  optional: backing_mode, backing_sharing
  -n, --net TEXT                  Network adapter <moref-or-name>=<nic-type>.
  -t, --domain TEXT               Target fault domain name or moref.
  --notes TEXT                    Custom notes.
  -p, --custom-spec TEXT          Guest OS custom specification in JSON
                                  format.
  -e, --extra-config TEXT         Extra configuration key=value format.
  --power-on                      Power on after successful deployment.
  --template                      Mark the VM as template after deployment.
  --vss-service TEXT              VSS Service related to VM
  --instances INTEGER             Number of instances to deploy  [default: 1]
  -w, --firmware TEXT             Firmware type.
  --tpm                           Add Trusted Platform Module device.
  --storage-type TEXT             Storage type.
  --snapshot TEXT                 Snapshot to clone.
  --retire-type [timedelta|datetime]
                                  Retirement request type.
  --retire-warning INTEGER        Days before retirement date to notify
  --retire-value TEXT             Value for given retirement type. i.e.
                                  <hours>,<days>,<months>
  --help                          Show this message and exit.

This version of the VSS CLI supports managing networks not only using the moref, but also using names. In case of multiple results, the CLI prompts to select the right instance.

vss-cli compute net ls -f name=PUBLIC

moref              name                description         subnet            ports
-----------------  ------------------  ------------------  --------------  -------
dvportgroup-11052  VL-1584-VSS-PUBLIC  VSS Public network  142.1.216.0/23       32

export NET=dvportgroup-11052

export NET=dvportgroup-11052=e1000e

This version of the VSS CLI supports managing logical folders not only using the moref, but also using name or path. In case of multiple results, the CLI prompts to select the right instance.

vss-cli compute folder ls -f name=API

moref        name             path                               parent.name
-----------  ---------------  ---------------------------------  ---------------
group-v6736  APIDemo          jm > Demo > APIDemo                jm

export FOLDER=group-v6736

{
  "hostname": "string",
  "domain": "string",
  "dns": [
    "string"
  ],
  "dns_suffix": [
    "string"
  ],
  "interfaces": [{"dhcp": "bool",
                  "ip": "string",
                  "mask": "string",
                  "gateway": ["string"]
                 }]
}

{
  "hostname": "fe1",
  "domain": "eis.utoronto.ca",
  "interfaces": [{"dhcp": true}]
}

'{"hostname": "fe1", "domain": "eis.utoronto.ca", "interfaces": [{"dhcp": true}]}'

Passing above JSON data structure to --custom-spec in Linux, macOS, or Unix and Windows PowerShell use the single quote ' to enclose it. On the Windows command prompt, use the double quote " to enclose the data structure and escape the double quotes from the data structure using the backslash \.

Deploy multiple instances with the --instances flag.

Cloning a virtual machine from a specific snapshot state, use the --snapshot flag with the snapshot id. For more information about how to list snapshots, please refer to the Snapshot example.

vss-cli compute vm mk --wait from-clone --power-on --source Frontend \
--client EIS --folder APIDemo \
--memory 2 --cpu 2 --disk 40 --disk 40 --net VSS \
--custom-spec '{"hostname": "fe2", "domain": "eis.utoronto.ca", "interfaces": [{"dhcp": true}]}' \
--storage-type hdd \
--description "Frontend 2" Frontend2

To wait for the deployment to complete, you could use the --wait flag at the mk command level: i.e. vss-cli compute vm mk --wait from-clone ...`

vss-cli request new ls -s created_on=desc -c 1

  id  created_on                   updated_on                   status     vm_moref    vm_name          approval.approved    built_from
----  ---------------------------  ---------------------------  ---------  ----------  ---------------  -------------------  ------------
  76  2020-04-24 Fri 16:36:15 EDT  2020-04-24 Fri 16:37:31 EDT  PROCESSED  vm-2183     2004T-Frontend2  True                 clone

vss-cli compute vm get Frontend2 guest

hostname            : fe2
ip_address          : 142.1.217.228, fe80::250:56ff:fe92:323f
full_name           : CentOS 8 (64-bit)
guest_id            : centos8_64Guest
running_status      : guestToolsRunning

ssh username@<ip-address>

vss-cli compute vm get Frontend2 vsphere-link -l