x
/
fuel-plugin-contrail
Code Issues Proposed changes
fuel-plugin-contrail/doc/source/dpdk_on_vf.rst

1.7 KiB
Raw Blame History

DPDK-based vRouter on virtual function (VF)

Description

This guide describes how to run DPDK-based vRouter on virtual functions (VF). DPDK on VF depends on /enable_sriov and /dpdk features. This feature shares a physical interface for DPDK and SR-IOV usage.

Prerequisites

  • Installed Fuel 9.1
  • Installed Fuel Contrail Plugin /install_guide
  • Environment must be created with "KVM" for compute virtualization and "Contrail" for networking
  • Network card must support DPDK. List of compatible adapters can be found on DPDK website
  • Network card must support SRIOV.

How to enable DPDK on VF

  1. Enable DPDK feature /dpdk.

  2. Enable DPDK on VF in Fuel UI settings:

    image

  3. Assign Compute, DPDK, and DPDK-on-VF roles to the host where you want to enable DPDK on VF feature:

    image

  4. Add intel_iommu=on iommu=pt to kernel parameters:

    image

  5. Deploy environment

If DPDK on VF is enabled in plugin settings, it will be deployed on computes with DPDK and DPDK-on-VF roles. During deploy following configurations will be made on compute nodes with DPDK and SR-IOV roles:

  1. Virtual functions will be allocated on private interface.
  2. First VF will be used for DPDK-based vRouter.
  3. Rest of the VFs will be added to pci_passthrough_whitelist setting in nova.conf for SR-IOV usage.