From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by dpdk.org (Postfix) with ESMTP id 358DA568D for ; Fri, 15 Jan 2016 07:52:57 +0100 (CET) Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by fmsmga104.fm.intel.com with ESMTP; 14 Jan 2016 22:52:57 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.22,298,1449561600"; d="scan'208";a="893660747" Received: from unknown (HELO dpdk-fedora20.icx.intel.com) ([10.238.55.12]) by fmsmga002.fm.intel.com with ESMTP; 14 Jan 2016 22:52:56 -0800 From: "xu,huilong" To: dts@dpdk.org Date: Fri, 15 Jan 2016 14:48:28 +0800 Message-Id: <1452840510-19043-1-git-send-email-huilongx.xu@intel.com> X-Mailer: git-send-email 1.9.3 Subject: [dts] [PATCH V2 1/3] add vf rss test plan X-BeenThere: dts@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: test suite reviews and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 15 Jan 2016 06:52:57 -0000 --- test_plans/vf_rss_test_plan.rst | 186 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 186 insertions(+) create mode 100644 test_plans/vf_rss_test_plan.rst diff --git a/test_plans/vf_rss_test_plan.rst b/test_plans/vf_rss_test_plan.rst new file mode 100644 index 0000000..864b0a1 --- /dev/null +++ b/test_plans/vf_rss_test_plan.rst @@ -0,0 +1,186 @@ +.. Copyright (c) <2016>, 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. + +================================================================== +Fortville RSS full support - Support configuring hash functions +================================================================== + +This document provides test plan for testing the function of Fortville: +Support configuring hash functions. + +Prerequisites +------------- + +2x Intel? 82599 (Niantic) NICs (2x 10GbE full duplex optical ports per NIC) +1x Fortville_eagle NIC (4x 10G) +1x Fortville_spirit NIC (2x 40G) +2x Fortville_spirit_single NIC (1x 40G) + +The one port of the 82599 connect to the Fortville_eagle; +The one port of Fortville_spirit connect to Fortville_spirit_single. +The three kinds of NICs are the target NICs. the connected NICs can send packets +to these three NICs using scapy. + +Network Traffic +--------------- + +The RSS feature is designed to improve networking performance by load balancing +the packets received from a NIC port to multiple NIC RX queues, with each queue +handled by a different logical core. + +#1. The receive packet is parsed into the header fields used by the hash +operation (such as IP addresses, TCP port, etc.) + +#2. A hash calculation is performed. The Fortville supports three hash function: +Toeplitz, simple XOR and their Symmetric RSS. + +#3. Hash result are used as an index into a 128/512 entry +'redirection table'. + +#4. Niantic VF only support simple default hash algorithm(simple). Fortville NIC +support all hash algorithm only used dpdk driver on host. when used kernel driver on host, +fortville nic only support default hash algorithm(simple). + +The RSS RETA update feature is designed to make RSS more flexible by allowing +users to define the correspondence between the seven LSBs of hash result and +the queue id(RSS output index) by themself. + + +Test Case: test_rss_hash +======================================== + +The following RX Ports/Queues configurations have to be benchmarked: + +- 1 RX port / 4 RX queues (1P/4Q) + + +Testpmd configuration - 4 RX/TX queues per port +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +:: + + testpmd -c 1f -n 3 -- -i --rxq=4 --txq=4 --txqflags=0 + +Testpmd Configuration Options +----------------------------- + +By default, a single logical core runs the test. +The CPU IDs and the number of logical cores running the test in parallel can +be manually set with the ``set corelist X,Y`` and the ``set nbcore N`` +interactive commands of the ``testpmd`` application. +#1. got the pci device id of DUT, for example, + +./dpdk_nic_bind.py --st + +0000:81:00.0 'Ethernet Controller X710 for 10GbE SFP+' if=ens259f0 drv=i40e unused= +0000:81:00.1 'Ethernet Controller X710 for 10GbE SFP+' if=ens259f1 drv=i40e unused= + +#2. create 2 VFs from 2 PFs, + +echo 1 > /sys/bus/pci/devices/0000\:81\:00.0/sriov_numvfs +echo 1 > /sys/bus/pci/devices/0000\:81\:00.1/sriov_numvfs +./dpdk_nic_bind.py --st + +0000:81:00.0 'Ethernet Controller X710 for 10GbE SFP+' if=ens259f0 drv=i40e unused= +0000:81:00.1 'Ethernet Controller X710 for 10GbE SFP+' if=ens259f1 drv=i40e unused= +0000:81:02.0 'XL710/X710 Virtual Function' unused= +0000:81:0a.0 'XL710/X710 Virtual Function' unused= + +#3. detach VFs from the host, bind them to pci-stub driver, + +/sbin/modprobe pci-stub + +using `lspci -nn|grep -i ethernet` got VF device id, for example "8086 154c", + +echo "8086 154c" > /sys/bus/pci/drivers/pci-stub/new_id +echo 0000:81:02.0 > /sys/bus/pci/devices/0000:08:02.0/driver/unbind +echo 0000:81:02.0 > /sys/bus/pci/drivers/pci-stub/bind + +echo "8086 154c" > /sys/bus/pci/drivers/pci-stub/new_id +echo 0000:81:0a.0 > /sys/bus/pci/devices/0000:08:0a.0/driver/unbind +echo 0000:81:0a.0 > /sys/bus/pci/drivers/pci-stub/bind + + or using the following more easy way, + + virsh nodedev-detach pci_0000_81_02_0; + virsh nodedev-detach pci_0000_81_0a_0; + + ./dpdk_nic_bind.py --st + + 0000:81:00.0 'Ethernet Controller X710 for 10GbE SFP+' if=ens259f0 drv=i40e unused= + 0000:81:00.1 'Ethernet Controller X710 for 10GbE SFP+' if=ens259f1 drv=i40e unused= + 0000:81:02.0 'XL710/X710 Virtual Function' if= drv=pci-stub unused= + 0000:81:0a.0 'XL710/X710 Virtual Function' if= drv=pci-stub unused= + + it can be seen that VFs 81:02.0 & 81:0a.0 's drv is pci-stub. + +#4. passthrough VFs 81:02.0 & 81:0a.0 to vm0, and start vm0, + + /usr/bin/qemu-system-x86_64 -name vm0 -enable-kvm \ + -cpu host -smp 4 -m 2048 -drive file=/home/image/sriov-fc20-1.img -vnc :1 \ + -device pci-assign,host=81:02.0,id=pt_0 \ + -device pci-assign,host=81:0a.0,id=pt_1 + +#5. login vm0, got VFs pci device id in vm0, assume they are 00:06.0 & 00:07.0, bind them to igb_uio driver, +and then start testpmd, set it in mac forward mode, + +./tools/dpdk_nic_bind.py --bind=igb_uio 00:06.0 00:07.0 + +#6. Reta Configuration. 128 reta entries configuration:: + + testpmd command: port config 0 rss reta (hash_index,queue_id) + +#7. PMD fwd only receive the packets:: + + testpmd command: set fwd rxonly + +#8. rss recived package type configuration two received packet types configuration:: + + testpmd command: port config 0 rss ip/udp/tcp + +#9. verbose configuration:: + + testpmd command: set verbose 8 + +#10. start packet receive:: + + testpmd command: start +#11. send packet and check rx port received packet by different queue. + different hash type send different packet, example hash type is ip, packet src and dts ip not different + sendp([Ether(dst="90:e2:ba:36:99:3c")/IP(src="192.168.0.4", dst="192.168.0.5")], iface="eth3") + sendp([Ether(dst="90:e2:ba:36:99:3c")/IP(src="192.168.0.5", dst="192.168.0.4")], iface="eth3") +Test Case: test_reta +======================================== + this case test hash reta table, the test steps same with test_rss_hash except config hash reta table +#1 before send packet, config hash reta,512(niantic nic have 128 reta) reta entries configuration:: + + testpmd command: port config 0 rss reta (hash_index,queue_id) -- 1.9.3