User Tools

Site Tools


Sidebar

openbach:exploitation:jobs:ditgsend_0.3

Job d-itg_send (version 0.3)

This Job principaly launches the executable of D-ITG that sends data towards a target. The flow is unilateral. It is possible to launch multiple instances of the job at the same time.

This job is persistent

Start Command

  • Debian Ubuntu 16.04
/usr/bin/env python3 /opt/openbach/agent/jobs/d-itg_send/d-itg_send.py

Arguments (the ones in bold are mandatory)

  • target_address: Address IP where the flow is sent.
  • sender_address: Address of the sender to get the receiver's logs.
  • dest_path: Path where the stats will be located. Careful, if multiple instances of the job: put a unique path to not overwrite the data.
  • granularity: Set the granularity (in ms) at which the stats will be generated. Careful, set large granularity value (e.g. > 50ms).
  • traffic_type: Traffic type (UDP, TCP, ICMP, …). Default: UDP.
  • port: Set server port (default = 8999)
  • signal_port: Set port for signal transmission (default = 9000)
  • packet_size: Size of each packet in byte. Default: 512B.
  • packet_rate: Number of packets to send in one second. Default: 1000pkt/s.
  • bandwidth: Set bandwidth in [K/M/G]bits/s, if set will overrun packet_rate (default=0) Default: '0'
  • duration: Duration of the traffic in s. Default: 10s.
  • data_size: Set the number of [K/M/G]Bytes to send, if set either duration or data_size will limit the job
  • meter: Way to compute the time: One Way Delay (owdm) or Round Trip Time (rttm). Default: rttm Careful, if “rttm” is chosen, a bidirectional traffic will be generated for the sender to compute the RTT. However, if anykind of synchronization doesn't exist between the equipments, rttm is advised.

Statistic

  • bitrate, Bitrate of the receiver/sender


Frequency: Only one time, once the D-ITGDec task is finished

  • delay, One Way Delay or Round Trip Time


Frequency: Only one time, once the D-ITGDec task is finished

  • jitter, Jitter of the receiver/sender


Frequency: Only one time, once the D-ITGDec task is finished

  • packetloss, Packetloss of the receiver/sender


Frequency: Only one time, once the D-ITGDec task is finished

Source code

The source code is reachable on the GitLab project in the d-itg_send directory.

Help information

Job Description

This job launches the Sender Component (ITGSend) from the D-ITG platform. ITGSend generates traffic towards multiple ITGRecv instances (one-way flow). Multiple traffic can be generated by ITGSend.

This job requires to target a destination which have the job d-itg_recv running.

Traffic generated at transport level: TCP, UDP, SCTP, DCCP, ICMP…

Multiple stats providing the most common QoS metrics are generated (throughput, one-way delay, round-trip time, jitter, packet loss).

Careful when choosing dest_path, the generated stats may overwrite any existing stats in the directory.

Additionnal information

To get an accurate owd, both agents (receiver and sender) must be synchronized (through ntp command or else).

We do not guarantee the accuracy of the measured stats. Only some metrics have been tested and validated during our test campaign. The validated metrics are the following:

  • jitter_receiver
  • owd_receiver
  • bitrate
  • rttm

Tool's parameter “packet rate” is not always respected (>100 packets/sec) by d-itg. Therefore the bandwidth and packrate set in the job are not guaranteed.

Examples

Example 1

Launch the sender job (ip: 192.168.1.46) to the receiver job (ip: 192.168.1.45), with a granularity of 1 sec (1000 ms). The log file will be saved in the /tmp/ directory. The mode is UDP and the metrics are measured in both side (rttm).

In the web interface, set the following parameters:

  • target_address = 192.168.1.45
  • sender_address = 192.168.1.46
  • dest_path = /tmp/
  • granularity = 1000
  • traffic_type = UDP
  • meter = rttm

Or launch the job manually from CLI of the Agent as follows:

JOB_NAME=d-itg_sender sudo -E python3 /opt/openbach-jobs/d-itg_send/d-itg_send.py 192.168.1.45 192.168.1.46 /tmp/ 1000 -T UDP -m rttm
openbach/exploitation/jobs/ditgsend_0.3.txt · Last modified: 2020/02/25 22:53 (external edit)