Product Documentation
ADC
Current Release 13.1 13.0 12.1
View PDF

Configure VPX instances to use single root I/O virtualization (SR-IOV) network interfaces

December 13, 2022
Contributed by:
C S

After you have installed and configured a Citrix ADC VPX instance on Citrix Hypervisor, you can configure the virtual appliance to use SR-IOV network interfaces.

Limitations

Citrix Hypervisor does not support the following features on SRIOV interfaces:

  • L2 mode switching
  • Clustering
  • Admin partitioning [Shared VLAN mode]
  • 高可用性[Active - Active mode]
  • Jumbo frames
  • IPv6 protocol in Cluster environment

Prerequisites

On the Citrix Hypervisor host, ensure that you:

  • Add the Intel 82599 Network Interface Card (NIC) to the host.
  • Blacklist the ixgbevf driver by adding the following entry to the/etc/modprobe.d/blacklist.conffile:
    blacklist ixgbevf
  • Enable SR-IOV Virtual Functions (VFs) by adding the following entry to the/etc/modprobe.d/ixgbefile:
    options ixgbe max_vfs=whereis the number of SR-IOV VFs that you want to create.
  • Verify that SR-IOV is enabled in BIOS.

Note:

IXGBE driver version 3.22.3 is recommended.

Assign SR-IOV VFs to the VPX instance by using the Citrix Hypervisor host

To assign SR-IOV network interfaces to Citrix ADC VPX instance, follow these steps:

1. On the Citrix Hypervisor host, use the following command to assign the SR-IOV VFs to the Citrix ADC VPX instance:

xe host-call-plugin plugin=iovirt host-uuid=fn=assign_free_vf args:uuid=args:ethdev=args:mac=

Where:

•is the UUID of the Citrix Hypervisor host.

•is the UUID of the Citrix ADC VPX instance.

•is the interface for the SR-IOV VFs.

•is the mac address of the SR-IOV VF.

Note

Specify the mac address that you want use in the args:mac= parameter, if not specified, the iovirt script randomly generates and assigns a mac address. Also, if you want use the SR-IOV VFs in Link Aggregation mode, make sure that you specify the mac address as 00:00:00:00:00:00.

2. Boot the Citrix ADC VPX instance.

Unassign SR-IOV VFs to the VPX instance by using the Citrix Hypervisor host

If you have assigned an incorrect SR-IOV VFs or if you want modify the a assigned SR-IOV VFs, you need to unassign and reassign the SR-IOV VFs to the Citrix ADC VPX instance.

To unassign SR-IOV network interface assigned to a Citrix ADC VPX instance, follow these steps:

1. On the Citrix Hypervisor host, use the following command to assign the SR-IOV VFs to the Citrix ADC VPX instance and reboot the Citrix ADC VPX instance:

xe host-call-plugin plugin=iovirthost-uuid=fn=unassign_allargs:uuid=

Where:

•- The UUID of the Citrix Hypervisor host.

•- The UUID of the Citrix ADC VPX instance

2. Boot the Citrix ADC VPX instance.

To use the SR-IOV virtual functions in link aggregation mode, you need to disable spoof checking for virtual functions that you have created. On the Citrix Hypervisor host, use the following command to disable spoof checking:

ip link setvfspoofchkoff

Where:

  • is the interface name.
  • is the virtual function ID.

After disabling spoof checking for all the virtual functions that you have created, restart the Citrix ADC VPX instance and configure link aggregation. For instructions, seeConfigure link aggregation.

Important

While you are assigning the SR-IOV VFs to the Citrix ADC VPX instance, make sure that you specify MAC address 00:00:00:00:00:00 for the VFs.

Configure VLAN on the SR-IOV interface

You can configure VLAN on the SR-IOV Virtual Functions, for instructions, seeConfiguring a VLAN.

Important

Make sure that the Citrix Hypervisor host does not contain VLAN settings for the VF interface.

Configure VPX instances to use single root I/O virtualization (SR-IOV) network interfaces
December 13, 2022
Contributed by:
C S
December 13, 2022
Contributed by:
C S

In this article

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