summaryrefslogtreecommitdiffstats
path: root/src/plugins/nat/extras/README
diff options
context:
space:
mode:
authorMatus Fabian <matfabia@cisco.com>2017-09-27 04:44:08 -0700
committerDave Wallace <dwallacelf@gmail.com>2017-12-18 17:18:22 +0000
commite4d12836515765a6f7c6a2f67dbacbdef2975024 (patch)
treea8f5bcbd3c0b2df388f6a42103f87ccca2654fc1 /src/plugins/nat/extras/README
parentff9f040e630510b5254eafa0df35d7e6fb16ffc3 (diff)
NAT: Add performance testing TRex scripts and config (VPP-832)
Change-Id: I149a20f183b836db4c32fb4e4a8438b3a14c1c26 Signed-off-by: Matus Fabian <matfabia@cisco.com>
Diffstat (limited to 'src/plugins/nat/extras/README')
-rw-r--r--src/plugins/nat/extras/README33
1 files changed, 33 insertions, 0 deletions
diff --git a/src/plugins/nat/extras/README b/src/plugins/nat/extras/README
new file mode 100644
index 00000000000..0c9c392eb85
--- /dev/null
+++ b/src/plugins/nat/extras/README
@@ -0,0 +1,33 @@
+NAT44 performance testing with TRex
+
+Setup:
+
+ TRex host VPP host
+---------------------------- ---------------------------------------------
+| | | |
+| 04:00.0/172.16.1.2/port 0|<---->|04:00.1/172.16.1.1/TenGigabitEthernet4/0/1 |
+| | | |
+| 04:00.1/172.16.2.2/port 1|<---->|04:00.0/172.16.2.2/TenGigabitEthernet4/0/0 |
+| | | |
+---------------------------- ---------------------------------------------
+
+How to use TRex:
+1) Copy configuration file to /etc/trex_cfg.yaml or use --cfg option in next step
+2) Start TRex as a server 'sudo ./t-rex-64 -i'
+3) Connect with console './trex-console'
+4) Resolve destination addresses 'reset ; service ; arp ; service --off'
+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'
+6) After all sessions are opened update stream rate to 100% 'update -a -m 100%'
+7) Show dynamic statistic 'tui'
+8) Exit dynamic statistic 'q'
+9) Stop traffic 'stop -a'
+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
+
+VPP config files:
+in2out testing nat_dynamic
+for out2in testing generate config using 'nat_static_gen_cfg.py N'
+
+References:
+https://github.com/cisco-system-traffic-generator/trex-core/blob/master/doc/trex_stateless.asciidoc
+https://github.com/cisco-system-traffic-generator/trex-core/blob/master/doc/trex_console.asciidoc
+https://wiki.fd.io/view/VPP/NAT#NAT44