View source for VPP/QuickTrexSetup


=== Quick trex setup ===

* Ensure that the host can build vpp

* Clone trex source from gerrit.fd.io: 

 git clone https://gerrit.fd.io/r/trex

* Build trex; artifacts in .../scripts

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

* Make sure that the igb_uio module is installed

 # cd .../scripts  
 
 # insmod ko/src/igb_uio.ko

* Use scripts/dpdk_nic_bind.py to bind interfaces to the igb_uio driver

* Create /etc/trex_cfg.yaml, edit the interface list / number of queues to match interfaces bound in the previous step

 - version       : 2 # version 2 of the configuration file 
   interfaces    : ["01:00.0","01:00.1"]  
   port_limit      : 2 # number of ports to use valid is 2,4,6,8,10,12 

* Run the trex server

 ./t-rex-64 -i

* Run the trex console

 ./trex-console

==== Configure ports ====

* Set up ip4 source and dest addresses e.g. on two ports

 trex>portattr -p 0 --ipv4 16.0.0.1
 Applying attributes on port(s) [0]:                          [SUCCESS]
 
 trex>portattr -p 1 --ipv4 48.0.0.1
 Applying attributes on port(s) [1]:                          [SUCCESS]
 
 trex>portattr -p 1 --dest 48.0.0.2
 Applying attributes on port(s) [1]:                          [SUCCESS]
 Resolving destination on port(s) [1]:                        [SUCCESS]
 Port 1 - Recieved ARP reply from: 48.0.0.2, hw: 90:e2:ba:5a:9e:1d
 
 trex>portattr -p 0 --dest 16.0.0.2
 Applying attributes on port(s) [0]:                          [SUCCESS]
 Resolving destination on port(s) [0]:                        [SUCCESS]
 Port 0 - Recieved ARP reply from: 16.0.0.2, hw: 90:e2:ba:5a:9e:1c
 
==== Run traffic ====

 start -f stl/udp_1pkt_simple.py -m 4mpps

To watch port stats, use the "tui" command. Tui needs a large xterm. It will complain if the xterm isn't large enough.

 trex> tui
 
 Global Statistics
 
 connection   : localhost, Port 4501                  total_tx_L2  : 4.62 Gb/sec                    
 version      : v2.11                                 total_tx_L1  : 6.06 Gb/sec                    
 cpu_util.    : 28.5% @ 1 cores (1 per port)          total_rx     : 4.62 Gb/sec                    
 rx_cpu_util. : 0.0%                                  total_pps    : 9.02 Mpkt/sec                  
 async_util.  : 0.1% / 1.91 KB/sec                    drop_rate    : 0.00 b/sec                     
                                                      queue_full   : 0 pkts                         
 
 Port Statistics
 
    port    |         0         |         1         |       total       
 ----------------------------------------------------------------------
 owner      |              root |              root |                   
 link       |                UP |                UP |                   
 state      |      TRANSMITTING |      TRANSMITTING |                   
 speed      |           10 Gb/s |           10 Gb/s |                   
 CPU util.  |             28.5% |             28.5% |                   
 --         |                   |                   |                   
 Tx bps L2  |         2.31 Gbps |         2.31 Gbps |         4.62 Gbps 
 Tx bps L1  |         3.03 Gbps |         3.03 Gbps |         6.06 Gbps 
 Tx pps     |         4.51 Mpps |         4.51 Mpps |         9.02 Mpps 
 Line Util. |           30.32 % |           30.32 % |                   
 ---        |                   |                   |                   
 Rx bps     |          0.00 bps |         4.62 Gbps |         4.62 Gbps 
 Rx pps     |          0.00 pps |         9.02 Mpps |         9.02 Mpps 
 ----       |                   |                   |                   
 opackets   |         158312807 |         158312781 |         316625588 
 ipackets   |                 1 |         316531433 |         316531434 
 obytes     |       10132019648 |       10132017984 |       20264037632 
 ibytes     |                64 |       20258012096 |       20258012160 
 tx-bytes   |          10.13 GB |          10.13 GB |          20.26 GB 
 rx-bytes   |              64 B |          20.26 GB |          20.26 GB 
 tx-pkts    |      158.31 Mpkts |      158.31 Mpkts |      316.63 Mpkts 
 rx-pkts    |            1 pkts |      316.53 Mpkts |      316.53 Mpkts 
 -----      |                   |                   |                   
 oerrors    |                 0 |                 0 |                 0 
 ierrors    |                 0 |                 0 |                 0