From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 98256A0548; Wed, 8 Jun 2022 06:57:21 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 931BD41614; Wed, 8 Jun 2022 06:57:21 +0200 (CEST) Received: from mga07.intel.com (mga07.intel.com [134.134.136.100]) by mails.dpdk.org (Postfix) with ESMTP id 290834113F for ; Wed, 8 Jun 2022 06:57:19 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1654664240; x=1686200240; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=8lGNLnWPzOc1wjdaFCR95E+AwTUUuL+eGsOFuSy/b48=; b=QSTYjKHAJp17hcmzPg3+Ae4/6bV8KdEceF1bQaOt3ZEljofSgxUgSgkK 12fl83PI6W+H66oMxO5Ab9WsW5poks2kWYAl3JOl1gCvKrcx6Vk5+QgxG nRdlXOCg0FF/6tcO9BtNE5DRecrHjVLPfeXJMLKrh8yln1YIH0+1gvb6a bYv+KnxHEj1VY24F3AbjUgyvvtATI3OpcDhr3P5mZ+L8l9nkOxLakDKAo IINAfBycfnG7UAxWbUwGpOV5HRx5imNYkdna77BoWPYy/MOOzYR/FQp5j EfVuf4+o+1roB0IodN95R/Y3KVhfAVBv6BrHWw7YRICYH38ZTnPn8WcHQ w==; X-IronPort-AV: E=McAfee;i="6400,9594,10371"; a="340850067" X-IronPort-AV: E=Sophos;i="5.91,285,1647327600"; d="scan'208";a="340850067" Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by orsmga105.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 07 Jun 2022 21:57:19 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.91,285,1647327600"; d="scan'208";a="670347936" Received: from dpdk-yaqi.sh.intel.com ([10.67.118.178]) by FMSMGA003.fm.intel.com with ESMTP; 07 Jun 2022 21:57:17 -0700 From: Yaqi Tang To: dts@dpdk.org Cc: xueqin.lin@intel.com, Yaqi Tang Subject: [dts][PATCH V1 2/2] test_plans/shutdown_api: add 3 test cases and add case numbers Date: Wed, 8 Jun 2022 04:57:12 +0000 Message-Id: <20220608045712.350878-3-yaqi.tang@intel.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220608045712.350878-1-yaqi.tang@intel.com> References: <20220608045712.350878-1-yaqi.tang@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: dts@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: test suite reviews and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dts-bounces@dpdk.org Test plan lost 3 cases, so add 3 cases and add test case numbers to the plan. And adjust the format of test plan according to test plan template. Signed-off-by: Yaqi Tang --- test_plans/shutdown_api_test_plan.rst | 119 ++++++++++++++++++++------ 1 file changed, 91 insertions(+), 28 deletions(-) diff --git a/test_plans/shutdown_api_test_plan.rst b/test_plans/shutdown_api_test_plan.rst index df366872..f5399c5f 100644 --- a/test_plans/shutdown_api_test_plan.rst +++ b/test_plans/shutdown_api_test_plan.rst @@ -5,6 +5,8 @@ Shutdown API Feature Tests ========================== +Description +=========== This tests for Shutdown API feature can be run on linux userspace. It will check if NIC port can be stopped and restarted without exiting the application process. Furthermore, it will check if it can reconfigure @@ -18,15 +20,15 @@ and still be set at the command line when launching the application in order to be compatible with previous test framework. Prerequisites -------------- +============= If using vfio the kernel must be >= 3.6+ and VT-d must be enabled in bios.When using vfio, use the following commands to load the vfio driver and bind it to the device under test:: - modprobe vfio - modprobe vfio-pci - usertools/dpdk-devbind.py --bind=vfio-pci device_bus_id + modprobe vfio + modprobe vfio-pci + usertools/dpdk-devbind.py --bind=vfio-pci device_bus_id Assume port A and B are connected to the remote ports, e.g. packet generator. To run the testpmd application in linuxapp environment with 4 lcores, @@ -34,8 +36,11 @@ To run the testpmd application in linuxapp environment with 4 lcores, $ ./app/dpdk-testpmd -c 0xf -n 4 -- -i -Test Case: Stop and Restart ---------------------------- +Test Case +========= + +Test Case 1: Stop and restart +----------------------------- 1. If the testpmd application is not launched, run it as above command. Follow below steps to check if it works well after re-configuring all ports without @@ -51,8 +56,8 @@ Test Case: Stop and Restart transmit and receive packets, and check if testpmd is able to receive and forward packets successfully. -Test Case: Reset RX/TX Queues ------------------------------ +Test Case 2: Reset RX/TX queues +------------------------------- 1. If the testpmd application is not launched, run it as above command. Follow below steps to check if it works well after reconfiguring all ports without @@ -66,8 +71,8 @@ Test Case: Reset RX/TX Queues and receive packets, and check if testpmd is able to receive and forward packets successfully. -Test Case: Set promiscuous mode -------------------------------- +Test Case 3: Set promiscuous mode +--------------------------------- 1. If the testpmd application is not launched, run it as above command. Follow below steps to check if promiscuous mode setting works well after reconfiguring @@ -85,8 +90,8 @@ Test Case: Set promiscuous mode and receive packets, and check that testpmd is able to receive and forward packets successfully. -Test Case: Set allmulticast mode --------------------------------- +Test Case 4: Set allmulticast mode +---------------------------------- 1. If the testpmd application is not launched, run it as above command. Follow below steps to check if allmulticast mode setting works well after reconfiguring @@ -109,8 +114,8 @@ Test Case: Set allmulticast mode 17. Send packets with unicast dst not same to port address. 18. Check that testpmd is able to receive and forward packets successfully. -Test Case: Reconfigure All Ports With The Same Configurations (CRC) -------------------------------------------------------------------- +Test Case 5: Reconfigure all ports with the same configurations (CRC) +--------------------------------------------------------------------- 1. If the testpmd application is not launched, run it as above command. Follow below steps to check if it works well after reconfiguring all ports without @@ -124,8 +129,8 @@ Test Case: Reconfigure All Ports With The Same Configurations (CRC) forward packets successfully. Check that the packet received is 4 bytes smaller than the packet sent. -Test Case: Change Link Speed ----------------------------- +Test Case 6: Change link speed +------------------------------ 1. If the testpmd application is not launched, run it as above command. Follow below steps to check if it works well after reconfiguring all ports without @@ -139,8 +144,8 @@ Test Case: Change Link Speed successfully. 7. Repeat this process for every compatible speed depending on the NIC driver. -Test Case: Change Link Speed VF -------------------------------- +Test Case 7: Change link speed VF +--------------------------------- This case support all the nic with driver i40e and ixgbe. 1. bind a PF to DPDK:: @@ -160,8 +165,8 @@ This case support all the nic with driver i40e and ixgbe. successfully. 8. Repeat this process for every compatible speed depending on the NIC driver. -Test Case: Enable/Disable Jumbo Frame -------------------------------------- +Test Case 8: Enable/Disable jumbo frame +--------------------------------------- 1. If the testpmd application is not launched, run it as above command. Follow below steps to check if it works well after reconfiguring all ports without @@ -173,8 +178,8 @@ Test Case: Enable/Disable Jumbo Frame and receive packets, and check if testpmd is able to receive and forward packets successfully. Check this with the following packet sizes: 2047, 2048 & 2049. Only the third one should fail. -Test Case: Enable/Disable RSS ------------------------------ +Test Case 9: Enable/Disable RSS +------------------------------- 1. If the testpmd application is not launched, run it as above command. Follow below steps to check if it works well after reconfiguring all ports without @@ -186,8 +191,8 @@ Test Case: Enable/Disable RSS and receive packets, and check if testpmd is able to receive and forward packets successfully. -Test Case: Change the Number of rxd/txd ---------------------------------------- +Test Case 10: Change the number of rxd/txd +------------------------------------------ 1. If the testpmd application is not launched, run it as above command. Follow below steps to check if it works well after reconfiguring all ports without @@ -201,8 +206,66 @@ Test Case: Change the Number of rxd/txd and receive packets, and check if testpmd is able to receive and forward packets successfully. -Test Case: link stats ---------------------- +Test Case 11: Change the number of rxd/txd after cycle +------------------------------------------------------ + +1. If the testpmd application is not launched, run it as above command. Follow + below steps to check if it works well after reconfiguring all ports without + changing any configurations. +2. Run ``port stop all`` to stop all ports. +3. Run ``port config all rxd 1024`` to change the rx descriptors. +4. Run ``port config all txd 1024`` to change the tx descriptors. +5. Run ``port start all`` to restart all ports. +6. Check with ``show config rxtx`` that the descriptors were actually changed. +7. Run ``start`` again to restart the forwarding, then start packet generator to transmit + and receive packets, and check if testpmd is able to receive and forward packets + successfully. +8. Run ``stop`` to stop the forwarding. +9. Run ``port stop all`` to stop all ports. +10. Run ``port start all`` to restart all ports. +11. Check again with ``show config rxtx`` that the descriptors were actually changed. +12. Run ``start`` again to restart the forwarding, then start packet generator to transmit + and receive packets, and check if testpmd is able to receive and forward packets + successfully. + +Test Case 12: Change thresholds +------------------------------- + +1. If the testpmd application is not launched, run it as above command. Follow + below steps to check if it works well after reconfiguring all ports without + changing any configurations. +2. Run ``port stop all`` to stop all ports. +3. If NIC is IXGBE_10G-X550EM_X_10G_T, IXGBE_10G-X550T, IXGBE_10G-X540T, IXGBE_10G-82599_SFP, + Run ``port config all rxd 1024`` to change the rx descriptors, + Run ``port config all txd 1024`` to change the tx descriptors. +4. Run ``port config all rxfreet 32`` to change the rx descriptors. +5. Run ``port config all txpt 64`` to change the tx descriptors. +6. Run ``port config all txht 64`` to change the tx descriptors. +7. If NIC is IGC-I225_LM, Run ``port config all txwt 16`` to change the tx descriptors. + Else, Run ``port config all txwt 0`` to change the tx descriptors. +8. Run ``port start all`` to restart all ports. +9. Check with ``show config rxtx`` that the descriptors were actually changed. +10. Run ``start`` again to restart the forwarding, then start packet generator to transmit + and receive packets, and check if testpmd is able to receive and forward packets + successfully. + +Test Case 13: Stress test +------------------------- + +1. If the testpmd application is not launched, run it as above command. Follow + below steps to check if it works well after reconfiguring all ports without + changing any configurations. +2. Run ``port stop all`` to stop all ports. +3. Run ``port start all`` to restart all ports. +4. Check with ``show config rxtx`` that the descriptors were actually changed. +5. Run ``start`` again to restart the forwarding, then start packet generator to transmit + and receive packets, and check if testpmd is able to receive and forward packets + successfully. +6. Run ``stop`` to stop the forwarding. +7. Repeat step 2~6 for 10 times stress test. + +Test Case 14: link stats +------------------------ 1. If the testpmd application is not launched, run it as above command. Follow below steps to check if it works well after reconfiguring all ports without @@ -217,8 +280,8 @@ Test Case: link stats 8. Start packet generator to transmit and receive packets successfully. -Test Case: RX/TX descriptor status ----------------------------------- +Test Case 15: RX/TX descriptor status +------------------------------------- 1. Lauch testpmd with rx/tx queue number ``--txq=16 --rxq=16`` and rx/tx descriptor size ``--txd=4096 --rxd=4096`` 2. Run ``show port 0 rxq * desc * status`` to check rx descriptor status. -- 2.25.1