src/plugins/nat/extras/README

   1 NAT44 performance testing with TRex
   2
   3 Setup:
   4
   5         TRex host                             VPP host
   6 ----------------------------      ---------------------------------------------
   7 |                          |      |                                           |
   8 | 04:00.0/172.16.1.2/port 0|<---->|04:00.1/172.16.1.1/TenGigabitEthernet4/0/1 |
   9 |                          |      |                                           |
  10 | 04:00.1/172.16.2.2/port 1|<---->|04:00.0/172.16.2.1/TenGigabitEthernet4/0/0 |
  11 |                          |      |                                           |
  12 ----------------------------      ---------------------------------------------
  13
  14 How to use TRex:
  15 1) Copy configuration file to /etc/trex_cfg.yaml or use --cfg option in next step
  16 2) Start TRex as a server 'sudo ./t-rex-64 -i'
  17 3) Connect with console './trex-console'
  18 4) Resolve destination addresses 'reset ; service ; arp ; service --off'
  19 5) Start traffic to open sessions in2out 'start -f stl/nat_10ks.py -m 10mbps -p 1' or out2in 'start -f stl/nat_out2in_10ks.py -m 10mbps -p 0'
  20 6) After all sessions are opened update stream rate to 100% 'update -a -m 100%'
  21 7) Show dynamic statistic 'tui'
  22 8) Exit dynamic statistic 'q'
  23 9) Stop traffic 'stop -a'
  24 10) Sessions per second (slowpath) test 'reset ; service ; arp ; service --off; start -f stl/nat_ses_open.py -m 100% -p 1 -d 1' and 'show nat44' in VPP CLI to see number of opened sessions
  25
  26 VPP config files:
  27 in2out testing nat_dynamic
  28 for out2in testing generate config using 'nat_static_gen_cfg.py N'
  29
  30 References:
  31 https://github.com/cisco-system-traffic-generator/trex-core/blob/master/doc/trex_stateless.asciidoc
  32 https://github.com/cisco-system-traffic-generator/trex-core/blob/master/doc/trex_console.asciidoc
  33 https://wiki.fd.io/view/VPP/NAT#NAT44