From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-qt0-f227.google.com (mail-qt0-f227.google.com [209.85.216.227]) by dpdk.org (Postfix) with ESMTP id 5AEB95F36 for ; Thu, 29 Mar 2018 21:16:47 +0200 (CEST) Received: by mail-qt0-f227.google.com with SMTP id f8so7343803qtg.12 for ; Thu, 29 Mar 2018 12:16:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=iol.unh.edu; s=unh-iol; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=BDU5qar/GosYs2XvmmClDGkt+H5oMEkMH4f2qNrGTbo=; b=BWmotkdciqlqoIK+dnSD1lgqdNu1HtOaDdUF5T5VaElPm4SPu+NYPM0KcwzysW5R45 o0tAqI6RT/S8vnX5IDX4ExebG6wb+9162gRMjklnrRiCv6xftqQ6xzdBk+eVUyFX/IYF mOYbUoX0JeKsGMXmSCZqNhYJuxI+9v9ocX0gk= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=BDU5qar/GosYs2XvmmClDGkt+H5oMEkMH4f2qNrGTbo=; b=eu6LFRT1ZkGeOoXOVW238djNoueciSXn6Vo4gE6EJzCZ/f4XoqJbMzcfuZD/H1uMGd 1LD1zrc/tUboKw4IYK65zWoY7ki4UvU3nVQtoBT8mKh21UhGPCZqSL6XBevngL6WUnZZ cGlESfI7MfaijvjaKTB43qMBYFXXuts5i/Q3D+DCQNYn/mtNT6HU/dIzvqwcGDg7p54p SZBYELDOS39lmW1lZcekNcSWBfRp1hQd8wYeJ9TMXRNWzOr7niki6dJMEUnwn16uUGfd 5/qDaX2AHymZcAjS/bhu0D+VlAGXocsmWI23ouLEQoZHlHBj4Vd5v1D0gniwkZ7wrbKE 4WDw== X-Gm-Message-State: AElRT7Gds2LyjKOSM3PXBOIO6/gDkXnFI6zjziE0OX149fQmR6p5V4IP JMX41hl2Z7BgfH57hldrlljARjh/bQu5tc0+rU4yQIn4KGDTWbzniK26t65ETBdwT9FhYtcizGZ aa0MNVCjTvHd4aGVu856zbBhNXx7xZ48tdAtBX+mcQFN/pefYuyw2ZgazW55vsPixwvgc0TFUcX ajNuwvgxpYsQKShQ== X-Google-Smtp-Source: AIpwx4+To/XHLV1VQvcJxv1mOC0nwb0a8MPRXOapV3LdR2FzXIwMVti3qRd/Flz4Hl6tXrGfbtASW4HX6n2N X-Received: by 10.200.26.69 with SMTP id q5mr12824473qtk.174.1522351006797; Thu, 29 Mar 2018 12:16:46 -0700 (PDT) Received: from postal.iol.unh.edu (postal.iol.unh.edu. [2606:4100:3880:1234::84]) by smtp-relay.gmail.com with ESMTPS id s204sm1281893qke.9.2018.03.29.12.16.46 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 29 Mar 2018 12:16:46 -0700 (PDT) X-Relaying-Domain: iol.unh.edu Received: from groose.ofa (unknown [IPv6:2606:4100:3880:1240:cc3b:885c:7cb:4a8e]) by postal.iol.unh.edu (Postfix) with ESMTP id 1CD786045DC6; Thu, 29 Mar 2018 15:16:46 -0400 (EDT) From: Patrick MacArthur To: dts@dpdk.org Cc: dpdklab@iol.unh.edu Date: Thu, 29 Mar 2018 15:16:04 -0400 Message-Id: <20180329191605.5404-7-pmacarth@iol.unh.edu> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20180329191605.5404-1-pmacarth@iol.unh.edu> References: <20180329191605.5404-1-pmacarth@iol.unh.edu> Subject: [dts] [PATCH for-next v3 6/7] doc: Add T-Rex section to documentation 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: Thu, 29 Mar 2018 19:16:47 -0000 Explain how DTS expects T-Rex to be set up; in particular, explain that T-Rex should be started in Layer 2 mode as opposed to Layer 3 mode, to avoid the need to resolve the destination MAC address. Signed-off-by: Patrick MacArthur --- doc/dts_gsg/index.rst | 1 + doc/dts_gsg/trex.rst | 27 +++++++++++++++++++++++++++ test_plans/nic_single_core_perf_test_plan.rst | 2 ++ 3 files changed, 30 insertions(+) create mode 100644 doc/dts_gsg/trex.rst diff --git a/doc/dts_gsg/index.rst b/doc/dts_gsg/index.rst index fbd16dc053b0..d21e3343fa14 100644 --- a/doc/dts_gsg/index.rst +++ b/doc/dts_gsg/index.rst @@ -42,3 +42,4 @@ Getting Started Guide virtualization scenario multiple_vm + trex diff --git a/doc/dts_gsg/trex.rst b/doc/dts_gsg/trex.rst new file mode 100644 index 000000000000..ab6dfa520feb --- /dev/null +++ b/doc/dts_gsg/trex.rst @@ -0,0 +1,27 @@ +Configuring T-Rex for DPDK Test Suite +===================================== + +DPDK can utilize T-Rex as a traffic generator in stateless Layer 2 mode. +This is supported for the ``nic_single_core_perf`` test but may be usable +by other tests in the future. + +An example T-Rex configuration that accomplishes this is shown as follows: + +.. code-block:: console + + - port_limit: 2 + version: 2 + interfaces: ["03:00.0", "03:00.1"] + port_info: + - src_mac: "aa:bb:cc:dd:ee:ff" + dest_mac: "ff:ee:dd:cc:bb:aa" + - src_mac: "ff:ee:dd:cc:bb:aa" + dest_mac: "aa:bb:cc:dd:ee:ff" + +DTS may use a standalone T-Rex instance, or can be configured to start T-Rex +itself using the settings in ``pktgen.conf``. + +To read more about T-Rex stateless mode, read the +`T-Rex stateless support guide`_. + +:: _T-Rex stateless support guide: https://trex-tgn.cisco.com/trex/doc/trex_stateless.html diff --git a/test_plans/nic_single_core_perf_test_plan.rst b/test_plans/nic_single_core_perf_test_plan.rst index 912c60d57097..428d5db29fbf 100644 --- a/test_plans/nic_single_core_perf_test_plan.rst +++ b/test_plans/nic_single_core_perf_test_plan.rst @@ -49,6 +49,8 @@ Prerequisites dts (next branch): git clone http://dpdk.org/git/tools/dts, then "git checkout next" Trex code: http://trex-tgn.cisco.com/trex/release/v2.26.tar.gz + (to be run in stateless Layer 2 mode, see section in + Getting Started Guide for more details) python-prettytable: apt install python-prettytable (for ubuntu os) or dnf install python-prettytable (for fedora os). -- 2.14.1