X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Freport%2Fintroduction%2Fmethodology_trex_traffic_generator.rst;h=cae65ab1c86c652b1cd6c152df0f4fc1de09cbc5;hp=d9e7df57d3b881883954acfd68a0dd096cd889ca;hb=9c459a2b303eb8d776ac040bc82830d850a67623;hpb=6c544c7b76a989952417b8cf7618c4cada465ed0 diff --git a/docs/report/introduction/methodology_trex_traffic_generator.rst b/docs/report/introduction/methodology_trex_traffic_generator.rst index d9e7df57d3..cae65ab1c8 100644 --- a/docs/report/introduction/methodology_trex_traffic_generator.rst +++ b/docs/report/introduction/methodology_trex_traffic_generator.rst @@ -4,27 +4,42 @@ TRex Traffic Generator Usage ~~~~~ -`TRex traffic generator `_ is used for all -CSIT performance tests. TRex stateless mode is used to measure NDR and -PDR throughputs using MLRsearch and to measure maximum transer rate -in MRR tests. +`TRex traffic generator `_ is used for majority of +CSIT performance tests. TRex stateless mode is used to measure NDR and PDR +throughputs using MLRsearch and to measure maximum transfer rate in MRR tests. TRex is installed and run on the TG compute node. The typical procedure is: -- If the TRex is not already installed on TG, it is installed in the - suite setup phase - see `TRex installation`_. - TRex configuration is set in its configuration file :: - /etc/trex_cfg.yaml + $ sudo -E -S sh -c 'cat << EOF > /etc/trex_cfg.yaml + - version: 2 + c: 15 + limit_memory: 8192 + interfaces: ["${pci1}","${pci2}"] + port_info: + - dest_mac: [${dest_mac1}] + src_mac: [${src_mac1}] + - dest_mac: [${dest_mac2}] + src_mac: [${src_mac2}] + platform : + master_thread_id: 0 + latency_thread_id: 16 + dual_if: + - socket: 0 + threads: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15] + EOF' -- TRex is started in the background mode +- TRex is started in the interactive mode as a background service :: - $ sh -c 'cd /scripts/ && sudo nohup ./t-rex-64 -i --prefix $(hostname) --hdrh --no-scapy-server > /tmp/trex.log 2>&1 &' > /dev/null + $ sh -c 'cd /scripts/ && \ + sudo nohup ./t-rex-64 -i --prefix $(hostname) --hdrh --no-scapy-server \ + > /tmp/trex.log 2>&1 &' > /dev/null - There are traffic streams dynamically prepared for each test, based on traffic - profiles. The traffic is sent and the statistics obtained using + profiles. The traffic is sent and the statistics obtained using API :command:`trex.stl.api.STLClient`. Measuring Packet Loss @@ -48,4 +63,4 @@ Measuring Latency If measurement of latency is requested, two more packet streams are created (one for each direction) with TRex flow_stats parameter set to STLFlowLatencyStats. In that case, returned statistics will also include -min/avg/max latency values and encoded HDRHstogram data. +min/avg/max latency values and encoded HDRHistogram data.