Product Documentation
ADC
14.1 - Current Release 13.1 13.0 12.1
View PDF

Configure a Citrix ADC VPX instance to use SR-IOV network interfaces

August 20, 2024
Contributed by: 
C C S

You can configure a Citrix ADC VPX instance running on Linux-KVM platform using single root I/O virtualization (SR-IOV) with the following NICs:

  • Intel 82599 10G
  • Intel X710 10G
  • Intel XL710 40G
  • Intel X722 10G

This section describes how to:

  • Configure a Citrix ADC VPX Instance to Use SR-IOV Network Interface
  • Configure Static LA/LACP on the SR-IOV Interface
  • Configure VLAN on the SR-IOV Interface

Limitations

Keep the limitations in mind while using Intel 82599, X710, XL710, and X722 NICs. The following features not supported.

Limitations for Intel 82599 NIC:

  • L2 mode switching.
  • Admin partitioning (shared VLAN mode).
  • High availability (active-active mode).
  • Jumbo frames.
  • IPv6: You can configure only up to 30 unique IPv6 addresses in a VPX instance if you’ve at least one SR-IOV interface.
  • VLAN configuration on Hypervisor for SRIOV VF interface through “ip link” command is not supported.
  • Interface parameter configurations such as speed, duplex, and autonegotiations are not supported.

Limitations for Intel X710 10G, Intel XL710 40G, and Intel X722 10G NICs:

  • L2 mode switching.
  • Admin partitioning (shared VLAN mode).
  • In a cluster, Jumbo frames are not supported when the XL710 NIC is used as a data interface.
  • Interface list reorders when interfaces are disconnected and reconnected.
  • Interface parameter configurations such as speed, duplex, and auto negotiations are not supported.
  • Interface name is 40/X for Intel X710 10G, Intel XL710 40G, and Intel X722 10G NICs
  • Up to 16 Intel XL710/X710/X722 SRIOV or PCI passthrough interfaces can be supported on a VPX instance.

Note: For Intel X710 10G, Intel XL710 40G, and Intel X722 10G NICs to support IPv6, you need to enable trust mode on the Virtual Functions (VFs) by typing the following command on the KVM host:

# ip link set <PNIC> <VF> trust on

Example:

# ip link set ens785f1 vf 0 trust on

Prerequisites

Before you configure a Citrix ADC VPX instance to use SR-IOV network interfaces, complete the following prerequisite tasks. See the NIC column for details about how to complete the corresponding tasks.

Task Intel 82599 NIC Intel X710, XL710, and X722 NICs
  1. Add the NIC to the KVM host.
 - -
  1. Download and install the latest Intel driver.
 IXGBE driver I40E driver
  1. Blacklist the driver on the KVM host.
 Add the following entry in the /etc/modprobe.d/blacklist.conf file: blacklist ixgbevf. Use IXGBE driver version 4.3.15 (recommended). Add the following entry in the /etc/modprobe.d/blacklist.conf file: blacklist i40evf.Use i40e driver version 2.0.26 (recommended).
4.Enable SR-IOV Virtual Functions (VFs) on the KVM host. In both the commands in the next two columns: number_of_VFs =the number of Virtual VFs that you want to create. device_name =the interface name. If you are using earlier version of kernel 3.8, then add the following entry to the /etc/modprobe.d/ixgbe file and restart the KVM host: *options ixgbe max_vfs=*.If you are using kernel 3.8 version or later, create VFs using the following command: *echo > /sys/class/net//device/sriov_numvfs*. See example in figure 1. If you are using earlier version of kernel 3.8, then add the following entry to the /etc/modprobe.d/i40e.conf file and restart the KVM host:*options i40e max_vfs=*.If you are using kernel 3.8 version or later, create VFs using the following command: *echo > /sys/class/net//device/sriov_numvfs*.See example in figure 2.
  1. Make the VFs persistent by adding the commands that you used to create VFs, to the rc.local file.
 See example in figure 3. See example in figure 3.

Important

When you create the SR-IOV VFs, ensure that you do not assign MAC addresses to the VFs.

Figure 1: Enable SR-IOV VFs on the KVM host for Intel 82599 10G NIC.

SR-IOV VF for 82599

Figure 2: Enable SR-IOV VFs on the KVM host for Intel X710 10G and XL710 40G NICs.

SR-IOV VF for X710

Figure 3: Enable SR-IOV VFs on the KVM host for Intel X722 10G NIC.

SR-IOV VF for X722

Figure 4: Make the VFs persistent.

localized image

Configure a Citrix ADC VPX instance to use SR-IOV network interface

To configure Citrix ADC VPX instance to use SR-IOV network interface by using Virtual Machine Manager, complete these steps:

  1. Power off the Citrix ADC VPX instance.

  2. Select the Citrix ADC VPX instance and then select Open.

    localized image

  3. In the <virtual_machine on KVM> window, select the i icon.

    localized image

  4. Select Add Hardware.

    localized image

  5. In the Add New Virtual Hardware dialog box, do the following:

    1. Select PCI Host Device.
    2. In the Host Device section, select the VF you have created and click Finish.

    Figure 4: VF for Intel 82599 10G NIC

    VF for Intel 82599 10G NIC

    Figure 5: VF for Intel XL710 40G NIC

    VF for Intel XL710 40G NIC

    Figure 6: VF for Intel X722 10G NIC

    VF for Intel X722 10G NIC

  6. Repeat Step 4 and 5 to add the VFs that you have created.
  7. Power on the Citrix ADC VPX instance.

  8. After the Citrix ADC VPX instance powers on, use the following command to verify the configuration:

    show interface summary
<!--NeedCopy-->

    The output shows all the interfaces that you configured.

    Figure 6: output summary for Intel 82599 NIC.

    Output summary for Intel 82599 NIC

    Figure 7. Output summary for Intel X710 and XL710 NICs.

    Output summary for Intel X710 and XL710 NICs

Configure static LA/LACP on the SR-IOV interface

Important

When you are creating the SR-IOV VFs, ensure that you do not assign MAC addresses to the VFs.

To use the SR-IOV VFs in link aggregation mode, disable spoof checking for VFs that you have created. On the KVM host, use the following command to disable spoof checking:

*ip link set \<interface\_name\> vf \<VF\_id\> spoofchk off*

Where:

  • Interface_name – is the interface name.
  • VF_id – is the Virtual Function id.

Example:

Disable spoof checking

After you disable spoof checking for all the VFs that you have created. Restart the Citrix ADC VPX instance and configure link aggregation. For detailed instructions, see Configuring Link Aggregation.

Configuring VLAN on the SR-IOV Interface

You can configure VLAN on SR-IOV VFs. For detailed instructions, see Configuring a VLAN.

Important

Ensure that the KVM host does not contain VLAN settings for the VF interface.

Configure a Citrix ADC VPX instance to use SR-IOV network interfaces
August 20, 2024
Contributed by: 
C C S
August 20, 2024
Contributed by: 
C C S

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.