Product Documentation

Configuring NetScaler Virtual Appliances to use Single Root I/O Virtualization (SR-IOV) Network Interface

Apr 24, 2017

After you have installed and configured the NetScaler virtual appliance on VMware ESX, you can use the VMware vSphere web client to configure the virtual appliance to use SR-IOV network interfaces.

Limitations

A NetScaler VPX configured with SR-IOV network interface has the following limitations:

  • The following features are not supported on SR-IOV interfaces using Intel 82599 10G NIC on ESX VPX:
         - L2 mode switching      - Static Link Aggregation and LACP      - Clustering      - Admin partitioning [Shared VLAN mode]      - High Availability [Active - Active mode]      - Jumbo frames      - IPv6 
  • The following features are not supported for on SR-IOV interface with an Intel 82599 10G NIC on KVM VPX:
         - Static Link Aggregation and LACP      - L2 mode switching      - Clustering      - Admin partitioning [Shared VLAN mode]      - High Availability [Active – Active mode]      - Jumbo frames      - IPv6      - VLAN configuration on Hypervisor for SR-IOV VF interface through “ip link” command is not supported

Prerequisite

Make sure that you:

- Add the Intel 82599 Network Interface Card (NIC) to the ESX Host.

- Enable SR-IOV on the host physical adapter, as follows:

     1. In the vSphere Web Client, navigate to the Host.

     2. On the Manage > Networking tab, select Physical adapters. The SR-IOV Status field shows whether a physical adapter supports SR-IOV.

localized image

     3. Select the physical adapter, and then click the pencil icon to open the Edit Settings dialog box.

localized image

     4. Under SR-IOV, select Enabled from the Status drop-down list.

localized image

     5. In the Number of virtual functions field, enter the number of virtual functions that you want to configure for the adapter.

localized image

     6. Click OK.      7. Restart the host.

- Create a Distributed Virtual Switch (DVS) and Portgroups. For instructions, see the VMware Documentation.

Note

Citrix has qualified the SR-IOV configuration on DVS and Portgroups only.

To configure NetScaler Virtual Appliances to use SR-IOV network interface by using VMware vSphere Web Client:

     1. In the vSphere Web Client, select Hosts and Clusters.

     2. Upgrade the Compatibility setting of the NetScaler virtual machine to ESX 5.5 or later, as follows:

          a. Power off the NetScaler virtual machine.

          b. Right-click the NetScaler virtual machine and select Compatibility > Upgrade VM Compatibility.

          c. In the Configure VM Compatibility dialog box, select ESXi 5.5 and later from the Compatible with drop-down list and click OK.

localized image

     3. Right-click on the NetScaler virtual appliance and click Edit Settings.

localized image

     4. In the <virtual_appliance> - Edit Settings dialog box, click the CPU section.

localized image

     5. In the CPU section, update the following settings:

          - Number of CPUs

          - Number of Sockets

          - Reservations

          - Limit

          - Shares

        Set the values as follows:

          a. In the CPU drop-down list, select the number of CPUs to assign to the virtual appliance.

          b. In the Cores per Socket drop-down list, select the number of sockets.

          c. (Optional) In the CPU Hot Plug field, select or clear the Enable CPU Hot Add check box.

              Note: Citrix recommends accepting the default (disabled).

          d. In the Reservation drop-down list, select the number that is shown as the maximum value.

localized image

          e. In the Limit drop-down list, select the number that is shown as the maximum value.

localized image

          f. In the Shares drop-down lists, select Custom and the number that is shown as the maximum value.

localized image

     6. In the Memory section, update the following settings:

          - Size of RAM

          - Reservations

          - Limit

          - Shares

      Set the values as follows:

          a. In the RAM drop-down list, select the size of the RAM. It should be number of vCPUs x 2 GB. For example, if the number of vCPU is 4 then RAM = 4 x 2 GB = 8 GB.

              Note: For Enterprise or Platinum edition of the NetScaler VPX appliance, make sure that you allocate 4 GB of RAM to each vCPU. For example, if the number of vCPU is 4 then RAM = 4 x 4 GB = 16 GB.

localized image

          b. In the Reservation drop-down list, enter the value for the memory reservation, and select the Reserve all guest memory (All locked) check box.  The memory reservation should be number of vCPUs x 2 GB. For example, if the number of vCPUs is 4, the memory reservation should be 4 x 2 GB = 8 GB.               Note: For Enterprise or Platinum edition of the NetScaler VPX appliance, make sure that you allocate 4 GB of RAM to each vCPU. For example, if the number of vCPU is 4 then RAM = 4 x 4 GB = 16 GB.

localized image

          c. In the Limit drop-down list, select the number that is shown as the maximum value.

localized image

          d. In the Shares drop-down lists, select Custom, and select the number that is shown as the maximum value.

localized image

     7. Add a SR-IOV network interface. From the New device drop-down list, select Network and click Add.

localized image

     8. In the New Network section. From the drop-down list, select the Portgroup that you created, and do the following:           a. In the Adapter Type drop-down list, select SR-IOV passthrough.

localized image

          b. In the Physical function drop-down list, select the physical adapter mapped with the Portgroup.

localized image

          c. In the Guest OS MTU Change drop-down list, select Disallow.

     9. In the <virtual_appliance> - Edit Settings dialog box, click the VM Options tab.

    10. On the VM Options tab, select the Advanced section. From the Latency Sensitivity drop-down list, select High.

localized image

    11. Click OK.

    12. Power on the NetScaler virtual appliance.

    13. Once the NetScaler virtual appliance powers on, you can use the following command to verify the configuration:

> show interface summary

The output should show all the interfaces that you configured:

> show interface summary
--------------------------------------------------------------------------------
      Interface  MTU        MAC                  Suffix
--------------------------------------------------------------------------------
1     0/1        1500       00:0c:29:1b:81:0b    NetScaler Virtual Interface
2     10/1       1500       00:50:56:9f:0c:6f    Intel 82599 10G VF Interface
3     10/2       1500       00:50:56:9f:5c:1e    Intel 82599 10G VF Interface
4     10/3       1500       00:50:56:9f:02:1b    Intel 82599 10G VF Interface
5     10/4       1500       00:50:56:9f:5a:1d    Intel 82599 10G VF Interface
6     10/5       1500       00:50:56:9f:4e:0b    Intel 82599 10G VF Interface
7     LO/1       1500       00:0c:29:1b:81:0b    Netscaler Loopback interface
 Done
> show inter 10/1
1)      Interface 10/1 (Intel 82599 10G VF Interface) #1
        flags=0xe460 <ENABLED, UP, UP, HAMON, 802.1q>
        MTU=1500, native vlan=55, MAC=00:50:56:9f:0c:6f, uptime 0h21m53s
        Actual: media FIBER, speed 10000, duplex FULL, fctl NONE, throughput 10000
        LLDP Mode: NONE,                 LR Priority: 1024
 
        RX: Pkts(838020742) Bytes(860888485431) Errs(0) Drops(2527) Stalls(0)
        TX: Pkts(838149954) Bytes(860895860507) Errs(0) Drops(0) Stalls(0)
        NIC: InDisc(0) OutDisc(0) Fctls(0) Stalls(0) Hangs(0) Muted(0)
        Bandwidth thresholds are not set.
 Done