ADC

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

August 20, 2024

Contributed by:

C C

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]
High Availability [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.conf file:
blacklist ixgbevf
Enable SR-IOV Virtual Functions (VFs) by adding the following entry to the /etc/modprobe.d/ixgbe file:
options ixgbe max_vfs=<number_of_VFs> where <number_VFs> is 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=<Xen host UUID> fn=assign_free_vf args:uuid=<Netscalar VM UUID> args:ethdev=<interface name> args:mac=<mac addr>

Where:

• <Xen host UUID> is the UUID of the Citrix Hypervisor host.

• <Netscalar VM UUID> is the UUID of the Citrix ADC VPX instance.

• <interface name> is the interface for the SR-IOV VFs.

• <mac addr > 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=iovirt host-uuid=<Xen_host_UUID> fn=unassign_all args:uuid=<Netscalar_VM_UUID>

Where:

• <Xen_host_UUID> - The UUID of the Citrix Hypervisor host.

• <Netscalar_VM_UUID> - The UUID of the Citrix ADC VPX instance

2. Boot the Citrix ADC VPX instance.

Configure link aggregation on the SR-IOV interface

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 set <interface_name> vf <VF_id> spoofchk off

Where:

<interface_name> is the interface name.
<VF_id> 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, see Configure 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, see Configuring a VLAN.

Important

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

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

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

August 20, 2024

Contributed by:

C C

August 20, 2024

Contributed by:

C C

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

Limitations

Prerequisites

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

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

Configure link aggregation on the SR-IOV interface

Configure VLAN on the SR-IOV interface

In this article