Skip to content

SoonyangZhang/rmcat-ns3

Repository files navigation

rmcat-ns3

A comparison of rmcat protocol, namely NADA, GCC and SCReAM on ns3 platform. The version of ns is 3.26.
The paper link https://arxiv.org/pdf/1809.00304.pdf
The simulation code of NADA can get from https://github.com/cisco/ns3-rmcat
In consideration that the author of NADA made an update to their code, I upload the code I used during writting of this paper. And I did test the performance of the newer code inplementation, but it seems the new version had introduce some bugs that the sender can get quite low throughput compared to the link capacity.
For, I just release the SCReAM code modified from https://github.com/EricssonResearch/scream

the code in screamex.cc sendApp->SetTraceFilePath("/you_path/trace_key.txt"),is no use in experiment, but it should be configured in right path. trace_key.txt is from https://github.com/EricssonResearch/scream/tree/master/traces

the mytrace module is used for data collecion. And a file named "trace" should be created first under the path of ns-allinone-3.26/ns-3.26/

the razor project is a c version of GCC release at https://github.com/yuanrongxi/razor. And I make some minor modification to get it running on ns3. Thanks to the author's contributions.

Must running tips

Or else the compiler will runnng into errer like: cannot find -lrtc_base...

To run GCC congestion control algorithm, it depends on external library from webrtc and these files(webrtc-lib/webrtc) should be built first (The folder webrtc-lib can be put anywhere, for example /home/xxx/webrtc-lib).

cd /home/xxx/webrtc-lib/webrtc/  
cmake .  
make  

Then configure the environemnt variables:

sudo su  
gedit /etc/profile  

add the following to /etc/profile:

export WEBRTC_LIB=/home/xxx/webrtc-lib  
export LD_LIBRARY_PATH=$WEBRTC_LIB/webrtc/system_wrappers:$WEBRTC_LIB/webrtc/rtc_base:$WEBRTC_LIB/webrtc/api:$WEBRTC_LIB/webrtc/logging:$WEBRTC_LIB/webrtc/modules/utility:$WEBRTC_LIB/webrtc/modules/pacing:$WEBRTC_LIB/webrtc/modules/congestion_controller:$WEBRTC_LIB/webrtc/modules/bitrate_controller:$WEBRTC_LIB/webrtc/modules/remote_bitrate_estimator:$WEBRTC_LIB/webrtc/modules/rtp_rtcp:$LD_LIBRARY_PATH  
export CPLUS_INCLUDE_PATH=CPLUS_INCLUDE_PATH:$WEBRTC_LIB/webrtc/:$WEBRTC_LIB/webrtc/system_wrappers:$WEBRTC_LIB/webrtc/rtc_base:$WEBRTC_LIB/webrtc/api:$WEBRTC_LIB/webrtc/logging:$WEBRTC_LIB/webrtc/modules/utility:$WEBRTC_LIB/webrtc/modules/pacing:$WEBRTC_LIB/webrtc/modules/congestion_controller:$WEBRTC_LIB/webrtc/modules/bitrate_controller:$WEBRTC_LIB/webrtc/modules/remote_bitrate_estimator:$WEBRTC_LIB/webrtc/modules/rtp_rtcp  

The path about the headers and so libs in wscript(under webrtc-ns3) should also be changed accordingly:

  conf.env.append_value('INCLUDES', ['/home/xxx/webrtc-lib/webrtc/'])
  conf.env.append_value("LINKFLAGS", ['-L/home/xxx/webrtc-ns3/webrtc/system_wrappers','-L/home/xxx/webrtc-ns3/webrtc/rtc_base','-L/home/xxx/webrtc-ns3/webrtc/api','-L/home/xxx/webrtc-ns3/webrtc/logging','-L/home/xxx/webrtc-ns3/webrtc/modules/utility','-L/home/xxx/webrtc-ns3/webrtc/modules/pacing','-L/home/xxx/webrtc-ns3/webrtc/modules/congestion_controller','-L/home/xxx/webrtc-ns3/webrtc/modules/bitrate_controller','-L/home/xxx/webrtc-ns3/webrtc/modules/remote_bitrate_estimator','-L/home/xxx/webrtc-ns3/webrtc/modules/rtp_rtcp'])

And the webrtc-ns3 module depends on multipathvideo, and multipathvideo should be put under src in ns3.
Location:
image

In simulation(razor-example/gcc_tcp.cc), a point to point channel was created. From the time of 20s to 100s, A reno TCP connection flows into the network. The first picture shows the kalman-gcc cannot complete fair bandiwdth share with tcp flow.

image
image
If you quite interesting in this simualation, and think the above instrcution is quite complex, you could email me for the VM during the experiment.
some simualtion example of GCC algorithms:
bandwidth fainress property:
image
owe way transmission delay:
image
In some test case, gcc flows may not converge to the fairness line, case 1.
bandwidth fainress property:
image
owe way transmission delay:
image

The command to get webrtc-tcp running:

sudo su  
source /etc/profile  
./waf --run "scratch/webrtc-tcp --it=1"