The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter contains the following sections:
Virtual Ethernet (vEthernet or vEth) interfaces are logical interfaces. Each vEthernet interface corresponds to a switch interface that is connected to a virtual port. The interface types are as follows:
vEthernet interfaces are created on the Cisco Nexus 1000V to represent virtual ports in use on the distributed virtual switch.
vEthernet interfaces are mapped to connected ports by MAC address as well as DVPort number. When a server administrator changes the port profile assignment on a vNIC or hypervisor port, the same vEthernet interface is reused.
When bringing up a vEthernet interface where a change in the port profile assignment is detected, the Virtual Supervisor Module (VSM) automatically purges any manual configuration present on the interface. You can use the following command to prevent purging of the manual configuration:
no svs veth auto-config-purge
vEthernet interface configuration has the following guideline and limitation:
MTU cannot be configured on a vEthernet interface.
Parameters | Default |
---|---|
Switchport mode |
Access |
Allowed VLANs |
1 to 4094 |
Access VLAN ID |
VLAN1 |
Native VLAN ID |
VLAN1 |
Native VLAN ID tagging |
Disabled |
Administrative state |
Shut |
Automatic deletion of vEthernet interfaces |
Enabled |
Automatic purge of manual configuration on vEthernet interfaces |
Enabled |
Automatic creation of vEthernet interfaces |
Enabled |
You can use this procedure to configure a vEthernet interface for use as an access interface.
switch# configure terminal switch(config)# port-profile type vethernet mgmt-access switch(config-port-prof)# switchport mode access switch(config-port-prof)# switchport access vlan 72 switch(config-port-prof)# no shutdown switch(config-port-prof)# state enabled switch(config-port-prof)# system vlan 72 switch(config-port-prof)# publish port-profile mgmt-access switch(config-port-prof)#
You can use this procedure to enable or disable a vEthernet interface.
You are logged in to the CLI in EXEC mode.
Command or Action | Purpose | |
---|---|---|
Step 1 | switch# configure terminal | Enters global configuration mode. |
Step 2 | switch(config)# interface vethernet interface-number | Enters the interface configuration mode for the specified vEthernet interface (from 1 to 1048575). |
Step 3 | switch(config-if)# [no] shutdown | Enables or disables the vEthernet interface in the running configuration: |
Step 4 | switch(config-if)# show interface | (Optional) Displays the interface status and information. |
Step 5 | switch(config-if)# copy running-config startup-config | (Optional) Saves the change persistently through reboots and restarts by copying the running configuration to the startup configuration. |
The following example shows how to enable a vEthernet interface:
switch# configure terminal switch(config)# interface vethernet 100 switch(config-if)# no shutdown switch(config-if)# show interface veth100 status
Use one of the following commands to verify the configuration:
Command | Purpose | ||
---|---|---|---|
show interface vethernet interface-number [brief | counters [detailed [all] | errors] | description | mac-address | status [ down | err-disabled | inactive | module num | up ] | switchport] |
Displays the vEthernet interface configuration. |
||
show interface [ vethernet interface-number ] |
Displays the complete interface configuration. |
||
show interface [ vethernet interface-number ] brief |
Displays abbreviated interface configuration. |
||
show interface [ vethernet interface-number ] description |
Displays the interface description. |
||
show interface [ vethernet interface-number ] mac-address |
Displays the interface MAC address.
|
||
show interface [vethernet interface-number] status [ down | err-disabled | inactive | module num | up ] |
Displays interface line status. |
||
show interface [vethernet interface-number] switchport |
Displays interface switchport information. |
||
show interface virtual [ vm [vm_name] ] [ module mod_no ] |
Displays virtual interfaces only. |
||
show interface virtual port-mapping [ vm [name] | vmk | vswif | description ] [ module_num ] |
Displays mappings between veth and VMware DVPort. |
||
show interface virtual attach binding |
Displays the hypervisor ports bound to the vEthernet. |
||
show interface virtual attach binding detail |
Displays the UUID of the Distributed Virtual Switch if available. |
||
show interface virtual attach connectee device |
Displays the name of the device connected to the vEthernet. |
||
show interface virtual attach connectee id |
Displays the ID of the port connected to the vEthernet. |
||
show interface virtual attach connectee name |
Displays the name of the entity (such as VM) connected to the vEthernet. |
||
show interface virtual attach connectee status |
Displays the attach status of the vEthernet and the port profile in use. |
||
show interface virtual vem-info |
Displays the VEM specific info for the vEthernet. |
Use one of the following commands to monitor the vEthernet interface configuration:
Command | Purpose | ||
---|---|---|---|
show interface [vethernet interface-number] counters |
Displays the interface incoming and outgoing counters. |
||
show interface [ vethernet interface-number] counters detailed [all] |
Displays detailed information for all counters.
|
||
show interface [vethernet interface-number] counters errors |
Displays the interface error counters. |
Feature Name |
Releases |
Feature Information |
---|---|---|
vEthernet interface parameters |
Release 5.2(1)IC1(1.1) |
This feature was introduced |