--- title: "Install and configure OVS with DPDK on the host machine" slug: "install-and-configure-ovs-with-dpdk-on-the-host-machine-1" tags: ["Product Usage", "vIPS 11.1x", "vIPS"] updated: 2026-09-11T20:53:15Z published: 2026-09-11T20:53:15Z canonical: "docs.trellix.com/install-and-configure-ovs-with-dpdk-on-the-host-machine-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Install and configure OVS with DPDK on the host machine This section covers the steps for installing and configuring OVS with DPDK on a host machine with CentOS. These steps are required to attain maximum performance on vIPS Sensors deployed in KVM. This section covers configuration using OVS version 2.12.0 and DPDK version 18.11.2. Users may choose to configure the latest versions. However, steps might vary during OVS with DPDK configuration. ****Prerequisite:**** Make sure that you have enabled Virtualization in BIOS. ****Steps:**** 1. ****Install OVS with DPDK on CentOS**** Open a terminal in CentOS and execute the following commands to install OVS with DPDK: ``` sudo yum install -y epel-release centos-release-openstack-train sudo yum install openvswitch libibverbs sudo yum install dpdk-tools ``` 2. ****Enable and start the OVS service**** Upon completing the installation, enable and start the OVS service by executing the following commands: ``` systemctl enable openvswitch systemctl start openvswitch ``` 3. ****Enable Input-Output Memory Management Unit (IOMMU) or passthrough**** The IOMMU kernel parameter is enabled by editing the Grub config file - ****/etc/default/grub**** using a text editor. Scroll down to the line starting with `GRUB_CMDLINE_LINUX` and add the parameter `intel_iommu=on iommu=pt` at the end of the code. A sample of the updated code can be seen below: ``` GRUB_CMDLINE_LINUX="crashkernel=auto spectre_v2=retpoline rd.lvm.lv= centos/root rd.lvm.lv=centos/swap rhgb quiet intel_iommu=on iommu=pt” ``` 4. Upon saving the file changes, execute the command `grub2-mkconfig -o /etc/grub2-efi.cfg` in case the boot mode configured on your system is Unified Extensible Firmware Interface (UEFI), and `grub2-mkconfig -o /boot/grub2/grub.cfg` in case the boot mode configured on your system is Legacy/Basic Input Output System (BIOS). 5. Upon executing the command, reboot the machine for the changes to apply. 6. ****Create HugePages**** > [!NOTE] > Note > > It is recommended to have 16GB of available hugepages on the machine if you are deploying IPS-VM5000, and 8GB of available hugepages on the machine if you are deploying IPS-VM600. The hugepages can be assigned at bootup by editing `GRUB_CMDLINE_LINUX` in the Grub config file. To set the machine to have 16GB of hugepages, open the Grub config file - ****/etc/default/grub**** using a text editor. Scroll down to the line starting with `GRUB_CMDLINE_LINUX` and add the parameter `default_hugepagesz=1G hugepagesz=1G hugepages=16` before `intel_iommu=on iommu=pt`. A sample of the updated code can be seen below: ``` GRUB_CMDLINE_LINUX="crashkernel=auto spectre_v2=retpoline rd.lvm.lv= centos/root rd.lvm.lv=centos/swap rhgb quiet default_hugepagesz=1G hugepagesz=1G hugepages=16 intel_iommu=on iommu=pt” ``` 7. Upon setting the hugepage size, mount the hugepages by executing the command `mount -t hugetlbfs none /dev/hugepages`. 8. ****Isolate cores for vIPS Sensor deployment**** > [!NOTE] > Note > > You need to isolate CPU cores by dedicating them for DPDK to achieve high-performance packet processing. Number of cores to be isolated depends on the vIPS Sensor model. If you are using IPS-VM600, you need to isolate a minimum of ****4 cores****, while for IPS-VM5000, you need to isolate a minimum of ****12 cores****. To configure this, edit ****/etc/default/grub**** using a text editor. Scroll down to the line starting with `GRUB_CMDLINE_LINUX` and add the parameters `isolcpus`, `nohz_full`, and `rcu_nocbs` at the end of the code. A sample of the updated code can be seen below: ``` GRUB_CMDLINE_LINUX="crashkernel=auto spectre_v2=retpoline rd.lvm.lv= centos/root rd.lvm.lv=centos/swap rhgb quiet default_hugepagesz=1G hugepagesz=1G hugepages=16 intel_iommu=on iommu=pt isolcpus=2,4,6,8,10,12,14,16,18,20,22,24,26,28, 30,32,34,36,38,40,42 nohz_full=2,4,6,8,10,12,14,16,18,20,22,24,26,28,30,32,34,36,38, 40,42 rcu_nocbs=2,4,6,8,10,12,14,16,18,20,22,24,26,28,30,32,34,36,38,40,42" ``` > [!NOTE] > Note > > - For faster communications, it is recommended to reserve cores on the same socket or numa node. > - You may execute the command `numactl -H` to list lcores on the socket(s). 9. ****Bind network devices to dpdk and grant permissions to access dpdk-devices**** > [!NOTE] > Note > > Before using any network device in ovs-dpdk to create virtual networks, you need to bind those network devices or ethernet ports to Virtual Function I/O(VFIO)-Peripheral Component Interconnect (PCI) driver. Load the VFIO-PCI kernel module by executing the command `sudo modprobe vfio-pci`. 10. Check the status of all the attached network devices by executing the command `dpdk-devbind --status`. From the output, find the device ID to which you bind VFIO-PCI. The device ID is in the form of **domain:bus:slot.func**, for example, `0000:19:00.0`. ![GUID-AC5F1765-2A7F-4B58-8AEE-5749A436C019-low.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-6679bfc6-8acf-7551-bf7a-a02d22a7018c.png?sv=2026-02-06&spr=https&st=2026-11-20T08%3A50%3A40Z&se=2026-11-20T09%3A50%3A40Z&sr=c&sp=r&sig=p3AGl6gkbRefSqHuSUXFkb8jo012BYRitEm6MzvANxU%3D) The device IDs are listed in the first column. Pick the device IDs as highlighted in the above image. 11. Bind the devices to VFIO-PCI by issuing the command `dpdk-devbind --bind=vfio-pci <device_ID1> <device_ID2>`. ****Sample command:****` dpdk-devbind --bind=vfio-pci 0000:19:00.0 0000:19:00.1` 12. Upon completing this procedure, grant permissions to access the DPDK devices. It is recommended to assign read-write-execute permissions to the ****vfio**** directory, and read-write permissions to all the files under the ****vfio**** directory. To assign these permissions, execute the following commands: ``` chmod 0777 /dev/vfio chmod 0666 /dev/vfio/* ``` 13. ****Configure ovs-dpdk**** You can configure ovs-dpdk using the `ovs-vsctl` utility. The parameters to be used in the utility are `dpdk-init`, `dpdk-lcore-mask`, `dpdk-socket-mem`, `dpdk-hugepage-dir`, and `pmd-cpu-mask`. Execute the following commands: ``` ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x40000000000 ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-socket-mem=8192,0 ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk- hugepage-dir="/dev/hugepages" ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0x15554000000 ``` > [!NOTE] > Note > > The parameter `dpdk-lcore-mask` is used for the control plane process and `pmd-cpu-mask` is used for data plane process. In the above command, ****0x40000000000**** refers to core ****42**** and ****0x15554000000**** refers to cores ****26,28,30,32,34,36,38,40****. The right-most bit ****0**** in 0x40000000000 and 0x15554000000 refers to core zero. You may set the bitmask values of your choice based on core availability. The dpdk-lcore-mask and pmd-cpu-mask parameters are set with core bitmask. To understand how to set the bitmask value, refer to [Using Open vSwitch with DPDK](https://docs.openvswitch.org/en/latest/howto/dpdk/) or access the ****Open vSwitch manual****/man pages by executing the command `man ovs-vswitchd.conf.db`. 14. For the changes to be applied, restart the OVS service by executing the command `systemctl restart openvswitch`. 15. ****Create virtual networks**** To create virtual networks, you need to create bridges (2), add dpdk ports to the bridges, set the device type and device information, set the number of receive side queues, isolate the CPU core for PMD. The aim is to connect the monitoring ports of the Sensor to the ethernet ports connected to dpdk. Refer to the sample commands provided in ****Step 17**** and ****Step 18**** to understand the commands (covering individual parameters) provided below. To create bridges/virtual switches, execute the commands: ``` ovs-vsctl add-br -- set bridge datapath_type=netdev ovs-vsctl add-br -- set bridge datapath_type=netdev ``` These bridges connect the dpdk devices to the monitoring ports of the Sensor. 16. To add dpdk port to a bridge, execute the command `ovs-vsctl add-port <bridge_name1> <dpdk_device_name>`. 17. To set the device type and the device information, execute the following commands: ``` ovs-vsctl set Interface type=dpdk ovs-vsctl set Interface options:dpdk- devargs='' ``` 18. You need to isolate the CPU cores for the PMD that polls a particular rx queue. To perform this, execute the command `ovs-vsctl set Interface <dpdk_device_name> other_config:pmd-rxq-affinity="<queue_number:CPU_core_number,queue_number:CPU_core_number,..."` > [!NOTE] > Note > > The parameters used in the commands listed under the section ****Create virtual networks**** can be combined to form a single command. A sample command combining all the above parameters is shown below: > > ``` > ovs-vsctl add-port ovsbr1 dpdk1 -- set Interface dpdk1 > type=dpdk options:dpdk-devargs='0000:19:00.0' > options:n_rxq=2 other_config:pmd-rxq-affinity="0:26,1:28" > ``` Where: `ovsbr1` is the name of ****bridge 1**** `dpdk1` is the name of the ****dpdk device 1**** `0000:19:00.0` represents ******** belonging to ****dpdk1**** `0:26,1:28` represent ****queue 0**** is processed by ****CPU core 26**** and ****queue 1**** is processed by ****CPU core 28**** > [!NOTE] > Note > > The above command is applicable if you are deploying IPS-VM5000 Sensors. In case of IPS-VM600 Sensor deployments, you need to assign only one receiver queue and allocate only one core for affinity. Below is a sample command: > > ``` > ovs-vsctl add-port ovsbr1 dpdk1 -- set Interface dpdk1 > type=dpdk options:dpdk-devargs='0000:19:00.0' > options:n_rxq=1 other_config:pmd-rxq-affinity="0:26" > ``` 19. Similarly, follow the above steps to configure bridge 2. A sample command combining all the above parameters is shown below: ``` ovs-vsctl add-port ovsbr2 dpdk2 -- set Interface dpdk2 type=dpdk options:dpdk- devargs='0000:19:00.1' options:n_rxq=2 other_config:pmd-rxq-affinity="0:30,1:32" ``` Where: `ovsbr2` is the name of ****bridge 2**** `dpdk2` is the name of the ****dpdk device 2**** `0000:19:00.1` represents ******** belonging to ****dpdk2**** `0:30,1:32` represent ****queue 0**** is processed by ****CPU core 30**** and ****queue 1**** is processed by ****CPU core 32**** > [!NOTE] > Note > > Below is a sample command in case you are planning IPS-VM600 deployment: > > ``` > ovs-vsctl add-port ovsbr2 dpdk2 -- set Interface dpdk2 > type=dpdk options:dpdk-devargs='0000:19:00.1' > options:n_rxq=1 other_config:pmd-rxq-affinity="0:30" > ``` 20. Set the queue size for Transmitter (Tx) and Receiver (Rx) queues. Sample commands for setting the queue size: ``` ovs-vsctl set Interface dpdk1 options:n_rxq_desc=1024 ovs-vsctl set Interface dpdk2 options:n_txq_desc=1024 ``` 21. ****Add vhostuser ports to the bridges and grant permissions**** You can create dpdkvhostuser ports by executing the command `ovs-vsctl add-port <bridge_name1> <vhostuser_name> -- set Interface <vhostuser_name> type=dpdkvhostuser options:n_rxq=2 other_config:pmd-rxq-affinity="<queue_number:CPU_core_number,queue_number:CPU_core_number,..."` Following the above syntax, create 2 ports. Below are the sample commands for creating 2 ports: ``` ovs-vsctl add-port ovsbr1 vhostuser1 -- set Interface vhostuser1 type=dpdkvhostuser options:n_rxq=2 other_config:pmd-rxq-affinity="0:34,1:36" ovs-vsctl add-port ovsbr2 vhostuser2 -- set Interface vhostuser2 type=dpdkvhostuser options:n_rxq=2 other_config:pmd-rxq-affinity="0:38,1:40" ``` Where: `ovsbr1` is the name of ****bridge 1**** `ovsbr2` is the name of ****bridge 2**** `vhostuser1` is the ****vhostuser name 1**** `vhostuser2` is the ****vhostuser name 2**** represents ******** belonging to ****dpdk2**** `0:34,1:36` represent ****queue 0**** is processed by ****CPU core 34**** and ****queue 1**** is processed by ****CPU core 36**** `0:38,1:40` represent ****queue 0**** is processed by ****CPU core 38**** and ****queue 1**** is processed by ****CPU core 40**** > [!NOTE] > Note > > The number of ports you create depends on your usage. If you plan to use all the ports, including the management and response ports, you need to create 8 vhostuser ports. While it is necessary to connect the monitoring ports to the vhostuser ports, the management and response ports can be connected via bridge or vhostuser ports. > [!NOTE] > Note > > Below is a sample command in case you are planning IPS-VM600 deployment: > > ``` > ovs-vsctl add-port ovsbr1 vhostuser1 -- set Interface > vhostuser1 type=dpdkvhostuser options:n_rxq=1 > other_config:pmd-rxq-affinity="0:34" > ``` 22. To allow vhostuser ports to be used by VM, grant read-write-execute permissions over the sockets created by OVS service in `/var/run/openvswitch/` directory. Sample commands to grant permissions for 2 vhostusers are: ``` chmod 777 /var/run/openvswitch/vhostuser1 chmod 777 /var/run/openvswitch/vhostuser2 ``` > [!NOTE] > Note > > If you face any permission issue while starting a Sensor virtual machine, you need to assign read-write-execute permission to the entire openvswitch directory by executing the command `chmod 777 /var/run/openvswitch/*`. > [!NOTE] > Note > > These sockets are deleted when the OVS service stops and re-created when the service starts. These permissions must be granted again in case the service is stopped and restarted. > [!NOTE] > Note > > If you are restarting the OVS service, you need to add rules/flows to the switches and configure them. Below are sample commands to add new flows: > > ``` > ovs-ofctl add-flow ovsbr1 in_port=1,action=output:2 > ovs-ofctl add-flow ovsbr1 in_port=2,action=output:1 > ovs-ofctl add-flow ovsbr2 in_port=1,action=output:2 > ovs-ofctl add-flow ovsbr2 in_port=2,action=output:1 > ``` 23. ****Virtual machine configuration file changes**** The Sensor virtual machine configuration file is an XML file that stores the configuration information of the machine. Refer to the section [Sample XML file](/network-and-platform/docs/sample-xml-file) to view a sample configuration file. If you are modifying XML file configuration, make sure you restart the machine by executing the following commands: ``` virsh destroy virsh start ``` where `<VM_NAME>` denotes the name of the Sensor virtual machine.