| .. _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 |