[dts] [dts 2/3] [PATCH V2] add shutdown api test plan

[Fu, JingguoX]

> -----Original Message-----
> From: Xu, HuilongX
> Sent: Friday, May 29, 2015 10:19
> To: dts at dpdk.org
> Cc: Fu, JingguoX; Xu, HuilongX
> Subject: [dts 2/3] [PATCH V2] add shutdown api test plan
> 
> From: huilong xu <huilongx.xu at intel.com>
> 
> 
> Signed-off-by: huilong xu <huilongx.xu at intel.com>
> ---
>  test_plans/shutdown_api_test_plan.rst |  167
> +++++++++++++++++++++++++++++++++
>  1 files changed, 167 insertions(+), 0 deletions(-)
>  create mode 100644 test_plans/shutdown_api_test_plan.rst
> 
> diff --git a/test_plans/shutdown_api_test_plan.rst
> b/test_plans/shutdown_api_test_plan.rst
> new file mode 100644
> index 0000000..0dd47b9
> --- /dev/null
> +++ b/test_plans/shutdown_api_test_plan.rst
> @@ -0,0 +1,167 @@
> +.. <COPYRIGHT_TAG>
> +
> +======================================
> +Intel® DPDK Shutdown API Feature Tests
> +======================================
> +
> +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
> +new configurations for a port after the port is stopped, and if it is
> +able to restart with those new configurations. It is based on testpmd
> +application.
> +
> +The test is performed by running the testpmd application and using a
> +traffic generator. Port/queue configurations can be set interactively,
> +and still be set at the command line when launching the application in
> +order to be compatible with previous test framework.
> +
> +Prerequisites
> +-------------
> +
> +Support igb_uio and vfio driver, if used vfio, kernel need 3.6+ and enable
> vt-d in bios.
> +When used vfio , used "modprobe vfio" and "modprobe vfio-pci" insmod vfiod
> driver, then used
> +"./tools/dpdk_nic_bind.py --bind=vfio-pci device_bus_id" to bind vfio driver
> to test driver.
> +
> +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,
> +4 channels with other default parameters in interactive mode.
> +
> +	$ ./testpmd -c 0xf -n 4 -- -i
> +
> +Test Case: 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 reconfiguring all ports without
> +changing any configurations.
> +2. run "start" to start forwarding packets.
> +3. check that testpmd is able to forward traffic.
> +4. run "stop" to stop forwarding packets.
> +5. run "port stop all" to stop all ports.
> +6. check on the tester side that the ports are down using ethtool.
> +7. run "port start all" to restart all ports.
> +8. check on the tester side that the ports are up using ethtool
> +9. 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: 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
> +changing any configurations.
> +2. run "port stop all" to stop all ports.
> +3. run "port config all rxq 2" to change the number of receiving queues to
> two.
> +4. run "port config all txq 2" to change the number of transmiting queues to
> two.
> +5. run "port start all" to restart all ports.
> +6. check with "show config rxtx" that the configuration for these parameters
> 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.
> +
> +Test Case: 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
> +it while all ports are stopped
> +2. run "port stop all" to stop all ports.
> +3. run "set promisc all off" to disable promiscuous mode on all ports.
> +4. run "port start all" to restart all ports.
> +5. run "start" again to restart the forwarding, then start packet generator
> to transmit
> +and receive packets, and check that testpmd is NOT able to receive and
> forward packets
> +successfully.
> +6. run "port stop all" to stop all ports.
> +7. run "set promisc all on" to enable promiscuous mode on all ports.
> +8. run "port start all" to restart all ports.
> +9. run "start" again to restart the forwarding, then start packet generator
> to transmit
> +and receive packets, and check that testpmd is able to receive and forward
> packets
> +successfully.
> +
> +
> +
> +Test Case: 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
> +changing any configurations.
> +2. run "port stop all" to stop all ports.
> +3. run "port config all crc-strip on" to enable the CRC stripping mode.
> +4. run "port start all" to restart all ports.
> +5. check with "show config rxtx" that the configuration for these parameters
> changed.
> +6. 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. Check that the packet received is 4 bytes smaller than the
> packet sent.
> +
> +Test Case: 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
> +changing any configurations.
> +2. run "port stop all" to stop all ports.
> +3. run "port config all speed SPEED duplex HALF/FULL" to select the new
> config for the link.
> +4. run "port start all" to restart all ports.
> +5. check on the tester side that the configuration actually changed using
> ethtool.
> +6. 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.
> +7. repeat this process for every compatible speed depending on the NIC driver.
> +
> +Test Case: 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
> +changing any configurations.
> +2. run "port stop all" to stop all ports.
> +3. run "port config all max-pkt-len 2048" to set the maximum packet length.
> +4. run "port start all" to restart all ports.
> +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. Check this with the following packet sizes: 2047, 2048 & 2049.
> Only the third one should fail.
> +
> +Test Case: 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
> +changing any configurations.
> +2. run "port stop all" to stop all ports.
> +3. run "port config rss ip" to enable RSS.
> +4. run "port start all" to restart all ports.
> +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.
> +
> +Test Case: 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
> +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.
> +6. 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: 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
> +changing any configurations.
> +2. run "set fwd mac" to set fwd type.
> +3. run "start" to start the forwarding, then start packet generator to
> transmit
> +and receive packets
> +4. run "set link-down port X" to set all port link down
> +5. check on the tester side that the configuration actually changed using
> ethtool.
> +6. start packet generator to transmit and not receive packets
> +7. run "set link-up port X" to set all port link up
> +8. start packet generator to transmit and receive packets
> +successfully
> --
> 1.7.4.4

Acked-by: Jingguo Fu <jingguox.fu at intel.com>