mptcp-experiment

This project simulates and evaluates MPTCP with various options on dual connectivity infrastructure. This experiment uses two paths one is NR, and the other one is LTE; the simulation of NR is done by ns3-mmwave module, and an official module of ns-3 does the simulation of LTE.

Here is the small list of what options are evaluated:

• Various congestion controll algorithm
• Various path manager mechanism
• Various scheduler algorithms
• Different distances
• Different file size
• etc...

The simulation is done with the help of DCE.

Integrate ns3-mmwave with ns-3

First of all, all of these instructions are done in ubuntu 16. Since this integration comes with so many problems; two repositories are fixed bugs and integration procedure problems:

https://github.com/sod-lol/ns-3-dev-git

https://github.com/sod-lol/ns-3-dce

Each DCE version is integrated with a specific version of ns3-mmwave, and all of the versions that could be integrated are integrated and completed in each branch in the above repositories. And for integration with two repositories with each an another, the following commands should run(we integrate ns3-mmwave V5.0):

mkdir playground
cd playground/
git clone https://github.com/sod-lol/ns-3-dev-git
mkdir install
git clone https://github.com/sod-lol/ns-3-dce
cd ns-3-dev-git/
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt update
sudo apt install g++-7 -y
sudo apt install g++-7 gcc-7 -y
rm -rf /usr/bin/gcc
rm -rf /usr/bin/g++
ln -s /usr/bin/gcc-7 /usr/bin/gcc
ln -s /usr/bin/g++-7 /usr/bin/g++
CXXFLAGS_EXTRA="-O3";sudo -H ./waf configure -d optimized --prefix=$HOME/playground/install
CXXFLAGS_EXTRA="-O3" sudo -H ./waf build
./waf install
cd ..

At this point, we successfully built and installed ns3-mmwave with ns-3.

For enabling MPTCP in DCE we should build specific branch of libos:

git clone https://github.com/libos-nuse/net-next-nuse -b mptcp_trunk_libos --depth=1
sudo git config --global url."https://github.com/".insteadOf git://github.com/
cd net-next-nuse/

Copy .config file to net-next-nuse folder and after that execute following commands:

apt install bc
rm -rf /usr/bin/g++
rm -rf /usr/bin/gcc
ln -s /usr/bin/g++-5 /usr/bin/g++
ln -s /usr/bin/gcc-5 /usr/bin/gcc
make library ARCH=lib -j 8
cp arch/lib/tools/libsim-linux-4.1.0.so .
cd ..

Now we should build and install DCE:

rm -rf /usr/bin/gcc
rm -rf /usr/bin/g++
ln -s /usr/bin/gcc-7 /usr/bin/gcc
ln -s /usr/bin/g++-7 /usr/bin/g++
cd ns-3-dce/
CXXFLAGS_EXTRA="-O3" sudo -H ./waf configure --with-ns3=$HOME/playground/install  --enable-opt --enable-kernel-stack=$HOME/playground/net-next-nuse/arch --prefix=$HOME/playground/install
CXXFLAGS_EXTRA="-O3" sudo -H ./waf build
CXXFLAGS_EXTRA="-O3" sudo -H ./waf install
cd ..

After installing DCE there is one more step to enable MPTCP in DCE:

cp net-next-nuse/*.so install/bin_dce/
cd install/bin_dce/
rm -rf liblinux.so
ln -s libsim-linux-4.1.0.so liblinux.so
cd ../..

At this point, we successfully installed and integrated ns3-mmwave with ns-3 and enabled MPTCP in DCE. Now we can run mmwave example:

cd ns-3-dce/
CXXFLAGS_EXTRA="-O3" sudo -H ./waf --enable-opt --run dce-example-mptcp-mmwave

PTools

PTools is a simple tool that I wrote mainly for this project; The reason why this tool was created in the first place is that because every single simulation takes so much time(around 3 ~ 5 h), it would be tedious if we want to get results from all of the options and various senarios because they should run sequentially, and also all of the simulations needed to run in the background because each time SSH connection disconnects from the server the whole running simulation ruined.

PTools run on python3.7, so make sure python3.7 installed, and after that install fastapi with pip.

PTools service can run by the following command:

./setup-service.sh

And also can be remove:

./setup-service.sh k

Sending tasks to PTools daemon can be done in several ways, but the easiest one is sending tasks written in JSON files. First, copy the prescript.py and post_process.py to the ns-3-dce folder, then copy the whole ns-3-dce folder and name it ns-3-dce-1. Here is the example of a JSON file:

[{
    "process_name": "scalable_binder_default",
    "process_directory": "/root/playground/ns-3-dce-1",
    "process_binary": "./waf",
    "process_example_name": "first-scenario",
    "process_identity": "04216daa-7e8f-4b39-a72e-5a3ab4ef6866",
    "process_depend_on": "8a6985ba-2040-4043-8e45-3d2d2c3f2d5d",
    "process_binary_options": "--enable-opt --run \"first-scenario --ccAlgo=scalable --pathM=binder --scheAlgo=default\"",
    "nice_value": -20,
    "ionice_type": 1,
    "ionice_value": 0,
    "cpu_affinity": [],
    "scheduler_type": "-r",
    "scheduler_value": 99,
    "pre_script": {
        "use_script": true,
        "script_path": "/root/playground/ns-3-dce-1/prescript.py",
        "script_use_shell": false,
        "pass_args": ""
    },
    "post_script": {
        "use_script": true,
        "script_path": "/root/playground/ns-3-dce-1/post_process.py",
        "script_use_shell": false,
        "pass_args": "scalable lte-mmwave2"
    }
}]

The task generator script creates the above JSON. For sending the tasks to the daemon following command should work:

python3.7 ptools.py -t task_list.json

Another way that could send tasks to the daemon is the following command:

python3.7 ptools.py -v add --process-name "first-scenario" --process-directory "/root/playground/ns-3-dce" --process-binary "./waf" --process-binary-options "--enable-opt --run \"first-scenario --ccAlgo=cubic --pathM=fullmesh --scheAlgo=default\"" --process-sub-program "first-scenario" --prescript-path "/root/playground/ns-3-dce/prescript.py" --nice-value -20 --scheduler-type "r" --scheduler-value 99 --ionice-type 1 --ionice-value 0 --postscript-path "/root/playground/ns-3-dce/post_process.py" --postscript-args "cubic lte-mmwave2" --process-identity "c5b9323d-b8ae-4f04-91a9-2f746bd8d65e"

Generate Plots

There are two scripts that generate results:

1. plot_file_distance: This file will generate plots for scenarios each time the user downloads a file with different sizes at different distances.
2. plot_cc_pm_sch: This script will generate plots for scenarios when the simulation is done with a specific movement scenario but only with different options, such as congestion control, path manager, and scheduler.

As you can see, results are uploaded to the repository, so copy the scripts to the root of each resulting folder and then run the scripts.