{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Virtual networks are mapped to Virtual Distributed Port Groups in order to simplify and scale the network layer. If you already have access to one or many virtual networks in our environment you certainly feel more familiar with this section, if not, you are probably going to use our public network labeled ","type":"text"},{"text":"VL-1584-VSS-PUBLIC","type":"text","marks":[{"type":"strong"}]},{"text":", which is a ","type":"text"},{"text":"DHCP enabled network","type":"text","marks":[{"type":"strong"}]},{"text":" and has ","type":"text"},{"text":"no firewall","type":"text","marks":[{"type":"strong"}]},{"text":" enabled due to its nature as just being temporary and/or for testing.","type":"text"}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Virtual-Networks"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Virtual-Networks"}},"macroMetadata":{"macroId":{"value":"eee3d506-8e99-4743-ab92-9ec0c3d9caa6"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Virtual-Networks"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-ManageNetworksandInterfaceCardswiththevss-cli-Virtual-Networks"}},"macroMetadata":{"macroId":{"value":"8719518b-d1a3-4b8c-a47e-a8fb25b2c2a8"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Virtual Networks","type":"text"}]},{"type":"paragraph","content":[{"text":"Virtual networks are unique in our environment and have to be differentiated by a unique identifier which in this case is the ","type":"text"},{"text":"moref","type":"text","marks":[{"type":"strong"}]},{"text":" and stands for ","type":"text"},{"text":"Managed Object Reference","type":"text","marks":[{"type":"strong"}]},{"text":" provided by vCenter server.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"vss-cli compute net","type":"text","marks":[{"type":"code"}]},{"text":" command lists and obtains information regarding a specific virtual network you have permission on.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute net --help\n\nUsage: vss-cli compute net [OPTIONS] COMMAND [ARGS]...\n\n List available virtual networks.\n\nOptions:\n --help Show this message and exit.\n\nCommands:\n get Get given virtual network info.\n ls list virtual networks.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"List","type":"text"}]},{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"vss-cli compute net ls","type":"text","marks":[{"type":"code"}]},{"text":" to list available networks. Filter list by name using the option ","type":"text"},{"text":"--filter-by/-f","type":"text","marks":[{"type":"code"}]},{"text":" which is structured ","type":"text"},{"text":" ,","type":"text","marks":[{"type":"code"}]},{"text":" and available operators are ","type":"text"},{"text":"eq, ne, lt, le, gt, ge, like, in","type":"text","marks":[{"type":"strong"}]},{"text":" as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute net ls -f name=PUBLIC\n\nmoref name description subnet vlan_id vms\n----------------- ------------------ --------------------------- -------------- --------- -----\ndvportgroup-11052 VL-1584-VSS-PUBLIC VSS Public network 142.1.216.0/23 1584 8","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Info"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Info"}},"macroMetadata":{"macroId":{"value":"ac204d63-4cce-4c39-8030-7bd2c81a1b1a"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Info"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-ManageNetworksandInterfaceCardswiththevss-cli-Info"}},"macroMetadata":{"macroId":{"value":"8b987fc0-c49c-45b4-a486-e9104bb76749"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Info","type":"text"}]},{"type":"paragraph","content":[{"text":"Network info is available by ","type":"text"},{"text":"vss-cli compute net get ","type":"text","marks":[{"type":"code"}]},{"text":" and provides basic information of a given network:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute net get dvportgroup-11052\n\nmoref : dvportgroup-11052\nname : VL-1584-VSS-PUBLIC\ndescription : VSS Public network\nsubnet : 142.1.216.0/23\nvlan_id : 1584\nvms : 8\nports : 32\nadmin : Jose Manuel Lopez Lujan:000-0000-000:email@eis.utoronto.ca\nclient : EIS\nupdated_on : 2019-07-09 Tue 16:00:05 EDT","type":"text"}]},{"type":"paragraph","content":[{"text":"If you would like to get a list of your virtual machines available on a given network, use the ","type":"text"},{"text":"vss-cli compute net get vms","type":"text","marks":[{"type":"code"}]},{"text":" command. A list of ","type":"text"},{"text":"uuid","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"name","type":"text","marks":[{"type":"em"}]},{"text":" will be provided.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute net get dvportgroup-11052 vms\n\nuuid name\n------------------------------------ -----------------------\n501220a5-a091-1866-9741-664236067142 1611T-ecstatic_mccarthy\n501220a5-a091-6652-3215-123456548798 1701T-ecstatic_torvalds","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Virtual-Machine-Network-Adapters"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Virtual-Machine-Network-Adapters"}},"macroMetadata":{"macroId":{"value":"c433ba85-fb36-4f01-b58c-35a62a752308"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Virtual-Machine-Network-Adapters"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-ManageNetworksandInterfaceCardswiththevss-cli-Virtual-Machine-Network-Adapters"}},"macroMetadata":{"macroId":{"value":"9ea2b9bf-f582-4448-a0cd-73a16aba1b4e"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Virtual Machine Network Adapters","type":"text"}]},{"type":"paragraph","content":[{"text":"Virtual machine network interface cards backing is always a virtual network. Virtual machine NICs can be manage by ","type":"text"},{"text":"vss-cli compute vm nic ","type":"text","marks":[{"type":"code"}]},{"text":". Both ","type":"text"},{"text":"get","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"set","type":"text","marks":[{"type":"em"}]},{"text":" commands have similar arguments ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"set","type":"text","marks":[{"type":"em"}]},{"text":" has a few properties to set as shown below:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm get ecstatic_mccarthy nic --help\n\nUsage: vss-cli compute vm get nic [OPTIONS] [UNIT]\n\n Virtual machine network interface adapters configuration.\n\nOptions:\n --help Show this message and exit.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"Usage: vss-cli compute vm set nic [OPTIONS] COMMAND [ARGS]...\n\n Add, remove or update virtual machine network adapters\n\nOptions:\n --help Show this message and exit.\n\nCommands:\n mk Create NIC unit\n rm Remove NIC unit\n up Update NIC unit","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"List","type":"text"}]},{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"vss-cli compute vm nic","type":"text","marks":[{"type":"code"}]},{"text":" to obtain a summary of your virtual machineconfigured network interface controllers. If you specify ","type":"text"},{"text":"unit","type":"text","marks":[{"type":"code"}]},{"text":", the command will provide further information about the given unit as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm get 501220a5-a091-1866-9741-664236067142 nic 1\n\n\nlabel : Network adapter 1\nmac_address : 00:50:56:00:00:00\ntype : vmxnet3\nnetwork.name : VL-1584-VSS-PUBLIC\nnetwork.moref : dvportgroup-11052\nconnected : True\nstart_connected : True","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Update"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Update"}},"macroMetadata":{"macroId":{"value":"06fb7975-03fc-4941-9b32-7177063a81c6"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Update"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-ManageNetworksandInterfaceCardswiththevss-cli-Update"}},"macroMetadata":{"macroId":{"value":"d0bb6075-9cb4-4e4a-89d7-c0a241ab6466"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Update","type":"text"}]},{"type":"paragraph","content":[{"text":"Update a given virtual machine network interface card backing network by running ","type":"text"},{"text":"vss-cli compute vm nic up --network ","type":"text","marks":[{"type":"code"}]},{"text":" where ","type":"text"},{"text":"uuid","type":"text","marks":[{"type":"code"}]},{"text":" is the virtual machine UUID or name, ","type":"text"},{"text":"unit","type":"text","marks":[{"type":"code"}]},{"text":" is the nic labeled unit and ","type":"text"},{"text":"moref","type":"text","marks":[{"type":"em"}]},{"text":" is the virtual network identifier or name.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, if a given nic needs to be updated to network ","type":"text"},{"text":"dvportgroup-0000","type":"text","marks":[{"type":"code"}]},{"text":", the command to use would be:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set 501220a5-a091-1866-9741-664236067142 nic up --network dvportgroup-0000 1\n\n# or\n\nvss-cli compute vm set TEST nic up --network VL-0000-NETWORK 1","type":"text"}]},{"type":"paragraph","content":[{"text":"New virtual machines by default are provisioned using the ","type":"text"},{"text":"vmxnet3","type":"text","marks":[{"type":"code"}]},{"text":" virtual adapter controller, designed to deliver high performance in virtual machines, but there are rare cases, the operating system does not include the ","type":"text"},{"text":"vmxnet<2|3>","type":"text","marks":[{"type":"code"}]},{"text":" drivers and the only way of getting them is online, a virtual machine network adapter should be modified with a more generic controller, such as ","type":"text"},{"text":"e1000","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"e1000e","type":"text","marks":[{"type":"code"}]},{"text":". To do so, run ","type":"text"},{"text":"vss-cli compute vm set nic up --adapter 1","type":"text","marks":[{"type":"code"}]},{"text":", for example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set 501220a5-a091-1866-9741-664236067142 nic up --adapter e1000e 1","type":"text"}]},{"type":"paragraph","content":[{"text":"After downloading ","type":"text"},{"text":"OpenVM Tools","type":"text","marks":[{"type":"strong"}]},{"text":" which contain the drivers, change back to the ","type":"text"},{"text":"vmxnet3","type":"text","marks":[{"type":"code"}]},{"text":" controller by performing the same bas operation but replacing ","type":"text"},{"text":"e1000e","type":"text","marks":[{"type":"code"}]},{"text":" with ","type":"text"},{"text":"vmxnet3","type":"text","marks":[{"type":"code"}]},{"text":" as shown below:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set 501220a5-a091-1866-9741-664236067142 nic up --adapter vmxnet3 1","type":"text"}]},{"type":"paragraph","content":[{"text":"Network interface connection states can also be updated to either ","type":"text"},{"text":"connect","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"disconnect","type":"text","marks":[{"type":"code"}]},{"text":" given the requirements. To perform a state change execute ","type":"text"},{"text":"vss-cli compute vm set nic up --state ","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set 501220a5-a091-1866-9741-664236067142 nic up --state connect 1","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Create"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Create"}},"macroMetadata":{"macroId":{"value":"8e2c0f2c-10f1-4616-be94-3369672ed162"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Create"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-ManageNetworksandInterfaceCardswiththevss-cli-Create"}},"macroMetadata":{"macroId":{"value":"02486120-661e-488e-a805-0a072af22e52"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Create","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a new virtual machine network adapter by using the sub command ","type":"text"},{"text":"mk","type":"text","marks":[{"type":"code"}]},{"text":" and providing the backing network and type separated by the ","type":"text"},{"text":"=","type":"text","marks":[{"type":"code"}]},{"text":" sign in the option. i.e. ","type":"text"},{"text":"=","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"Usage: vss-cli compute vm set nic mk [OPTIONS]\n\n Add network adapters specifying backing network and adapter type.\n\n vss-cli compute vm set nic mk -n = -n \n\nOptions:\n -n, --net TEXT Network adapter =. [required]\n --help Show this message and exit.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If no adapter is set, ","type":"text"},{"text":"vmxnet3","type":"text","marks":[{"type":"code"}]},{"text":" is used.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set 1909P-WEB nic mk -n dvportgroup-1083=vmxnet2 -n dvportgroup-1094","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Remove"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Remove"}},"macroMetadata":{"macroId":{"value":"57dfdd32-a144-4adc-a776-8695246b3e4e"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-Remove"},"legacyAnchorId":{"value":"ManageNetworksandInterfaceCardswiththevss-cli-ManageNetworksandInterfaceCardswiththevss-cli-Remove"}},"macroMetadata":{"macroId":{"value":"1807f913-f47a-41ec-8844-1b70a1fdc152"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Remove","type":"text"}]},{"type":"paragraph","content":[{"text":"Network adapter removal will ask for confirmation if flag ","type":"text"},{"text":"-r/--rm","type":"text","marks":[{"type":"code"}]},{"text":" 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.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following example demonstrates how to remove a nic with a confirmation prompt:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set 50128d83-0fcc-05e3-be71-d972ffdf3284 nic rm 2\n\nNetwork adapter: 2\nMac address: 00:50:56:92:4d:b8\nNetwork: Quarantine (dvportgroup-11137)\nConnected: False\n\nAre you sure you want to delete listed NICs [y/N]:\n\nError: Cancelled by user.","type":"text"}]},{"type":"paragraph","content":[{"text":"If your answer is ","type":"text"},{"text":"N","type":"text","marks":[{"type":"strong"}]},{"text":", the command will exit as shown above.","type":"text"}]},{"type":"paragraph","content":[{"text":"To override nic removal confirmation prompt, just add ","type":"text"},{"text":"-r/--rm","type":"text","marks":[{"type":"code"}]},{"text":" flag as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set 50128d83-0fcc-05e3-be71-d972ffdf3284 nic rm --rm 2","type":"text"}]}],"version":1}

Browser not supported