[dts] [PATCH v2] test_plans/vhost_virtio_pmd_interrupt: add test plan for vhost/virtio-pmd interrupt test

[dts] [PATCH v2] test_plans/vhost_virtio_pmd_interrupt: add test plan for vhost/virtio-pmd interrupt test

[Yinan]

From: Wang Yinan <yinan.wang@intel.com>

Signed-off-by: Wang Yinan <yinan.wang@intel.com>
---
 .../vhost_virtio_pmd_interrupt_test_plan.rst  | 153 ++++++++++++++++++
 1 file changed, 153 insertions(+)
 create mode 100644 test_plans/vhost_virtio_pmd_interrupt_test_plan.rst

diff --git a/test_plans/vhost_virtio_pmd_interrupt_test_plan.rst b/test_plans/vhost_virtio_pmd_interrupt_test_plan.rst
new file mode 100644
index 0000000..b928748
--- /dev/null
+++ b/test_plans/vhost_virtio_pmd_interrupt_test_plan.rst
@@ -0,0 +1,153 @@
+.. Copyright (c) <2019>, Intel Corporation
+   All rights reserved.
+
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+   - Redistributions of source code must retain the above copyright
+     notice, this list of conditions and the following disclaimer.
+
+   - Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in
+     the documentation and/or other materials provided with the
+     distribution.
+
+   - Neither the name of Intel Corporation nor the names of its
+     contributors may be used to endorse or promote products derived
+     from this software without specific prior written permission.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+   FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+   COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+   (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+   SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+   HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+   STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+   OF THE POSSIBILITY OF SUCH DAMAGE.
+
+=========================================
+vhost/virtio-pmd interrupt mode test plan
+=========================================
+
+Virtio-pmd interrupt need test with l3fwd-power sample, small packets send from traffic generator to virtio-pmd side，check virtio-pmd cores can be wakeup status，and virtio-pmd cores should be sleep status after stop sending packets from traffic generator.
+This test plan cover virtio 0.95 and virtio 1.0 test.
+
+Prerequisites
+=============
+
+Test ENV preparation: Kernel version > 4.8.0, mostly linux distribution don't support vfio-noiommu mode by default, so testing this case need rebuild kernel to enable vfio-noiommu.
+
+Test flow
+=========
+
+TG --> NIC --> Vhost --> Virtio--> Vhost --> NIC --> TG
+
+Test Case 1: Basic virtio interrupt test with 4 queues
+=======================================================
+
+1. Bind one NIC port to igb_uio, then launch testpmd by below command::
+
+    rm -rf vhost-net*
+    ./testpmd -c 0x7c -n 4 --socket-mem 1024,1024 --vdev 'net_vhost0,iface=vhost-net,queues=4' -- -i --nb-cores=4 --rxq=4 --txq=4 --rss-ip
+
+2. Launch VM1, set queues=4, vectors>=2xqueues+2, mq=on::
+
+    taskset -c 34-35 \
+    qemu-system-x86_64 -name us-vhost-vm2 \
+     -cpu host -enable-kvm -m 4096 -object memory-backend-file,id=mem,size=4096M,mem-path=/mnt/huge,share=on -numa node,memdev=mem -mem-prealloc \
+     -smp cores=4,sockets=1 -drive file=/home/osimg/noiommu-ubt16.img \
+     -monitor unix:/tmp/vm2_monitor.sock,server,nowait -net nic,vlan=2,macaddr=00:00:00:08:e8:aa,addr=1f -net user,vlan=2,hostfwd=tcp:127.0.0.1:6002-:22 \
+     -chardev socket,id=char1,path=./vhost-net -netdev type=vhost-user,id=mynet2,chardev=char1,vhostforce,queues=4 \
+     -device virtio-net-pci,mac=52:54:00:00:00:02,netdev=mynet2,mrg_rxbuf=on,csum=on,mq=on,vectors=15  \
+     -vnc :10 -daemonize
+
+3. Bind virtio port to vfio-pci::
+
+	  modprobe vfio enable_unsafe_noiommu_mode=1
+	  modprobe vfio-pci
+    ./usertools/dpdk-devbind.py --bind=vfio-pci xx:xx.x
+
+4. In VM, launch l3fwd-power sample::
+
+  ./l3fwd-power -c 0xf -n 4 --log-level='user1,7' -- -p 1 -P --config="(0,0,0),(0,1,1),(0,2,2),(0,3,3)" --no-numa --parse-ptype
+
+5. Send random dest ip address packets to host nic with packet generator, packets will distribute to all queues, check l3fwd-power log that all related cores are waked up.
+
+6. Change dest IP address to fixed ip, packets will distribute to 1 queue, check l3fwd-power log that only one related core is waked up.
+
+7. Stop the date transmitter, check all related cores will be back to sleep status.
+
+Test Case 2: Basic virtio interrupt test with 16 queues
+=======================================================
+
+1. Bind one NIC port to igb_uio, then launch testpmd by below command::
+
+    rm -rf vhost-net*
+    ./testpmd -c 0x1ffff -n 4 --socket-mem 1024 1024 --vdev 'eth_vhost0,iface=vhost-net,queues=16' -- -i --nb-cores=16 --rxq=16 --txq=16 --rss-ip
+
+2. Launch VM1, set queues=16, vectors>=2xqueues+2, mq=on::
+
+    taskset -c 34-35 \
+    qemu-system-x86_64 -name us-vhost-vm2 \
+     -cpu host -enable-kvm -m 2048 -object memory-backend-file,id=mem,size=2048M,mem-path=/mnt/huge,share=on -numa node,memdev=mem -mem-prealloc \
+     -smp cores=16,sockets=1 -drive file=/home/osimg/noiommu-ubt16.img \
+     -monitor unix:/tmp/vm2_monitor.sock,server,nowait -net nic,vlan=2,macaddr=00:00:00:08:e8:aa,addr=1f -net user,vlan=2,hostfwd=tcp:127.0.0.1:6005-:22 \
+     -chardev socket,id=char1,path=./vhost-net -netdev type=vhost-user,id=mynet2,chardev=char1,vhostforce,queues=16 \
+     -device virtio-net-pci,mac=52:54:00:00:00:02,netdev=mynet2,mrg_rxbuf=on,csum=on,mq=on,vectors=40  \
+     -vnc :11 -daemonize
+
+3   Bind virtio port to vfio-pci::
+
+    modprobe vfio enable_unsafe_noiommu_mode=1
+    modprobe vfio-pci
+    ./usertools/dpdk-devbind.py --bind=vfio-pci xx:xx.x
+
+4. In VM, launch l3fwd-power sample::
+
+  ./l3fwd-power -c 0x0ffff -n 4 --log-level='user1,7' -- -p 1 -P  --config '(0,0,0),(0,1,1),(0,2,2),(0,3,3)(0,4,4),(0,5,5),(0,6,6),(0,7,7)(0,8,8),(0,9,9),(0,10,10),(0,11,11)(0,12,12),(0,13,13),(0,14,14),(0,15,15)' --no-numa  --parse-ptype
+
+5. Send random dest ip address packets to host nic with packet generator, packets will distribute to all queues, check l3fwd-power log that all related cores are waked up.
+
+6. Change dest IP address to fixed ip, packets will distribute to 1 queue, check l3fwd-power log that only one related core is waked up.
+
+7. Stop the date transmitter, check all related core will be back to sleep status.
+
+Test Case 3: Basic virtio-1.0 interrupt test with 4 queues
+==========================================================
+
+1. Bind one NIC port to igb_uio, then launch testpmd by below command::
+
+    rm -rf vhost-net*
+    ./testpmd -c 0x7c -n 4 --socket-mem 1024,1024 --vdev 'net_vhost0,iface=vhost-net,queues=4' -- -i --nb-cores=4 --rxq=4 --txq=4 --rss-ip
+
+2. Launch VM1, set queues=4, vectors>=2xqueues+2, mq=on::
+
+    taskset -c 34-35 \
+    qemu-system-x86_64 -name us-vhost-vm2 \
+     -cpu host -enable-kvm -m 2048 -object memory-backend-file,id=mem,size=2048M,mem-path=/mnt/huge,share=on -numa node,memdev=mem -mem-prealloc \
+     -smp cores=4,sockets=1 -drive file=/home/osimg/noiommu-ubt16.img \
+     -monitor unix:/tmp/vm2_monitor.sock,server,nowait -net nic,vlan=2,macaddr=00:00:00:08:e8:aa,addr=1f -net user,vlan=2,hostfwd=tcp:127.0.0.1:6005-:22 \
+     -chardev socket,id=char1,path=./vhost-net -netdev type=vhost-user,id=mynet2,chardev=char1,vhostforce,queues=4 \
+     -device virtio-net-pci,mac=52:54:00:00:00:02,netdev=mynet2,disable-modern=false,mrg_rxbuf=on,csum=on,mq=on,vectors=15  \
+     -vnc :11 -daemonize
+
+3   Bind virtio port to vfio-pci::
+
+    modprobe vfio enable_unsafe_noiommu_mode=1
+    modprobe vfio-pci
+    ./usertools/dpdk-devbind.py --bind=vfio-pci xx:xx.x
+
+4. In VM, launch l3fwd-power sample::
+
+  ./l3fwd-power -c 0xf -n 4 --log-level='user1,7' -- -p 1 -P --config="(0,0,0),(0,1,1),(0,2,2),(0,3,3)" --no-numa --parse-ptype
+
+5. Send random dest ip address packets to host nic with packet generator, packets will distribute to all queues, check l3fwd-power log that all related cores are waked up.
+
+6. Change dest IP address to fixed ip, packets will distribute to 1 queue, check l3fwd-power log that only one related core is waked up.
+
+7. Stop the date transmitter, check all related core will be back to sleep status.
-- 
2.17.1

Re: [dts] [PATCH v2] test_plans/vhost_virtio_pmd_interrupt: add test plan for vhost/virtio-pmd interrupt test

[Tu, Lijuan]

Applied, thanks

> -----Original Message-----
> From: dts [mailto:dts-bounces@dpdk.org] On Behalf Of Yinan
> Sent: Sunday, April 21, 2019 4:12 PM
> To: dts@dpdk.org
> Cc: Wang, Yinan <yinan.wang@intel.com>
> Subject: [dts] [PATCH v2] test_plans/vhost_virtio_pmd_interrupt: add test
> plan for vhost/virtio-pmd interrupt test
> 
> From: Wang Yinan <yinan.wang@intel.com>
> 
> Signed-off-by: Wang Yinan <yinan.wang@intel.com>
> ---
>  .../vhost_virtio_pmd_interrupt_test_plan.rst  | 153 ++++++++++++++++++
>  1 file changed, 153 insertions(+)
>  create mode 100644 test_plans/vhost_virtio_pmd_interrupt_test_plan.rst
> 
> diff --git a/test_plans/vhost_virtio_pmd_interrupt_test_plan.rst
> b/test_plans/vhost_virtio_pmd_interrupt_test_plan.rst
> new file mode 100644
> index 0000000..b928748
> --- /dev/null
> +++ b/test_plans/vhost_virtio_pmd_interrupt_test_plan.rst
> @@ -0,0 +1,153 @@
> +.. Copyright (c) <2019>, Intel Corporation
> +   All rights reserved.
> +
> +   Redistribution and use in source and binary forms, with or without
> +   modification, are permitted provided that the following conditions
> +   are met:
> +
> +   - Redistributions of source code must retain the above copyright
> +     notice, this list of conditions and the following disclaimer.
> +
> +   - Redistributions in binary form must reproduce the above copyright
> +     notice, this list of conditions and the following disclaimer in
> +     the documentation and/or other materials provided with the
> +     distribution.
> +
> +   - Neither the name of Intel Corporation nor the names of its
> +     contributors may be used to endorse or promote products derived
> +     from this software without specific prior written permission.
> +
> +   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
> CONTRIBUTORS
> +   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
> +   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
> FITNESS
> +   FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
> +   COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
> INDIRECT,
> +   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
> +   (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
> OR
> +   SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
> +   HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
> CONTRACT,
> +   STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
> +   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
> ADVISED
> +   OF THE POSSIBILITY OF SUCH DAMAGE.
> +
> +=========================================
> +vhost/virtio-pmd interrupt mode test plan
> +=========================================
> +
> +Virtio-pmd interrupt need test with l3fwd-power sample, small packets
> send from traffic generator to virtio-pmd side，check virtio-pmd cores can
> be wakeup status，and virtio-pmd cores should be sleep status after stop
> sending packets from traffic generator.
> +This test plan cover virtio 0.95 and virtio 1.0 test.
> +
> +Prerequisites
> +=============
> +
> +Test ENV preparation: Kernel version > 4.8.0, mostly linux distribution don't
> support vfio-noiommu mode by default, so testing this case need rebuild
> kernel to enable vfio-noiommu.
> +
> +Test flow
> +=========
> +
> +TG --> NIC --> Vhost --> Virtio--> Vhost --> NIC --> TG
> +
> +Test Case 1: Basic virtio interrupt test with 4 queues
> +=======================================================
> +
> +1. Bind one NIC port to igb_uio, then launch testpmd by below command::
> +
> +    rm -rf vhost-net*
> +    ./testpmd -c 0x7c -n 4 --socket-mem 1024,1024 --vdev
> + 'net_vhost0,iface=vhost-net,queues=4' -- -i --nb-cores=4 --rxq=4
> + --txq=4 --rss-ip
> +
> +2. Launch VM1, set queues=4, vectors>=2xqueues+2, mq=on::
> +
> +    taskset -c 34-35 \
> +    qemu-system-x86_64 -name us-vhost-vm2 \
> +     -cpu host -enable-kvm -m 4096 -object memory-backend-
> file,id=mem,size=4096M,mem-path=/mnt/huge,share=on -numa
> node,memdev=mem -mem-prealloc \
> +     -smp cores=4,sockets=1 -drive file=/home/osimg/noiommu-ubt16.img \
> +     -monitor unix:/tmp/vm2_monitor.sock,server,nowait -net
> nic,vlan=2,macaddr=00:00:00:08:e8:aa,addr=1f -net
> user,vlan=2,hostfwd=tcp:127.0.0.1:6002-:22 \
> +     -chardev socket,id=char1,path=./vhost-net -netdev type=vhost-
> user,id=mynet2,chardev=char1,vhostforce,queues=4 \
> +     -device virtio-net-
> pci,mac=52:54:00:00:00:02,netdev=mynet2,mrg_rxbuf=on,csum=on,mq=on,ve
> ctors=15  \
> +     -vnc :10 -daemonize
> +
> +3. Bind virtio port to vfio-pci::
> +
> +	  modprobe vfio enable_unsafe_noiommu_mode=1
> +	  modprobe vfio-pci
> +    ./usertools/dpdk-devbind.py --bind=vfio-pci xx:xx.x
> +
> +4. In VM, launch l3fwd-power sample::
> +
> +  ./l3fwd-power -c 0xf -n 4 --log-level='user1,7' -- -p 1 -P
> + --config="(0,0,0),(0,1,1),(0,2,2),(0,3,3)" --no-numa --parse-ptype
> +
> +5. Send random dest ip address packets to host nic with packet generator,
> packets will distribute to all queues, check l3fwd-power log that all related
> cores are waked up.
> +
> +6. Change dest IP address to fixed ip, packets will distribute to 1 queue,
> check l3fwd-power log that only one related core is waked up.
> +
> +7. Stop the date transmitter, check all related cores will be back to sleep
> status.
> +
> +Test Case 2: Basic virtio interrupt test with 16 queues
> +=======================================================
> +
> +1. Bind one NIC port to igb_uio, then launch testpmd by below command::
> +
> +    rm -rf vhost-net*
> +    ./testpmd -c 0x1ffff -n 4 --socket-mem 1024 1024 --vdev
> + 'eth_vhost0,iface=vhost-net,queues=16' -- -i --nb-cores=16 --rxq=16
> + --txq=16 --rss-ip
> +
> +2. Launch VM1, set queues=16, vectors>=2xqueues+2, mq=on::
> +
> +    taskset -c 34-35 \
> +    qemu-system-x86_64 -name us-vhost-vm2 \
> +     -cpu host -enable-kvm -m 2048 -object memory-backend-
> file,id=mem,size=2048M,mem-path=/mnt/huge,share=on -numa
> node,memdev=mem -mem-prealloc \
> +     -smp cores=16,sockets=1 -drive file=/home/osimg/noiommu-ubt16.img \
> +     -monitor unix:/tmp/vm2_monitor.sock,server,nowait -net
> nic,vlan=2,macaddr=00:00:00:08:e8:aa,addr=1f -net
> user,vlan=2,hostfwd=tcp:127.0.0.1:6005-:22 \
> +     -chardev socket,id=char1,path=./vhost-net -netdev type=vhost-
> user,id=mynet2,chardev=char1,vhostforce,queues=16 \
> +     -device virtio-net-
> pci,mac=52:54:00:00:00:02,netdev=mynet2,mrg_rxbuf=on,csum=on,mq=on,ve
> ctors=40  \
> +     -vnc :11 -daemonize
> +
> +3   Bind virtio port to vfio-pci::
> +
> +    modprobe vfio enable_unsafe_noiommu_mode=1
> +    modprobe vfio-pci
> +    ./usertools/dpdk-devbind.py --bind=vfio-pci xx:xx.x
> +
> +4. In VM, launch l3fwd-power sample::
> +
> +  ./l3fwd-power -c 0x0ffff -n 4 --log-level='user1,7' -- -p 1 -P
> + --config
> + '(0,0,0),(0,1,1),(0,2,2),(0,3,3)(0,4,4),(0,5,5),(0,6,6),(0,7,7)(0,8,8)
> + ,(0,9,9),(0,10,10),(0,11,11)(0,12,12),(0,13,13),(0,14,14),(0,15,15)'
> + --no-numa  --parse-ptype
> +
> +5. Send random dest ip address packets to host nic with packet generator,
> packets will distribute to all queues, check l3fwd-power log that all related
> cores are waked up.
> +
> +6. Change dest IP address to fixed ip, packets will distribute to 1 queue,
> check l3fwd-power log that only one related core is waked up.
> +
> +7. Stop the date transmitter, check all related core will be back to sleep
> status.
> +
> +Test Case 3: Basic virtio-1.0 interrupt test with 4 queues
> +==========================================================
> +
> +1. Bind one NIC port to igb_uio, then launch testpmd by below command::
> +
> +    rm -rf vhost-net*
> +    ./testpmd -c 0x7c -n 4 --socket-mem 1024,1024 --vdev
> + 'net_vhost0,iface=vhost-net,queues=4' -- -i --nb-cores=4 --rxq=4
> + --txq=4 --rss-ip
> +
> +2. Launch VM1, set queues=4, vectors>=2xqueues+2, mq=on::
> +
> +    taskset -c 34-35 \
> +    qemu-system-x86_64 -name us-vhost-vm2 \
> +     -cpu host -enable-kvm -m 2048 -object memory-backend-
> file,id=mem,size=2048M,mem-path=/mnt/huge,share=on -numa
> node,memdev=mem -mem-prealloc \
> +     -smp cores=4,sockets=1 -drive file=/home/osimg/noiommu-ubt16.img \
> +     -monitor unix:/tmp/vm2_monitor.sock,server,nowait -net
> nic,vlan=2,macaddr=00:00:00:08:e8:aa,addr=1f -net
> user,vlan=2,hostfwd=tcp:127.0.0.1:6005-:22 \
> +     -chardev socket,id=char1,path=./vhost-net -netdev type=vhost-
> user,id=mynet2,chardev=char1,vhostforce,queues=4 \
> +     -device virtio-net-pci,mac=52:54:00:00:00:02,netdev=mynet2,disable-
> modern=false,mrg_rxbuf=on,csum=on,mq=on,vectors=15  \
> +     -vnc :11 -daemonize
> +
> +3   Bind virtio port to vfio-pci::
> +
> +    modprobe vfio enable_unsafe_noiommu_mode=1
> +    modprobe vfio-pci
> +    ./usertools/dpdk-devbind.py --bind=vfio-pci xx:xx.x
> +
> +4. In VM, launch l3fwd-power sample::
> +
> +  ./l3fwd-power -c 0xf -n 4 --log-level='user1,7' -- -p 1 -P
> + --config="(0,0,0),(0,1,1),(0,2,2),(0,3,3)" --no-numa --parse-ptype
> +
> +5. Send random dest ip address packets to host nic with packet generator,
> packets will distribute to all queues, check l3fwd-power log that all related
> cores are waked up.
> +
> +6. Change dest IP address to fixed ip, packets will distribute to 1 queue,
> check l3fwd-power log that only one related core is waked up.
> +
> +7. Stop the date transmitter, check all related core will be back to sleep
> status.
> --
> 2.17.1