* [dts] [PATCH] Doc: update dts parameters
@ 2015-09-16 15:01 Yong Liu
2015-09-16 15:28 ` Qiu, Michael
0 siblings, 1 reply; 3+ messages in thread
From: Yong Liu @ 2015-09-16 15:01 UTC (permalink / raw)
To: dts
From: Marvin Liu <yong.liu@intel.com>
Add explain for new added parameters "virttype", "debug" and "debugcase".
CRB configuration file moved from python file to plain txt file.
Signed-off-by: Marvin Liu <yong.liu@intel.com>
diff --git a/doc/dts_gsg/conf.py b/doc/dts_gsg/conf.py
index 9213b01..6a8c679 100644
--- a/doc/dts_gsg/conf.py
+++ b/doc/dts_gsg/conf.py
@@ -1,5 +1,5 @@
# BSD LICENSE
-# Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
+# Copyright(c) 2010-2015 Intel Corporation. All rights reserved.
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
@@ -32,7 +32,7 @@ import subprocess
project = 'DPDK Test Suite'
-copyright = '2014, dpdk.org'
+copyright = '2015, dpdk.org'
#version = subprocess.check_output(["make","-sRrC","../../", "showversion"])
diff --git a/doc/dts_gsg/config.rst b/doc/dts_gsg/config.rst
index 7276681..f5b2bc7 100644
--- a/doc/dts_gsg/config.rst
+++ b/doc/dts_gsg/config.rst
@@ -9,10 +9,11 @@ For Example, please see specific usage, you can get these information via DPDK T
.. code-block:: console
- usage: main.py [-h] [--config-file CONFIG_FILE] [--git GIT] [--patch PATCH]
- [--snapshot SNAPSHOT] [--output OUTPUT] [-s] [-r] [-p PROJECT]
- [--suite-dir SUITE_DIR] [-t TEST_CASES [TEST_CASES ...]]
- [-d DIR]
+ usage: main.py [-h] [--config-file CONFIG_FILE] [--git GIT] [--patch PATCH]
+ [--snapshot SNAPSHOT] [--output OUTPUT] [-s] [-r] [-p PROJECT]
+ [--suite-dir SUITE_DIR] [-t TEST_CASES] [-d DIR] [-v]
+ [--virttype VIRTTYPE] [--debug] [--debugcase]
+
DPDK Test Suite supports the following parameters:
@@ -23,16 +24,16 @@ DPDK Test Suite supports the following parameters:
+---------------------------+---------------------------------------------------+------------------+
| -h,--help | show this help message and exit | |
+---------------------------+---------------------------------------------------+------------------+
- | --config-file CONFIG_FILE | configuration file that describes the test cases, | ../execution.cfg |
+ | --config-file CONFIG_FILE | configuration file that describes the test cases, | execution.cfg |
| | DUTs and targets | |
+---------------------------+---------------------------------------------------+------------------+
| --git GIT | Indicate git label to use as input | None |
+---------------------------+---------------------------------------------------+------------------+
| --patch PATCH | apply a patch to the package under test | None |
+---------------------------+---------------------------------------------------+------------------+
- | --snapshot SNAPSHOT | snapshot .tgz file to use as input | ../dpdk.tar.gz |
+ | --snapshot SNAPSHOT | snapshot .tgz file to use as input | dep/dpdk.tar.gz |
+---------------------------+---------------------------------------------------+------------------+
- | --output OUTPUT | Output directory where DPDK Test Suite log and | ../output |
+ | --output OUTPUT | Output directory where DPDK Test Suite log and | output |
| | result saved | |
+---------------------------+---------------------------------------------------+------------------+
| -s --skip-setup | Skips all possible setup steps done on both DUT | |
@@ -53,12 +54,21 @@ DPDK Test Suite supports the following parameters:
+---------------------------+---------------------------------------------------+------------------+
| -d DIR --dir DIR | Output directory where dpdk package is extracted | dpdk |
+---------------------------+---------------------------------------------------+------------------+
- | --suite-dir | Test suite directory where test suites will be | ../tests |
+ | --suite-dir | Test suite directory where test suites will be | tests |
| | imported | |
+---------------------------+---------------------------------------------------+------------------+
| -v, --verbose | Enable verbose output, all log shown on screen | |
+---------------------------+---------------------------------------------------+------------------+
-
+ | --virttype | Set virtualization hypervisor type. Support kvm | |
+ | | and libvirtd by now. | |
+ +---------------------------+---------------------------------------------------+------------------+
+ | --debug | Enable debug mode, running process can be | |
+ | | interrupted and enter debug mode. | |
+ +---------------------------+---------------------------------------------------+------------------+
+ | --debugcase | Enter into debug mode before running every test | |
+ | | case. | |
+ +---------------------------+---------------------------------------------------+------------------+
+
Please see more information about some critical parameters as the following:
**--config-file**
@@ -72,6 +82,7 @@ When we use –-git parameter, DPDK Test Suite will clone the source code from d
**--patch**
DPDK Test Suite also support apply specified patch list by --patch parameter before build DPDK packet.
+
**--skip-setup**
If DPDK source code doesn’t changed, you can use --skip-setup to skip unzip and compilation of DPDK source code, just reuse original source code.
@@ -85,7 +96,7 @@ Parameter –-project can load customized project model and do its own project i
If we perform multiple validation at the same time, result files in output folder maybe overwritten. Then we can use –-output parameter to specify the output folder and save execution log and result files. This option will make sure that all test result will be stored in the different excel files and rst files, doesn’t conflict each other.
.. note::
- The current working folder of DPDK Test Suite is “framework” and default output folder is “../output”
+ The current working folder of DPDK Test Suite is "DTS root directory" and default output folder is “output”
**--t**
@@ -101,15 +112,39 @@ DPDK Test Suite support load suites from different folders, this will be helpful
DPDK Test Suite support verbose mode. When enable this mode, all log messages will be output on screen and helpful for debug.
+**--virttype**
+
+Choose virtualization hypervisor type. By now this configuration is useless.
+
+**--debug**
+
+DPDK Test Suite support debug mode. After keyboard ctrl+c message to DTS process, will run into this mode. User can do further debug by attached to sessions or call pdb module by interact interface.
+
+Debug interact support commands as below:
+
+.. code-block:: console
+
+ help(): show help message
+ list(): list all connected sessions
+ connect(name): connect to session directly
+ exit(): exit dts
+ quit(): quit debug mode and into noraml mode
+ debug(): call python debug module
+
+**--debugcase**
+
+Another approach to run into debug mode. With this option on, DTS will hang and wait for user command before execution of each test case.
+
DPDK Release Preparation
------------------------
-Firstly, you need to download the latest code from dpdk.org, then archive and compress it in the source code folder. After that, please move this zipped file to DPDK Test Suite folder. Once launch test framework, DPDK Test Suite will copy this zipped file to root folder on DUT. Finally this source code zip file will be unzipped and built.
+Firstly, you need to download the latest code from dpdk.org, then archive and compress it into zipped file. After that, please move this zipped file to DPDK Test Suite "dep" folder. Once launch test framework, DPDK Test Suite will copy this zipped file to root folder on DUT. Finally this source code zip file will be unzipped and built.
.. code-block:: console
- [root@tester dcts]# ls
- [root@tester dcts]# dts dpdk.tar.gz execution.cfg framework output test_plans tests
+ [root@tester dts]# ls
+ [root@tester dts]# conf dep doc dts executions framework output test_plans tests tools
+
If enables patch option, DPDK Test Suite will also make patch the unzipped folder and compile it.
@@ -125,18 +160,20 @@ First of all, you must create a file named execution.cfg as below.
.. code-block:: console
[Execution1]
- crbs=10.239.128.117
+ crbs=129.168.1.1
test_suites=
hello_world,
l2fwd
targets=
x86_64-default-linuxapp-gcc,
parameters=nic_type=niantic:func=true
+ scenario=pf_passthrough
* crbs: IP address of the DUT CRB. The detail information of this CRB is defined in file crbs.py.
* test_suites: defines list of test suites, which will plan to be executed.
* gets: list of DPDK targets to be tested.
* parameters: you can define multiple keywords
+* scenario: Senario of DPDK virtualization environment for this execution.
– nic_type : is the type of the NIC to use. The types are defined in the file settings.py.
@@ -144,39 +181,44 @@ First of all, you must create a file named execution.cfg as below.
– perf=true run only performance test
-Then please add the detail information about your CRB in **crbs.py** as follows:
+Then please add the detail information about your CRB in **conf/crbs.conf** as follows:
.. code-block:: console
- crbs = [
- {'IP': '10.239.128.117',
- 'name': 'CrownPassCRB1',
- 'user': 'root',
- 'pass': 'tester',
- 'tester IP': '10.239.128.116',
- IXIA: None,
- 'memory channels': 4,
- 'bypass core0': True},
- ]
+ [192.168.1.1]
+ dut_ip=192.168.1.1
+ dut_user=root
+ dut_passwd=
+ os=linux
+ tester_ip=192.168.1.2
+ tester_passwd=
+ ixia_group=group1
+ channels=4
+ bypass_core0=True
+
.. table::
+-----------------+----------------------------------------------------+
| Item | description |
+-----------------+----------------------------------------------------+
- | IP | IP address of DUT |
+ | dut_ip | IP address of DUT |
+ +-----------------+----------------------------------------------------+
+ | dut_user | UserName of DPDK Test Suite used to login into DUT |
+-----------------+----------------------------------------------------+
- | name | Name of DUT |
+ | dut_passwd | Password of DPDK Test Suite used to login into DUT |
+-----------------+----------------------------------------------------+
- | user | UserName of DPDK Test Suite used to login into DUT |
+ | os | Distribution of operation system |
+-----------------+----------------------------------------------------+
- | pass | Password of DPDK Test Suite used to login into DUT |
+ | tester_ip | IP address of tester |
+-----------------+----------------------------------------------------+
- | Tester IP | IP address of tester |
+ | tester_passwd | Password to login into Tester |
+-----------------+----------------------------------------------------+
- | memory channels | number of memory channels for DPDK EAL |
+ | ixia_group | IXIA group name for this DUT |
+-----------------+----------------------------------------------------+
- | bypass core0 | skip the first core when initialize DPDK |
+ | channels | number of memory channels for DPDK EAL |
+ +-----------------+----------------------------------------------------+
+ | bypass_core0 | skip the first core when initialize DPDK |
+-----------------+----------------------------------------------------+
Launch DPDK Test Suite
@@ -188,17 +230,18 @@ DPDK Test Suite will create communication sessions first.
.. code-block:: console
- DUT 10.239.128.117
- DTS_DUT_CMD: ssh root@10.239.128.117
- DTS_DUT_CMD: ssh root@10.239.128.117
- DTS_TESTER_CMD: ssh root@10.239.128.116
- DCS_TESTER_CMD: ssh root@10.239.128.116
+ DUT 192.168.1.1
+ INFO: ssh root@192.168.1.1
+ INFO: ssh root@192.168.1.1
+ INFO: ssh root@192.168.1.2
+ INFO: ssh root@192.168.1.2
Then copy snapshot zipped dpdk source code to DUT.
+
.. code-block:: console
- DTS_DUT_CMD: scp ../dpdk.tar.gz root@10.239.128.117:
+ DTS_DUT_CMD: scp dep/dpdk.tar.gz root@192.168.1.1:
Collect CPU core and network device information of DUT and tester.
@@ -239,7 +282,7 @@ Clean-up DUT and tester after all validation finished.
.. code-block:: console
- DTS_DUT_CMD: rmmod igb_uio
+ DTS_DUT_CMD: rmmod igb_uio
DTS_DUT_CMD: modprobe igb
DTS_DUT_CMD: modprobe ixgbe
DTS_DUT_CMD: modprobe e1000e
--
1.9.3
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [dts] [PATCH] Doc: update dts parameters
2015-09-16 15:01 [dts] [PATCH] Doc: update dts parameters Yong Liu
@ 2015-09-16 15:28 ` Qiu, Michael
2015-09-17 0:30 ` Liu, Yong
0 siblings, 1 reply; 3+ messages in thread
From: Qiu, Michael @ 2015-09-16 15:28 UTC (permalink / raw)
To: Liu, Yong; +Cc: dts
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset="gb2312", Size: 14815 bytes --]
One line may be typo error, 129.168 should be 192.168 if am I right.
Thanks,
Michael
> ÔÚ 2015Äê9ÔÂ16ÈÕ£¬ÏÂÎç11:02£¬Yong Liu <yong.liu@intel.com> дµÀ£º
>
> From: Marvin Liu <yong.liu@intel.com>
>
> Add explain for new added parameters "virttype", "debug" and "debugcase".
> CRB configuration file moved from python file to plain txt file.
>
> Signed-off-by: Marvin Liu <yong.liu@intel.com>
>
> diff --git a/doc/dts_gsg/conf.py b/doc/dts_gsg/conf.py
> index 9213b01..6a8c679 100644
> --- a/doc/dts_gsg/conf.py
> +++ b/doc/dts_gsg/conf.py
> @@ -1,5 +1,5 @@
> # BSD LICENSE
> -# Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
> +# Copyright(c) 2010-2015 Intel Corporation. All rights reserved.
> # All rights reserved.
> #
> # Redistribution and use in source and binary forms, with or without
> @@ -32,7 +32,7 @@ import subprocess
>
> project = 'DPDK Test Suite'
>
> -copyright = '2014, dpdk.org'
> +copyright = '2015, dpdk.org'
>
> #version = subprocess.check_output(["make","-sRrC","../../", "showversion"])
>
> diff --git a/doc/dts_gsg/config.rst b/doc/dts_gsg/config.rst
> index 7276681..f5b2bc7 100644
> --- a/doc/dts_gsg/config.rst
> +++ b/doc/dts_gsg/config.rst
> @@ -9,10 +9,11 @@ For Example, please see specific usage, you can get these information via DPDK T
>
> .. code-block:: console
>
> - usage: main.py [-h] [--config-file CONFIG_FILE] [--git GIT] [--patch PATCH]
> - [--snapshot SNAPSHOT] [--output OUTPUT] [-s] [-r] [-p PROJECT]
> - [--suite-dir SUITE_DIR] [-t TEST_CASES [TEST_CASES ...]]
> - [-d DIR]
> + usage: main.py [-h] [--config-file CONFIG_FILE] [--git GIT] [--patch PATCH]
> + [--snapshot SNAPSHOT] [--output OUTPUT] [-s] [-r] [-p PROJECT]
> + [--suite-dir SUITE_DIR] [-t TEST_CASES] [-d DIR] [-v]
> + [--virttype VIRTTYPE] [--debug] [--debugcase]
> +
>
> DPDK Test Suite supports the following parameters:
>
> @@ -23,16 +24,16 @@ DPDK Test Suite supports the following parameters:
> +---------------------------+---------------------------------------------------+------------------+
> | -h,--help | show this help message and exit | |
> +---------------------------+---------------------------------------------------+------------------+
> - | --config-file CONFIG_FILE | configuration file that describes the test cases, | ../execution.cfg |
> + | --config-file CONFIG_FILE | configuration file that describes the test cases, | execution.cfg |
> | | DUTs and targets | |
> +---------------------------+---------------------------------------------------+------------------+
> | --git GIT | Indicate git label to use as input | None |
> +---------------------------+---------------------------------------------------+------------------+
> | --patch PATCH | apply a patch to the package under test | None |
> +---------------------------+---------------------------------------------------+------------------+
> - | --snapshot SNAPSHOT | snapshot .tgz file to use as input | ../dpdk.tar.gz |
> + | --snapshot SNAPSHOT | snapshot .tgz file to use as input | dep/dpdk.tar.gz |
> +---------------------------+---------------------------------------------------+------------------+
> - | --output OUTPUT | Output directory where DPDK Test Suite log and | ../output |
> + | --output OUTPUT | Output directory where DPDK Test Suite log and | output |
> | | result saved | |
> +---------------------------+---------------------------------------------------+------------------+
> | -s --skip-setup | Skips all possible setup steps done on both DUT | |
> @@ -53,12 +54,21 @@ DPDK Test Suite supports the following parameters:
> +---------------------------+---------------------------------------------------+------------------+
> | -d DIR --dir DIR | Output directory where dpdk package is extracted | dpdk |
> +---------------------------+---------------------------------------------------+------------------+
> - | --suite-dir | Test suite directory where test suites will be | ../tests |
> + | --suite-dir | Test suite directory where test suites will be | tests |
> | | imported | |
> +---------------------------+---------------------------------------------------+------------------+
> | -v, --verbose | Enable verbose output, all log shown on screen | |
> +---------------------------+---------------------------------------------------+------------------+
> -
> + | --virttype | Set virtualization hypervisor type. Support kvm | |
> + | | and libvirtd by now. | |
> + +---------------------------+---------------------------------------------------+------------------+
> + | --debug | Enable debug mode, running process can be | |
> + | | interrupted and enter debug mode. | |
> + +---------------------------+---------------------------------------------------+------------------+
> + | --debugcase | Enter into debug mode before running every test | |
> + | | case. | |
> + +---------------------------+---------------------------------------------------+------------------+
> +
> Please see more information about some critical parameters as the following:
>
> **--config-file**
> @@ -72,6 +82,7 @@ When we use ¨C-git parameter, DPDK Test Suite will clone the source code from d
> **--patch**
>
> DPDK Test Suite also support apply specified patch list by --patch parameter before build DPDK packet.
> +
> **--skip-setup**
>
> If DPDK source code doesn¡¯t changed, you can use --skip-setup to skip unzip and compilation of DPDK source code, just reuse original source code.
> @@ -85,7 +96,7 @@ Parameter ¨C-project can load customized project model and do its own project i
> If we perform multiple validation at the same time, result files in output folder maybe overwritten. Then we can use ¨C-output parameter to specify the output folder and save execution log and result files. This option will make sure that all test result will be stored in the different excel files and rst files, doesn¡¯t conflict each other.
>
> .. note::
> - The current working folder of DPDK Test Suite is ¡°framework¡± and default output folder is ¡°../output¡±
> + The current working folder of DPDK Test Suite is "DTS root directory" and default output folder is ¡°output¡±
>
> **--t**
>
> @@ -101,15 +112,39 @@ DPDK Test Suite support load suites from different folders, this will be helpful
>
> DPDK Test Suite support verbose mode. When enable this mode, all log messages will be output on screen and helpful for debug.
>
> +**--virttype**
> +
> +Choose virtualization hypervisor type. By now this configuration is useless.
> +
> +**--debug**
> +
> +DPDK Test Suite support debug mode. After keyboard ctrl+c message to DTS process, will run into this mode. User can do further debug by attached to sessions or call pdb module by interact interface.
> +
> +Debug interact support commands as below:
> +
> +.. code-block:: console
> +
> + help(): show help message
> + list(): list all connected sessions
> + connect(name): connect to session directly
> + exit(): exit dts
> + quit(): quit debug mode and into noraml mode
> + debug(): call python debug module
> +
> +**--debugcase**
> +
> +Another approach to run into debug mode. With this option on, DTS will hang and wait for user command before execution of each test case.
> +
> DPDK Release Preparation
> ------------------------
>
> -Firstly, you need to download the latest code from dpdk.org, then archive and compress it in the source code folder. After that, please move this zipped file to DPDK Test Suite folder. Once launch test framework, DPDK Test Suite will copy this zipped file to root folder on DUT. Finally this source code zip file will be unzipped and built.
> +Firstly, you need to download the latest code from dpdk.org, then archive and compress it into zipped file. After that, please move this zipped file to DPDK Test Suite "dep" folder. Once launch test framework, DPDK Test Suite will copy this zipped file to root folder on DUT. Finally this source code zip file will be unzipped and built.
>
> .. code-block:: console
>
> - [root@tester dcts]# ls
> - [root@tester dcts]# dts dpdk.tar.gz execution.cfg framework output test_plans tests
> + [root@tester dts]# ls
> + [root@tester dts]# conf dep doc dts executions framework output test_plans tests tools
> +
>
> If enables patch option, DPDK Test Suite will also make patch the unzipped folder and compile it.
>
> @@ -125,18 +160,20 @@ First of all, you must create a file named execution.cfg as below.
> .. code-block:: console
>
> [Execution1]
> - crbs=10.239.128.117
> + crbs=129.168.1.1
> test_suites=
> hello_world,
> l2fwd
> targets=
> x86_64-default-linuxapp-gcc,
> parameters=nic_type=niantic:func=true
> + scenario=pf_passthrough
>
> * crbs: IP address of the DUT CRB. The detail information of this CRB is defined in file crbs.py.
> * test_suites: defines list of test suites, which will plan to be executed.
> * gets: list of DPDK targets to be tested.
> * parameters: you can define multiple keywords
> +* scenario: Senario of DPDK virtualization environment for this execution.
>
> ¨C nic_type : is the type of the NIC to use. The types are defined in the file settings.py.
>
> @@ -144,39 +181,44 @@ First of all, you must create a file named execution.cfg as below.
>
> ¨C perf=true run only performance test
>
> -Then please add the detail information about your CRB in **crbs.py** as follows:
> +Then please add the detail information about your CRB in **conf/crbs.conf** as follows:
>
> .. code-block:: console
>
> - crbs = [
> - {'IP': '10.239.128.117',
> - 'name': 'CrownPassCRB1',
> - 'user': 'root',
> - 'pass': 'tester',
> - 'tester IP': '10.239.128.116',
> - IXIA: None,
> - 'memory channels': 4,
> - 'bypass core0': True},
> - ]
> + [192.168.1.1]
> + dut_ip=192.168.1.1
> + dut_user=root
> + dut_passwd=
> + os=linux
> + tester_ip=192.168.1.2
> + tester_passwd=
> + ixia_group=group1
> + channels=4
> + bypass_core0=True
> +
>
> .. table::
>
> +-----------------+----------------------------------------------------+
> | Item | description |
> +-----------------+----------------------------------------------------+
> - | IP | IP address of DUT |
> + | dut_ip | IP address of DUT |
> + +-----------------+----------------------------------------------------+
> + | dut_user | UserName of DPDK Test Suite used to login into DUT |
> +-----------------+----------------------------------------------------+
> - | name | Name of DUT |
> + | dut_passwd | Password of DPDK Test Suite used to login into DUT |
> +-----------------+----------------------------------------------------+
> - | user | UserName of DPDK Test Suite used to login into DUT |
> + | os | Distribution of operation system |
> +-----------------+----------------------------------------------------+
> - | pass | Password of DPDK Test Suite used to login into DUT |
> + | tester_ip | IP address of tester |
> +-----------------+----------------------------------------------------+
> - | Tester IP | IP address of tester |
> + | tester_passwd | Password to login into Tester |
> +-----------------+----------------------------------------------------+
> - | memory channels | number of memory channels for DPDK EAL |
> + | ixia_group | IXIA group name for this DUT |
> +-----------------+----------------------------------------------------+
> - | bypass core0 | skip the first core when initialize DPDK |
> + | channels | number of memory channels for DPDK EAL |
> + +-----------------+----------------------------------------------------+
> + | bypass_core0 | skip the first core when initialize DPDK |
> +-----------------+----------------------------------------------------+
>
> Launch DPDK Test Suite
> @@ -188,17 +230,18 @@ DPDK Test Suite will create communication sessions first.
>
> .. code-block:: console
>
> - DUT 10.239.128.117
> - DTS_DUT_CMD: ssh root@10.239.128.117
> - DTS_DUT_CMD: ssh root@10.239.128.117
> - DTS_TESTER_CMD: ssh root@10.239.128.116
> - DCS_TESTER_CMD: ssh root@10.239.128.116
> + DUT 192.168.1.1
> + INFO: ssh root@192.168.1.1
> + INFO: ssh root@192.168.1.1
> + INFO: ssh root@192.168.1.2
> + INFO: ssh root@192.168.1.2
>
>
> Then copy snapshot zipped dpdk source code to DUT.
> +
> .. code-block:: console
>
> - DTS_DUT_CMD: scp ../dpdk.tar.gz root@10.239.128.117:
> + DTS_DUT_CMD: scp dep/dpdk.tar.gz root@192.168.1.1:
>
> Collect CPU core and network device information of DUT and tester.
>
> @@ -239,7 +282,7 @@ Clean-up DUT and tester after all validation finished.
>
> .. code-block:: console
>
> - DTS_DUT_CMD: rmmod igb_uio
> + DTS_DUT_CMD: rmmod igb_uio
> DTS_DUT_CMD: modprobe igb
> DTS_DUT_CMD: modprobe ixgbe
> DTS_DUT_CMD: modprobe e1000e
> --
> 1.9.3
>
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [dts] [PATCH] Doc: update dts parameters
2015-09-16 15:28 ` Qiu, Michael
@ 2015-09-17 0:30 ` Liu, Yong
0 siblings, 0 replies; 3+ messages in thread
From: Liu, Yong @ 2015-09-17 0:30 UTC (permalink / raw)
To: Qiu, Michael; +Cc: dts
Michael, thanks for note that. I will send out V2 patch.
> -----Original Message-----
> From: Qiu, Michael
> Sent: Wednesday, September 16, 2015 11:28 PM
> To: Liu, Yong
> Cc: dts@dpdk.org
> Subject: Re: [dts] [PATCH] Doc: update dts parameters
>
>
> One line may be typo error, 129.168 should be 192.168 if am I right.
>
> Thanks,
> Michael
>
>
> > 在 2015年9月16日，下午11:02，Yong Liu <yong.liu@intel.com> 写道：
> >
> > From: Marvin Liu <yong.liu@intel.com>
> >
> > Add explain for new added parameters "virttype", "debug" and "debugcase".
> > CRB configuration file moved from python file to plain txt file.
> >
> > Signed-off-by: Marvin Liu <yong.liu@intel.com>
> >
> > diff --git a/doc/dts_gsg/conf.py b/doc/dts_gsg/conf.py
> > index 9213b01..6a8c679 100644
> > --- a/doc/dts_gsg/conf.py
> > +++ b/doc/dts_gsg/conf.py
> > @@ -1,5 +1,5 @@
> > # BSD LICENSE
> > -# Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
> > +# Copyright(c) 2010-2015 Intel Corporation. All rights reserved.
> > # All rights reserved.
> > #
> > # Redistribution and use in source and binary forms, with or without
> > @@ -32,7 +32,7 @@ import subprocess
> >
> > project = 'DPDK Test Suite'
> >
> > -copyright = '2014, dpdk.org'
> > +copyright = '2015, dpdk.org'
> >
> > #version = subprocess.check_output(["make","-sRrC","../../",
> "showversion"])
> >
> > diff --git a/doc/dts_gsg/config.rst b/doc/dts_gsg/config.rst
> > index 7276681..f5b2bc7 100644
> > --- a/doc/dts_gsg/config.rst
> > +++ b/doc/dts_gsg/config.rst
> > @@ -9,10 +9,11 @@ For Example, please see specific usage, you can get
> these information via DPDK T
> >
> > .. code-block:: console
> >
> > - usage: main.py [-h] [--config-file CONFIG_FILE] [--git GIT] [--patch
> PATCH]
> > - [--snapshot SNAPSHOT] [--output OUTPUT] [-s] [-r] [-p
> PROJECT]
> > - [--suite-dir SUITE_DIR] [-t TEST_CASES [TEST_CASES ...]]
> > - [-d DIR]
> > + usage: main.py [-h] [--config-file CONFIG_FILE] [--git GIT] [--
> patch PATCH]
> > + [--snapshot SNAPSHOT] [--output OUTPUT] [-s] [-r] [-
> p PROJECT]
> > + [--suite-dir SUITE_DIR] [-t TEST_CASES] [-d DIR] [-v]
> > + [--virttype VIRTTYPE] [--debug] [--debugcase]
> > +
> >
> > DPDK Test Suite supports the following parameters:
> >
> > @@ -23,16 +24,16 @@ DPDK Test Suite supports the following parameters:
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > | -h,--help | show this help message and exit
> | |
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > - | --config-file CONFIG_FILE | configuration file that describes the
> test cases, | ../execution.cfg |
> > + | --config-file CONFIG_FILE | configuration file that describes the
> test cases, | execution.cfg |
> > | | DUTs and targets
> | |
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > | --git GIT | Indicate git label to use as input
> | None |
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > | --patch PATCH | apply a patch to the package under
> test | None |
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > - | --snapshot SNAPSHOT | snapshot .tgz file to use as input
> | ../dpdk.tar.gz |
> > + | --snapshot SNAPSHOT | snapshot .tgz file to use as input
> | dep/dpdk.tar.gz |
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > - | --output OUTPUT | Output directory where DPDK Test
> Suite log and | ../output |
> > + | --output OUTPUT | Output directory where DPDK Test
> Suite log and | output |
> > | | result saved
> | |
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > | -s --skip-setup | Skips all possible setup steps done on
> both DUT | |
> > @@ -53,12 +54,21 @@ DPDK Test Suite supports the following parameters:
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > | -d DIR --dir DIR | Output directory where dpdk package is
> extracted | dpdk |
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > - | --suite-dir | Test suite directory where test
> suites will be | ../tests |
> > + | --suite-dir | Test suite directory where test
> suites will be | tests |
> > | | imported
> | |
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > | -v, --verbose | Enable verbose output, all log shown
> on screen | |
> > +---------------------------+---------------------------------------
> ------------+------------------+
> > -
> > + | --virttype | Set virtualization hypervisor type.
> Support kvm | |
> > + | | and libvirtd by now.
> | |
> > + +---------------------------+--------------------------------------
> -------------+------------------+
> > + | --debug | Enable debug mode, running process
> can be | |
> > + | | interrupted and enter debug mode.
> | |
> > + +---------------------------+--------------------------------------
> -------------+------------------+
> > + | --debugcase | Enter into debug mode before running
> every test | |
> > + | | case.
> | |
> > + +---------------------------+--------------------------------------
> -------------+------------------+
> > +
> > Please see more information about some critical parameters as the
> following:
> >
> > **--config-file**
> > @@ -72,6 +82,7 @@ When we use ?-git parameter, DPDK Test Suite will
> clone the source code from d
> > **--patch**
> >
> > DPDK Test Suite also support apply specified patch list by --patch
> parameter before build DPDK packet.
> > +
> > **--skip-setup**
> >
> > If DPDK source code doesn’t changed, you can use --skip-setup to skip
> unzip and compilation of DPDK source code, just reuse original source code.
> > @@ -85,7 +96,7 @@ Parameter ?-project can load customized project model
> and do its own project i
> > If we perform multiple validation at the same time, result files in
> output folder maybe overwritten. Then we can use ?-output parameter to
> specify the output folder and save execution log and result files. This
> option will make sure that all test result will be stored in the different
> excel files and rst files, doesn’t conflict each other.
> >
> > .. note::
> > - The current working folder of DPDK Test Suite is “framework” and
> default output folder is “../output”
> > + The current working folder of DPDK Test Suite is "DTS root
> directory" and default output folder is “output”
> >
> > **--t**
> >
> > @@ -101,15 +112,39 @@ DPDK Test Suite support load suites from different
> folders, this will be helpful
> >
> > DPDK Test Suite support verbose mode. When enable this mode, all log
> messages will be output on screen and helpful for debug.
> >
> > +**--virttype**
> > +
> > +Choose virtualization hypervisor type. By now this configuration is
> useless.
> > +
> > +**--debug**
> > +
> > +DPDK Test Suite support debug mode. After keyboard ctrl+c message to
> DTS process, will run into this mode. User can do further debug by
> attached to sessions or call pdb module by interact interface.
> > +
> > +Debug interact support commands as below:
> > +
> > +.. code-block:: console
> > +
> > + help(): show help message
> > + list(): list all connected sessions
> > + connect(name): connect to session directly
> > + exit(): exit dts
> > + quit(): quit debug mode and into noraml mode
> > + debug(): call python debug module
> > +
> > +**--debugcase**
> > +
> > +Another approach to run into debug mode. With this option on, DTS will
> hang and wait for user command before execution of each test case.
> > +
> > DPDK Release Preparation
> > ------------------------
> >
> > -Firstly, you need to download the latest code from dpdk.org, then
> archive and compress it in the source code folder. After that, please move
> this zipped file to DPDK Test Suite folder. Once launch test framework,
> DPDK Test Suite will copy this zipped file to root folder on DUT. Finally
> this source code zip file will be unzipped and built.
> > +Firstly, you need to download the latest code from dpdk.org, then
> archive and compress it into zipped file. After that, please move this
> zipped file to DPDK Test Suite "dep" folder. Once launch test framework,
> DPDK Test Suite will copy this zipped file to root folder on DUT. Finally
> this source code zip file will be unzipped and built.
> >
> > .. code-block:: console
> >
> > - [root@tester dcts]# ls
> > - [root@tester dcts]# dts dpdk.tar.gz execution.cfg framework
> output test_plans tests
> > + [root@tester dts]# ls
> > + [root@tester dts]# conf dep doc dts executions framework output
> test_plans tests tools
> > +
> >
> > If enables patch option, DPDK Test Suite will also make patch the
> unzipped folder and compile it.
> >
> > @@ -125,18 +160,20 @@ First of all, you must create a file named
> execution.cfg as below.
> > .. code-block:: console
> >
> > [Execution1]
> > - crbs=10.239.128.117
> > + crbs=129.168.1.1
> > test_suites=
> > hello_world,
> > l2fwd
> > targets=
> > x86_64-default-linuxapp-gcc,
> > parameters=nic_type=niantic:func=true
> > + scenario=pf_passthrough
> >
> > * crbs: IP address of the DUT CRB. The detail information of this CRB
> is defined in file crbs.py.
> > * test_suites: defines list of test suites, which will plan to be
> executed.
> > * gets: list of DPDK targets to be tested.
> > * parameters: you can define multiple keywords
> > +* scenario: Senario of DPDK virtualization environment for this
> execution.
> >
> > ? nic_type : is the type of the NIC to use. The types are defined in
> the file settings.py.
> >
> > @@ -144,39 +181,44 @@ First of all, you must create a file named
> execution.cfg as below.
> >
> > ? perf=true run only performance test
> >
> > -Then please add the detail information about your CRB in **crbs.py** as
> follows:
> > +Then please add the detail information about your CRB in
> **conf/crbs.conf** as follows:
> >
> > .. code-block:: console
> >
> > - crbs = [
> > - {'IP': '10.239.128.117',
> > - 'name': 'CrownPassCRB1',
> > - 'user': 'root',
> > - 'pass': 'tester',
> > - 'tester IP': '10.239.128.116',
> > - IXIA: None,
> > - 'memory channels': 4,
> > - 'bypass core0': True},
> > - ]
> > + [192.168.1.1]
> > + dut_ip=192.168.1.1
> > + dut_user=root
> > + dut_passwd=
> > + os=linux
> > + tester_ip=192.168.1.2
> > + tester_passwd=
> > + ixia_group=group1
> > + channels=4
> > + bypass_core0=True
> > +
> >
> > .. table::
> >
> > +-----------------+-------------------------------------------------
> ---+
> > | Item | description
> |
> > +-----------------+-------------------------------------------------
> ---+
> > - | IP | IP address of DUT
> |
> > + | dut_ip | IP address of DUT
> |
> > + +-----------------+------------------------------------------------
> ----+
> > + | dut_user | UserName of DPDK Test Suite used to login into
> DUT |
> > +-----------------+-------------------------------------------------
> ---+
> > - | name | Name of DUT
> |
> > + | dut_passwd | Password of DPDK Test Suite used to login into
> DUT |
> > +-----------------+-------------------------------------------------
> ---+
> > - | user | UserName of DPDK Test Suite used to login into
> DUT |
> > + | os | Distribution of operation system
> |
> > +-----------------+-------------------------------------------------
> ---+
> > - | pass | Password of DPDK Test Suite used to login into
> DUT |
> > + | tester_ip | IP address of tester
> |
> > +-----------------+-------------------------------------------------
> ---+
> > - | Tester IP | IP address of tester
> |
> > + | tester_passwd | Password to login into Tester
> |
> > +-----------------+-------------------------------------------------
> ---+
> > - | memory channels | number of memory channels for DPDK EAL
> |
> > + | ixia_group | IXIA group name for this DUT
> |
> > +-----------------+-------------------------------------------------
> ---+
> > - | bypass core0 | skip the first core when initialize DPDK
> |
> > + | channels | number of memory channels for DPDK EAL
> |
> > + +-----------------+------------------------------------------------
> ----+
> > + | bypass_core0 | skip the first core when initialize DPDK
> |
> > +-----------------+-------------------------------------------------
> ---+
> >
> > Launch DPDK Test Suite
> > @@ -188,17 +230,18 @@ DPDK Test Suite will create communication sessions
> first.
> >
> > .. code-block:: console
> >
> > - DUT 10.239.128.117
> > - DTS_DUT_CMD: ssh root@10.239.128.117
> > - DTS_DUT_CMD: ssh root@10.239.128.117
> > - DTS_TESTER_CMD: ssh root@10.239.128.116
> > - DCS_TESTER_CMD: ssh root@10.239.128.116
> > + DUT 192.168.1.1
> > + INFO: ssh root@192.168.1.1
> > + INFO: ssh root@192.168.1.1
> > + INFO: ssh root@192.168.1.2
> > + INFO: ssh root@192.168.1.2
> >
> >
> > Then copy snapshot zipped dpdk source code to DUT.
> > +
> > .. code-block:: console
> >
> > - DTS_DUT_CMD: scp ../dpdk.tar.gz root@10.239.128.117:
> > + DTS_DUT_CMD: scp dep/dpdk.tar.gz root@192.168.1.1:
> >
> > Collect CPU core and network device information of DUT and tester.
> >
> > @@ -239,7 +282,7 @@ Clean-up DUT and tester after all validation
> finished.
> >
> > .. code-block:: console
> >
> > - DTS_DUT_CMD: rmmod igb_uio
> > + DTS_DUT_CMD: rmmod igb_uio
> > DTS_DUT_CMD: modprobe igb
> > DTS_DUT_CMD: modprobe ixgbe
> > DTS_DUT_CMD: modprobe e1000e
> > --
> > 1.9.3
> >
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2015-09-17 0:30 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-09-16 15:01 [dts] [PATCH] Doc: update dts parameters Yong Liu
2015-09-16 15:28 ` Qiu, Michael
2015-09-17 0:30 ` Liu, Yong
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).