User Tools

Site Tools


Sidebar

openbach:exploitation:reference_scenarios:service:data_transfer:index

Data transfer Traffic Scenario

This service allows to either :

  • transfer one file with TCP between two OpenBACH agents

or

  • transfer data with TCP between two OpenBACH agents during a certain time

It uses the OpenBACH job iperf3. The executor script can be found here.

How to launch it

The scenario can be launched with the following command (if the duration determines the end of the data transfer):

python3 executor_service_data_transfer.py your_project --server-entity source_entity --client-entity destination_entity --server-ip source_ip_address --client-ip destination_ip_address --server-port server_port --tos tos --mtu mtu --duration duration --post-processing-entity pp_entity run

Or with the following command (if the file size determines the end of the data transfer):

python3 executor_service_data_transfer.py your_project --server-entity source_entity --client-entity destination_entity --server-ip source_ip_address --client-ip destination_ip_address --server-port server_port --file_size file_size --tos tos --mtu mtu --duration duration --post-processing-entity pp_entity run

The source of the traffic is the iperf3 client and the destination is the iperf3 server.

Here is a description of each argument:

  • src_entity: the name of the OpenBACH agent sending iperf3 traffic
  • dst_entity: the name of the OpenBACH agent receiving iperf3 traffic
  • dst_ip: the ip address of the iperf3 traffic destination
  • dst_port: the port of the iperf3 traffic destination (e.g. 5201)
  • file_size: the size of the file to transmit (in bytes)
  • tos: set the ToS field of the TCP iperf3 traffic (e.g. 0x04)
  • mtu: set the MTU of the TCP iperf3 traffic (in bytes, e.g. 1400)
  • duration: the duration of the transfer (in seconds)
  • entity_pp: the OpenBACH agent post-processing statistics

Statistics returned

The scenario returns the metrics generated by the exploited jobs as a raw csv file. More details on the available metrics are given on the source of each exploited job. time_series and histograms plots are generated, plotting the temporal evolution and the CDF of the throughput on the server side (destination).

openbach/exploitation/reference_scenarios/service/data_transfer/index.txt ยท Last modified: 2020/10/22 10:31 by kuhnn