Configure a Virtual Service

About this task

Perform this procedure to configure a virtual service on the switch.

Note

Note

  • Following procedure lists the general sequence to configure a virtual service.

  • The names of Ethernet ports appearing in a specific Virtual Machine (VM) are not correlated to the configured virtual port names. Each VM renames the Ethernet ports as per its requirements, after they are discovered during the VM initialization.

  • By default, all virtual ports of OVS connection type appear first in the alphabetical order of their configured names, followed by the virtual ports of SR-IOV and VT-d connection types.

Before you begin

  • You must enable trunking on the Extreme Integrated Application Hosting (IAH) port when you use SR-IOV and OVS connection types. For more information about enabling trunking, see MultiLink Trunking and Split MultiLink Trunking.

  • Ensure the switch has the Ethernet drivers installed as per the SR-IOV standard, to support the VT-d and the SR-IOV connection type for the configured virtual ports.

Procedure

  1. Enter Global Configuration mode:

    enable

    configure terminal

  2. Create a VLAN:
    Note

    Note

    Virtual service configuration supports port-based VLANs only.

    vlan create <2-4059> name WORD<0-64> type {port-mstprstp <0-63>} [color <0-32>]

  3. Add the IAH and faceplate port to the VLAN:

    vlan members add <1-4059> {slot/port[/sub-port][-slot/port[/sub-port]][,...]}

  4. Enter GigabitEthernet Interface Configuration mode:

    interface GigabitEthernet {slot/port[/sub-port][-slot/port[/sub-port]][,...]}

    Note

    Note

    If the platform supports channelization and the port is channelized, you must also specify the sub-port in the format slot/port/sub-port.

  5. Enable the IAH and faceplate ports:

    no shutdown

  6. Exit to Global Configuration mode:

    exit

  7. Optional: Create a virtual service:

    virtual-service WORD<1-80>

  8. Optional: Configure the number of CPU cores to be assigned to the virtual service created:

    virtual-service WORD<1-80> num-cores <1-6>

  9. Optional: Configure the memory size to be assigned to the virtual service created:

    virtual-service WORD<1-80> mem-size <1-50000>

  10. Optional: Configure the disk to be assigned to the virtual service created:

    virtual-service WORD<1-80> disk WORD<1-32> size <1-30>

  11. Configure the virtual port connection type:
    Note

    Note

    Ensure the connection type you configure for the virtual port matches the connection type supported by the IAH port.

    virtual-service WORD<1-80> vport WORD<1-32> connect-type {ovs | sriov | vtd}

  12. Configure the IAH port to associate with the connection type:

    virtual-service WORD<1-80> vport WORD<1-32> port WORD<1-32>

    Important

    Important

    You cannot configure two virtual services with conflicting connect types on the same IAH port. You cannot configure two virtual services with VT-d connect type on the same IAH port.

  13. Configure the NIC type of the IAH port:

    virtual-service WORD<1-80> vport WORD<1-32> port WORD<1-32> nic-type {virtio | e1000}

  14. Add the virtual port to the VLAN created:

    virtual-service WORD<1-80> vport WORD<1-32> vlan <1-4096>

  15. Enable the virtual service:

    virtual-service WORD<1-80> enable

Example

Configuring the TPVM virtual service using IAH port 1/s1 with an SR-IOV connection type:

Switch:1>enable
Switch:1#configure terminal
Switch:1(config)#interface GigabitEthernet 1/s1
Switch:1(config-if)#encapsulation dot1q
Switch:1(config-if)#exit
Switch:1(config)#vlan create 10 name tpvm-lan-vlan type port-mstprstp 0 
Switch:1(config)#vlan members add 10 1/s1,1/6/2
Switch:1(config)#interface GigabitEthernet 1/s1,1/6/2
Switch:1(config-if)#no shutdown 
Switch:1(config-if)#exit
Switch:1(config)#virtual-service tpvm vport eth0 connect-type sriov
Switch:1(config)#virtual-service tpvm vport eth0 vlan 10
Switch:1(config)#virtual-service tpvm enable

Configuring the TPVM virtual service on IAH port 1/s2 with a VT-d connection type:

Switch:1>enable
Switch:1#configure terminal
Switch:1(config)#vlan create 10 type port-mstprstp 0 
Switch:1(config)#vlan member add 10 1/1,1/s2 
Switch:1(config)#interface GigabitEthernet 1/s2,1/1 
Switch:1(config-if)#no shutdown
Switch:1(config-if)#exit
Switch:1(config-if)virtual-service tpvm vport eth0 port 1/s2
Switch:1(config)#virtual-service tpvm enable

Variable Definitions

The following table defines parameters for the vlan create command.

Variable

Value

<2-4059>

Specifies the VLAN ID in the range of 2 to 4059. VLAN ID 1 is the default VLAN and you cannot create or delete VLAN ID 1. By default, the system reserves VLAN IDs 4060 to 4094 for internal use. On switches that support the vrf-scaling and spbm-config-mode boot configuration flags, if you enable these flags, the system also reserves VLAN IDs 3500 to 3998.

color<0–32>

Specifies the color of the VLAN.

nameWORD<0-64>

Specifies a name for the VLAN to be created.

type {port-mstprstp<0-63>}

Creates a VLAN by port, with the STP instance ID ranging from 0 to 63.

Note:

MSTI instance 62 is reserved for SPBM if SPBM is enabled on the switch.

The following table defines parameters for the vlan members command.

Variable

Value

<1-4059>

Specifies the VLAN ID in the range of 1 to 4059. By default, VLAN IDs 1 to 4059 are configurable and the system reserves VLAN IDs 4060 to 4094 for internal use. On switches that support the vrf-scaling and spbm-config-mode boot configuration flags, if you enable these flags, the system also reserves VLAN IDs 3500 to 3998. VLAN ID 1 is the default VLAN and you cannot create or delete VLAN ID 1.

{slot/port[/sub-port][-slot/port[/sub-port]][,...]}

Identifies the slot and port in one of the following formats: a single slot and port (slot/port), a range of slots and ports (slot/port-slot/port), or a series of slots and ports (slot/port,slot/port,slot/port). If the platform supports channelization and the port is channelized, you must also specify the sub-port in the format slot/port/sub-port.

add

Adds ports to a specified VLAN ID.

The following table defines parameters for the virtual-service command.

Variable

Value

WORD<1-80>

Specifies a name for virtual service.

connect-type {ovs | sriov | vtd}

Specifies the connection type for the virtual port created. The default is VT-d. The switch supports the following maximums for virtual ports:

  • OVS - 16

  • SR-IOV - 16

  • VT-d - 2

disk WORD<1-32>

Specifies the disk assigned to the virtual service.

mem-size <1-50000>

Specifies the memory size in Megabytes assigned to the virtual service. The default value is 1024 Megabytes.

nic-type [virtio | e1000]

Specifies the Virtual Port NIC type. The default is e1000.

Note:

Configure this value only when the connect-type parameter is ovs.

num-cores <1-6>

Specifies the number of cores assigned to the virtual service. The default value is 1.

port WORD<1-32>

Specifies the name of the Extreme Integrated Application Hosting (IAH) port associated with the virtual port. Depending on the hardware, the switch can support the following IAH ports:
  • 1/s1

  • 1/s2

size <1-30>

Specifies the size of the disk in Gigabytes.

vlan <1–4096>

Specifies the VLAN ID used by the virtual port.

vport WORD<1-32>

Specifies the name of the virtual port.