Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

We encourage all of our customers to have a custom network segment plumbed into our environment and that can be done first by contacting UofT Network Administration Tools and then providing the allocated segment and VLAN information to the VSS Team.

Anchor
Virtual-Networks
Virtual-Networks
Anchor
ManageNetworksandInterfaceCards-Virtual-Networks
ManageNetworksandInterfaceCards-Virtual-Networks
Virtual Networks

Virtual networks are unique in our environment and have to be differentiated by a unique identifier which in this case is the moref and stands for Managed Object Reference provided by vCenter server.

...

Code Block
languagebash
linenumbersfalse
vss-cli compute net ls -f name=PUBLIC

moref              name                description                  subnet          vlan_id    vms
-----------------  ------------------  ---------------------------  --------------  ---------  -----
dvportgroup-11052  VL-1584-VSS-PUBLIC  VSS Public network           142.1.216.0/23  1584       8

Anchor
Info
Info
Anchor
ManageNetworksandInterfaceCards-Info
ManageNetworksandInterfaceCards-Info
Info

Network info is available by vss-cli compute net get <name-or-moref> and provides basic information of a given network:

...

Code Block
languagebash
linenumbersfalse
vss-cli compute net get dvportgroup-11052 vms

uuid                                  name
------------------------------------  -----------------------
501220a5-a091-1866-9741-664236067142  1611T-ecstatic_mccarthy
501220a5-a091-6652-3215-123456548798  1701T-ecstatic_torvalds

Anchor
Virtual-Machine-Network-Adapters
Virtual-Machine-Network-Adapters
Anchor
ManageNetworksandInterfaceCards-Virtual-Machine-Network-Adapters
ManageNetworksandInterfaceCards-Virtual-Machine-Network-Adapters
Virtual Machine Network Adapters

Virtual machine network interface cards backing is always a virtual network. Virtual machine NICs can be manage by vss-cli compute vm <name-or-uuid> <set|get> nic <unit>. Both get and set commands have similar arguments <unit> and set has a few properties to set as shown below:

...

Code Block
languagebash
linenumbersfalse
vss-cli compute vm get 501220a5-a091-1866-9741-664236067142 nic 1


label               : Network adapter 1
mac_address         : 00:50:56:00:00:00
type                : vmxnet3
network.name        : VL-1584-VSS-PUBLIC
network.moref       : dvportgroup-11052
connected           : True
start_connected     : True

Anchor
Update
Update
Anchor
ManageNetworksandInterfaceCards-Update
ManageNetworksandInterfaceCards-Update
Update

Update a given virtual machine network interface card backing network by running vss-cli compute vm <name-or-uuid> nic up --network <name-or-moref> <unit> where uuid is the virtual machine UUID or name, unit is the nic labeled unit and moref is the virtual network identifier or name.

...

Code Block
languagebash
linenumbersfalse
vss-cli compute vm set 501220a5-a091-1866-9741-664236067142 nic up --state connect 1

Anchor
Create
Create
Anchor
ManageNetworksandInterfaceCards-Create
ManageNetworksandInterfaceCards-Create
Create

Create a new virtual machine network adapter by using the sub command mk and providing the backing network and type separated by the = sign in the option. i.e. <moref-or-name>=<nic_type>.

...

Code Block
languagebash
linenumbersfalse
vss-cli compute vm set 1909P-WEB nic mk -n dvportgroup-1083=vmxnet2 -n dvportgroup-1094

Anchor
Remove
Remove
Anchor
ManageNetworksandInterfaceCards-Remove
ManageNetworksandInterfaceCards-Remove
Remove

Network adapter removal will ask for confirmation if flag -r/--rm is not provided. This is just as fail safe for mistakes that can happen and since nic removal is a one way action, which disposes the MAC address.

...