From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id AE932A0517; Wed, 10 Jun 2020 07:05:06 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 96C031DB8; Wed, 10 Jun 2020 07:05:06 +0200 (CEST) Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by dpdk.org (Postfix) with ESMTP id 5090D1150 for ; Wed, 10 Jun 2020 07:05:04 +0200 (CEST) IronPort-SDR: yCadwQRaD2Yub3WQkZ7LSO5f/lzrWUtb4V7sKYC5OFli2Wkwiuc9OgLnUjvW57F6mZcbV27u9M SIhdebRpdhKQ== X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga005.jf.intel.com ([10.7.209.41]) by orsmga103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 Jun 2020 22:05:03 -0700 IronPort-SDR: vAde162+VoLFC74SnhPV4/YDFBHiBdiSTXVCyO+ve1PK75xiVGveKA9fZ0E0zT+lawmFRs/64e kGkfga3K+Eqg== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.73,494,1583222400"; d="scan'208";a="447365183" Received: from dpdk-lihong-ub1604.sh.intel.com ([10.67.118.174]) by orsmga005.jf.intel.com with ESMTP; 09 Jun 2020 22:04:59 -0700 From: lihong To: dts@dpdk.org, zhaoyan.chen@intel.com Cc: lihong Date: Wed, 10 Jun 2020 05:33:34 +0800 Message-Id: <1591738414-24304-1-git-send-email-lihongx.ma@intel.com> X-Mailer: git-send-email 2.7.4 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Subject: [dts] [PATCH V3] modify document according to current dts and dpdk support 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: , Errors-To: dts-bounces@dpdk.org Sender: "dts" * V3: use requirements.txt install python library 1. now dts support python3, so use python3 instead of python2 2. update os of dpdk support 3. use ubuntu 18.04 instead of fedora 20 as tester env os 4. update support version of python library Signed-off-by: lihong --- doc/dts_gsg/sys_reqs.rst | 38 ++++++++++++++------------------------ doc/dts_gsg/trex_known_issue.rst | 4 ++-- requirements.txt | 4 ++-- 3 files changed, 18 insertions(+), 28 deletions(-) diff --git a/doc/dts_gsg/sys_reqs.rst b/doc/dts_gsg/sys_reqs.rst index cbfc040..77022e2 100644 --- a/doc/dts_gsg/sys_reqs.rst +++ b/doc/dts_gsg/sys_reqs.rst @@ -18,7 +18,7 @@ Setup Tester Environment .. note:: - Please install the latest Fedora distribution on the tester before install DPDK Test Suite on tester. Currently we recommend Fedora 20 for tester. The setup instruction and required packages may be different on different operation systems. + Please install the latest ubuntu distribution on the tester before install DPDK Test Suite on tester. Currently we recommend ubuntu 18.04 for tester. The setup instruction and required packages may be different on different operation systems. To enable tester environment, you need to install script language, tool chain and third party packet generator, etc. @@ -30,8 +30,8 @@ Since DPDK Test Suite Tester communicates with DUT via SSH, please install and s .. code-block:: console - yum install sshd # download / install ssh software - systemctl enable sshd.service # start ssh service + apt-get install sshd # download / install ssh software + systemctl enable ssh # start ssh service For create authorized login session, user needs to generate RSA authentication keys to ssh connection. @@ -47,7 +47,7 @@ Since some third party tools required TCL (Tool Command Language) supports, plea .. code-block:: console - yum install tcl # download / install tcl software + apt-get install tcl # download / install tcl software Install Third Party python modules ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -65,12 +65,8 @@ Please see installation instruction as the following: .. code-block:: console - yum install python-xlwt - yum install python-pexpect - yum install numpy - yum install python-docutils - yum install pcapy - yum install python-xlrd + apt-get install python3-pip + pip3 install -r ../../requirements.txt Setup and configure Scapy ~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -80,14 +76,7 @@ DTS uses python module scapy to forge or decode packets of a wide number of prot .. code-block:: console - yum install scapy - -Fedora20 default kernel will strip vlan header automatically and thus it will cause that scapy can’t detect vlan packet normally. To solve this issue, we need to configure scapy use libpcap which is a low-level network traffic monitoring tool. - -.. code-block:: console - - vim /usr/lib/python2.7/site-packages/scapy/config.py # open configure python files - use_pcap = True # find use_pcap and set it to True + pip3 install scapy Install DPDK Test Suite on tester ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -119,12 +108,13 @@ Setup Target Environment This section describes how to deploy DPDK Test Suite packages into DUT target.So far, DPDK Test Suite supports the following OS on DUT: -* Fedora18/19/20/23/24/25 -* Ubuntu12.04/14.04/16.04 -* WindRiver 6.0/7.0 -* FreeBSD 10 -* RedHat 6.5/7.0/7.3 -* SUSE 11 +* Fedora 32 +* Ubuntu 16.04/18.04/20.04 +* FreeBSD 12.1 +* RedHat 7.7/8.0 +* SUSE 15 +* Centos 7.7/8.0 +* OpenWRT 19.07 Before run DPDK Test Suite on target, we need to configure target environment, it includes BIOS setting, Network configure, compiler environment, etc. diff --git a/doc/dts_gsg/trex_known_issue.rst b/doc/dts_gsg/trex_known_issue.rst index 7807dd2..8a84e7c 100644 --- a/doc/dts_gsg/trex_known_issue.rst +++ b/doc/dts_gsg/trex_known_issue.rst @@ -91,10 +91,10 @@ resolved scheme --------------- #. backup your scapy:: - cp -fr /usr/lib/python2.7/site-packages/scapy /usr/lib/python2.7/site-packages/scapy_backup + cp -fr /usr/lib/python3/site-packages/scapy /usr/lib/python3/site-packages/scapy_backup #. unify scapy version with trex:: - cp -fr /opt/trex/v2.41/trex_client/external_libs/scapy-2.3.1/python2/scapy /usr/lib/python2.7/site-packages/scapy + cp -fr /opt/trex/v2.41/trex_client/external_libs/scapy-2.3.1/python3/scapy /usr/lib/python3/site-packages/scapy other issues ============ diff --git a/requirements.txt b/requirements.txt index d215ce7..59b3d8e 100644 --- a/requirements.txt +++ b/requirements.txt @@ -32,8 +32,8 @@ xlwt==1.3.0 pexpect==4.7.0 -numpy==1.16.4 +numpy==1.18.5 docutils pcapy xlrd -scapy==2.3.3 +scapy==2.4.3 -- 2.7.4