ligang/vpp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
vpp/docs/usecases/simpleperf/trex2.rst
Nathan Skrzypczak 9ad39c026c docs: better docs, mv doxygen to sphinx 
This patch refactors the VPP sphinx docs
in order to make it easier to consume
for external readers as well as VPP developers.

It also makes sphinx the single source
of documentation, which simplifies maintenance
and operation.

Most important updates are:

- reformat the existing documentation as rst
- split RELEASE.md and move it into separate rst files
- remove section 'events'
- remove section 'archive'
- remove section 'related projects'
- remove section 'feature by release'
- remove section 'Various links'
- make (Configuration reference, CLI docs,
  developer docs) top level items in the list
- move 'Use Cases' as part of 'About VPP'
- move 'Troubleshooting' as part of 'Getting Started'
- move test framework docs into 'Developer Documentation'
- add a 'Contributing' section for gerrit,
  docs and other contributer related infos
- deprecate doxygen and test-docs targets
- redirect the "make doxygen" target to "make docs"

Type: refactor

Change-Id: I552a5645d5b7964d547f99b1336e2ac24e7c209f
Signed-off-by: Nathan Skrzypczak <nathan.skrzypczak@gmail.com>
Signed-off-by: Andrew Yourtchenko <ayourtch@gmail.com>
2021-10-13 23:22:32 +00:00

193 lines
9.0 KiB
ReStructuredText
Raw Blame History

.. _trex2:
TRex Stateless Mode
===================
TRex can also be run in a stateless mode. For a detailed description of TRex stateless support
please refer to `TRex Stateless Support <https://trex-tgn.cisco.com/trex/doc/trex_stateless.html>`_.
In this section we show some simple examples using TRex stateless mode. These examples use
the configuration as shown in the section :ref:`trex`. These examples we will be using VMWare VMs.
To use TRex stateless mode we use 2 terminals on the TRex traffic generator node. One terminal will
be used for the TRex console and one to monitor the traffic.
In one of terminals start TRex in stateless mode. Use *Ctrl-C* to stop.
.. code-block:: console
# cd v2.46/
# ./trex -i
-Per port stats table
ports | 0 | 1 | 2 | 3
-----------------------------------------------------------------------------------------
opackets | 0 | 0 | 0 | 0
obytes | 0 | 0 | 0 | 0
ipackets | 6 | 6 | 5 | 5
ibytes | 384 | 384 | 320 | 320
ierrors | 0 | 0 | 0 | 0
oerrors | 0 | 0 | 0 | 0
Tx Bw | 0.00 bps | 0.00 bps | 0.00 bps | 0.00 bps
-Global stats enabled
Cpu Utilization : 0.0 %
Platform_factor : 1.0
Total-Tx : 0.00 bps
Total-Rx : 238.30 bps
Total-PPS : 0.00 pps
Total-CPS : 0.00 cps
Expected-PPS : 0.00 pps
Expected-CPS : 0.00 cps
Expected-BPS : 0.00 bps
Active-flows : 0 Clients : 0 Socket-util : 0.0000 %
Open-flows : 0 Servers : 0 Socket : 0 Socket/Clients : -nan
drop-rate : 0.00 bps
current time : 21.4 sec
test duration : 0.0 sec
*** TRex is shutting down - cause: 'CTRL + C detected'
All cores stopped !!
In the other terminal start the TRex console. With this console we will execute the TRex commands.
.. code-block:: console
# cd v2.46/
# ./trex -console
Using 'python' as Python interpreter
Connecting to RPC server on localhost:4501 [SUCCESS]
Connecting to publisher server on localhost:4500 [SUCCESS]
Acquiring ports [0, 1, 2, 3]: [SUCCESS]
Server Info:
Server version: v2.46 @ STL
Server mode: Stateless
Server CPU: 2 x Intel(R) Xeon(R) CPU E5-2680 v2 @ 2.80GHz
Ports count: 4 x 10Gbps @ VMXNET3 Ethernet Controller
-=TRex Console v3.0=-
Type 'help' or '?' for supported actions
trex>
Start some traffic using the **stl/imix.py** traffic profile.
.. code-block:: console
trex>start -f ./stl/imix.py -p 0 1 2 3 -m 9475mbps
Removing all streams from port(s) [0, 1, 2, 3]: [SUCCESS]
Attaching 3 streams to port(s) [0]: [SUCCESS]
Attaching 3 streams to port(s) [1]: [SUCCESS]
Attaching 3 streams to port(s) [2]: [SUCCESS]
Attaching 3 streams to port(s) [3]: [SUCCESS]
Starting traffic on port(s) [0, 1, 2, 3]: [SUCCESS]
80.94 [ms]
trex>
The **-f ./stl/imix.py** argument specifies the file that is used to create the
traffic profile. The argument **-p 0 1 2 3** specifies the ports to be used.
The argument **-m 9475mbps** the number of packets/sec to be used.
All the arguments can be displayed with the **-h** argument.
In the other terminal the display shows the statistics related the traffic flows.
.. code-block:: console
-Per port stats table
ports | 0 | 1 | 2 | 3
-----------------------------------------------------------------------------------------
opackets | 789907304 | 789894738 | 790017701 | 790017132
obytes | 285397726750 | 285392406754 | 285406864578 | 285405883070
ipackets | 1563501970 | 45 | 1563504693 | 44
ibytes | 564870783050 | 2880 | 564873491682 | 2816
ierrors | 15728759 | 0 | 15732451 | 0
oerrors | 0 | 0 | 0 | 0
Tx Bw | 606.55 Mbps | 606.19 Mbps | 606.25 Mbps | 606.51 Mbps
-Global stats enabled
Cpu Utilization : 100.0 % 2.4 Gb/core
Platform_factor : 1.0
Total-Tx : 2.43 Gbps
Total-Rx : 2.40 Gbps
Total-PPS : 841.44 Kpps
Total-CPS : 0.00 cps
Expected-PPS : 0.00 pps
Expected-CPS : 0.00 cps
Expected-BPS : 0.00 bps
Active-flows : 0 Clients : 0 Socket-util : 0.0000 %
Open-flows : 0 Servers : 0 Socket : 0 Socket/Clients : -nan
Total_queue_full : 6529970196
drop-rate : 0.00 bps
current time : 4016.8 sec
test duration : 0.0 sec
More statistics can be displayed on the TRex console using the **tui** command.
.. code-block:: console
trex>tui
Global Statistics
connection : localhost, Port 4501 total_tx_L2 : 2.45 Gb/sec
version : STL @ v2.46 total_tx_L1 : 2.59 Gb/sec
cpu_util. : 99.89% @ 2 cores (1 per port) total_rx : 2.42 Gb/sec
rx_cpu_util. : 4.03% / 837.39 Kpkt/sec total_pps : 846.96 Kpkt/sec
async_util. : 0.05% / 1.76 KB/sec drop_rate : 0 b/sec
queue_full : 42,750,771 pkts
Port Statistics
port | 0 | 1 | 2 | 3 | total
-----------+-------------------+-------------------+-------------------+-------------------+------------------
owner | root | root | root | root |
link | UP | UP | UP | UP |
state | TRANSMITTING | TRANSMITTING | TRANSMITTING | TRANSMITTING |
speed | 10 Gb/s | 10 Gb/s | 10 Gb/s | 10 Gb/s |
CPU util. | 99.89% | 99.89% | 99.89% | 99.89% |
-- | | | | |
Tx bps L2 | 612.76 Mbps | 613.07 Mbps | 612.52 Mbps | 612.77 Mbps | 2.45 Gbps
Tx bps L1 | 646.64 Mbps | 646.96 Mbps | 646.4 Mbps | 646.64 Mbps | 2.59 Gbps
Tx pps | 211.72 Kpps | 211.8 Kpps | 211.73 Kpps | 211.71 Kpps | 846.96 Kpps
Line Util. | 6.47 % | 6.47 % | 6.46 % | 6.47 % |
--- | | | | |
Rx bps | 1.21 Gbps | \u25bc\u25bc\u25bc 23.03 bps | 1.21 Gbps | 5.94 bps | 2.42 G bps
Rx pps | 418.59 Kpps | 0.04 pps | 418.77 Kpps | 0.01 pps | 837.36 Kpps
---- | | | | |
opackets | 5227126 | 5227271 | 5432528 | 5432354 | 21319279
ipackets | 10526000 | 5 | 10527054 | 4 | 21053063
obytes | 1890829910 | 1891039152 | 1965259162 | 1965124338 | 7712252562
ibytes | 3807894454 | 320 | 3808149896 | 256 | 7616044926
tx-pkts | 5.23 Mpkts | 5.23 Mpkts | 5.43 Mpkts | 5.43 Mpkts | 21.32 Mpkts
rx-pkts | 10.53 Mpkts | 5 pkts | 10.53 Mpkts | 4 pkts | 21.05 Mpkts
tx-bytes | 1.89 GB | 1.89 GB | 1.97 GB | 1.97 GB | 7.71 GB
rx-bytes | 3.81 GB | 320 B | 3.81 GB | 256 B | 7.62 GB
----- | | | | |
oerrors | 0 | 0 | 0 | 0 | 0
ierrors | 133,370 | 0 | 132,529 | 0 | 265,899
Reference in New Issue View Git Blame Copy Permalink