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