...

Global pre-requisites

• Functional testrunner

• JobTestrunner downloaded and placed in the PATH

• Measurement folder including :

  • configuration files config.yml and

  config

  • job.yml

  files PC connected in Ethernet.

  • a gdsl script with the ‘testgb’ extension

• Computer connected via Ethernet.

tcpdump --version

sudo apt install tcpdump

Expand
title Specific prerequisites to Mac OS
Activate connection sharing on the Mac pc. Click on the apple (top left), then on "System Preferences > Sharing". Uncheck the "Internet Sharing" box (if enabled). Apply the following settings: Share your connection from: Thunderbolt Ethernet To computers using: Wifi Wi-Fi Options...: enter the name of the network and the password Then select the "Internet Sharing" checkbox. The wifi icon changes to an arrow pointing upwards. Image Modified Connect your phone to the computer's connection share. Check that the tcpdump package is installed on the Mac OS computer. tcpdump is installed by default on most Mac OS. To check this, run the following command: Code Block language bash tcpdump --version If the package is not installed, run the following command: Code Block language bash brew install tcpdump

Modification of job.yml

job:
  modules:
    tcpdump: true

Modifications of config.yml

target:
  tcpdump:                  # tcpdump module used to get data
    deviceIP: x.x.x.x       # IP of the device to measure
    gatewayIP: x.x.x.x      # IP of the gateway used to filter data
    networkInterface: xxxx  # Network interface used to detect data (wlp2s0...)
    keepPcap: false         # If true, it keeps the pcap file at the end of the measures
    ipFilters:              # Other IP addresses used to filter data
      apple: false          # If true, it filters data related with 17.0.0.0/8

...

• deviceIP : The IP address of the phone in the network shared by your PC. Normally this is an address of the type 10.42.0.x (replace the x with the correct number)

• gatewayIP : This is the IP address of your PC (which acts as a gateway) in the shared network. This can be found using the ifconfig command. Normally it is : 10.42.0.1

• networkInterface : The name of the network interface on the shared network. This can be found using the ifconfig command. You can also obtain it by typing the command sudo tcpdump -D. The network interface corresponding to the shared connection begins with "wl" (Wireless Lan) on Linux.

• keepPcap : If the boolean is set to true, the pcap file is saved at the end of the measurements.

• ipFilters : These are filters to remove certain network exchanges from the measurement. For measurements on iOS, set the "apple" boolean to true to filter IP addresses corresponding to 17.0.0.0/8 (Apple).

Launch of measures

Run the testrunner as usual:

...

If the tcpdump module has been activated in the job.yml file, the root password will be requested on Linux and Mac OS when the testrunner is initialised.

Add rights to run tcpdump without password on Linux [optional]

The procedure comes from this website : https://askubuntu.com/questions/530920/tcpdump-permissions-problem

• Create a pcap group and add yourself to it

sudo groupadd pcap
sudo usermod -a -G pcap $USER

• Change the group of tcpdump and set permissions. You may need to change the path by /usr/bin/tcpdump.

sudo chgrp pcap /usr/sbin/tcpdump
sudo chmod 750 /usr/sbin/tcpdump

• Use setcap to give tcpdump the necessary permissions

sudo setcap cap_net_raw,cap_net_admin=eip /usr/sbin/tcpdump

• Restart your PC. You should be able to run the tcpdump command without sudo.

Schema of situation

...