Intel® Ethernet Controller E810 Application Device Queues (ADQ)

Configuration Guide

ID 609008
Date 04/03/2023
Version 2.8
Document Table of Contents

General SUT Configuration for VFs

This section describes general System Under Test (SUT) configuration for either a bare metal VF environment, or for running a VF inside a Virtual Machine (VM) on the SUT.

  1. Enable virtualization in the BIOS on the SUT. The following BIOS settings must be turned on to enable virtualization capability. These settings vary based on the platform, however most Intel BIOS should have similar settings. [BIOS::Advanced::Processor Configuration] Intel(R) Virtualization Technology=Enabled [BIOS::Advanced::Integrated IO Configuration] Intel(R) VT for Directed I/O=Enabled [BIOS::Advanced::Integrated IO Configuration] SR-IOV Support=Enabled
  2. Perform general system OS install and setup. Complete the ADQ install and setup in ADQ System Under Test (SUT) Installation and General System Tuning. Note:Many settings in Section 5.0 do not persist between reboots and might need to be reapplied. Note:The OS install and setup steps on the SUT are only needed when spawning VFs on the local host. If using VFs inside a Virtual Machine (VM), the OS is installed and configured inside the VM's guest OS and this step can be skipped on the host OS.
  3. Compile and install the iavf driver:
    1. Download theiavf driver and untar: tar -xzvf iavf-${vfdriverver}.tar.gz cd iavf-${vfdriverver}/src
    2. Compile and install the iavf driver: make -j$(nproc) install
    3. Load iavf driver: modprobe iavf
    Note:The iavf driver only needs to be compiled and installed on the SUT when spawning VFs on the local host. If using a VM, iavf is compiled and installed on the VM's guest OS and this step can be skipped on the host OS.
  4. Enable Intel® IOMMU kernel boot parameters. To enable full virtualization in the kernel, add intel_​iommu=on and iommu=pt to the kernel boot parameters, regenerate GRUB configuration, and reboot the host.

    Use Linux admin tools such as grubby or grub2-editenv to set the kernel parameters and reboot. For example:

    grubby --args="intel_iommu=on iommu=pt" --update-kernel=DEFAULT reboot

    or

    grub2-editenv - set "$(grub2-editenv - list | grep kernelopts) intel_iommu=on \ iommu=pt" reboot

    If grubby and grub2-editenv are not available on your system, you can alternatively append intel_​iommu=on iommu=pt to GRUB_​CMDLINE_​LINUX line in /etc/default/grub, followed by grub2-mkconfig -o /boot/grub2/grub.cfg and reboot.

    The iommu kernel parameters can be verified after reboot using cat /proc/cmdline.

  5. Depending on your VF environment, follow either SUT Configuration Bare Metal VF or SUT Configuration VF Inside a VM.