Updating Settings Required For Vfs; Configuring The Vf Port On The Host - Intel D5005 Quick Start Manual

7. Running the OPAE in a Virtualized Environment
UG-20202 | 2019.08.05

7.1. Updating Settings Required for VFs

To use SR-IOV and pass a VF to a virtual machine, you must enable the Intel IOMMU
driver on the host. Complete the following steps to enable the Intel IOMMU driver:
1. Add
intel_iommu=on
configuration file.
2. GRUB reads its configuration from either the
traditional BIOS-based machines or from the
grub.cfg
instructions below:
•
BIOS based machine:
•
UEFI based machine:
grub.cfg
3. Restart to apply the new GRUB configuration file.
4. To verify the GRUB update, run the following command:
cat /proc/cmdline
The sample output below shows
Sample output:
BOOT_IMAGE=/vmlinuz-3.10.0-514.21.1.el7.x86_64
root=/dev/mapper/cl_<server_name>-root ro intel_iommu=on
crashkernel=auto rd.lvm.lv=cl_<server_name>/root
rd.lvm.lv=cl_<server_name>/swap rhgb quiet

7.2. Configuring the VF Port on the Host

By default, the PF controls the AFU port. The following procedure transfers AFU control
to the VF. After the transfer to VF control, applications running on the VM can access
the AFU.
In a multi-card system, if you want to configure the VF on only a single PCIe device,
run below command to find the device mapping for the specific PCIe:
ls -l /sys/class/fpga/intel-fpga-dev.*
Sample output:
/sys/class/fpga/intel-fpga-dev.0 -> ../../devices/
pci0000:36/0000:36:00.0/0000:37:00.0/fpga/intel-fpga-dev.0
/sys/class/fpga/intel-fpga-dev.1 -> ../../devices/pci0000:ae/
0000:ae:00.0/0000:af:00.0/fpga/intel-fpga-dev.1
To target PCIe
commands, use instance id 1 and 0 instead of * respectively.
1. Run the following commands to export the required paths:
export port_path=$(find /sys/class/fpga/intel-fpga-dev.* \
-maxdepth 1 -follow -iname intel-fpga-port.*)
export link_path=$(readlink -m /$port_path/../)
export pci_path=$link_path/../../
Send Feedback
to the
GRUB_CMDLINE_LINUX
file on UEFI machines. Depending on your system, execute one of the
grub2-mkconfig -o /boot/grub2/grub.cfg
grub2-mkconfig -o /boot/efi/EFI/redhat/
intel_iommu=on
and
B:D.F (AF:00.0)
Intel Acceleration Stack Quick Start Guide: Intel FPGA Programmable
entry by updating the GRUB
/boot/grub2/grub.cfg
/boot/efi/EFI/redhat/
on the kernel command line.
in the following
B:D.F (37:00.0)
file on
Acceleration Card D5005
21