Skip to content
Hanoh Haim edited this page Nov 26, 2017 · 20 revisions

Release Notes

How to build TRex

cd linux_dpdk
./b configure  (only once)
./b build

Build Output will be in "scripts" folder

more options

./b configure --sanitized
./b configure --gcc6
./b configure --no-mlx
./b configure --with-ntacc

How to debug with gdb TRex

from "scripts" folder

./t-rex-64-debug-gdb [args]

this script will load set the patch to so and run gdb

How to build TRex Simulator

cd linux
./b configure  (only once)
./b build
-----

Build Output will be in "scripts" folder

= Documentation

link:https://trex-tgn.cisco.com/trex/doc/[https://trex-tgn.cisco.com/trex/doc/]

= Presentations

Stateless support: link:[http://www.slideshare.net/HanochHaim/trex-realistic-traffic-generator-stateless-support]

DPDK 2015 summit: link:[http://www.slideshare.net/harryvanhaaren/trex-traffig-gen-hanoch-haim]

Video of DPDK 2015 summit: link:[https://www.youtube.com/watch?v=U0gRalB7DOs]

Presentation-html: link:[http://trex-tgn.cisco.com/trex/doc/trex_preso.html]

= Manual

link:http://trex-tgn.cisco.com/trex/doc/trex_manual.html[manual-html]

link:http://trex-tgn.cisco.com/trex/doc/trex_book.pdf[manual-pdf]

= Download
link:http://trex-tgn.cisco.com/trex/release/latest[latest-pkg]

= TRex on your laptop (using VirtualBox OVA)

link:http://trex-tgn.cisco.com/trex/doc/trex_vm_manual.html[manual-html]

link:http://trex-tgn.cisco.com/trex/doc/trex_vm_manual.pdf[manual-pdf]

= TRex Sandbox

link:https://devnetsandbox.cisco.com/RM/Diagram/Index/2ec5952d-8bc5-4096-b327-c294acd9512d?diagramType=Topology[Cisco DevNet]

= Python API

link:http://trex-tgn.cisco.com/trex/doc/trex_control_plane_design_phase1.html[Overview]

link:http://trex-tgn.cisco.com/trex/doc/cp_docs[python-html]

= Running regression

In case you did some changes in code and/or want to check some new NIC, you can run our regression:

. Create TRex config file:
    sudo ./dpdk_setup_ports.py -i
. Run TRex daemon:
    sudo ./trex_daemon_server start
. Make a copy of directory with setup parameters:
    automation/regression/setups/trex07
. Update yaml files in that directory if needed
. Run full regression: +
./run_regression --cfg ./automation/regression/setups/<new dir>

[NOTE]
=====================================
* Running specific test: +
./run_regression --cfg ./automation/regression/setups/<new dir> -t <part of test name>

* Running *only stateless tests* can be done without waiting for TRex server to be brought up each time: +
** Run in one shell the interactive server: sudo ./t-rex-64 -i
** Run in another shell the regression with flags: --stl --no-daemon

* Specifying setup directory can be done only once with environment variable SETUP_DIR, for example: +
export SETUP_DIR=trex07
=====================================