NOTE: This version works only with ndnSIM 2.1, and not with previous versions (2.0 and 1.0) of ndnSIM. **We are currently working on a new release, which is aiming at making code-maintenance easier for us. We've archived the stable version under AMust-ndnSIM 2.1. **
AMuSt-ndnSIM is part of the AMuSt Simulator Framework, which also supports "pure" ns-3 based simulations, using HTTP downloads.
This is a custom version of ndnSIM 2.1 supporting Adaptive Multimedia Streaming and the BRITE extension. Please refer to the original ndnSIM github repository for documentation about ndnSIM and ns-3.
Adaptive Multimedia Streaming Framework for ndnSIM is trying to create a bridge between the multimedia and NDN community. Therefore it is providing several scenarios and the source code for adaptive streaming with NDN, based on ndnSIM and libdash.
- Install Pre-Requesits for ndn-cxx, NFD, ns-3, BRITE
- Install Pre-Requesits for AMuSt-libdash
- Clone all relevant git repositories
- Download Brite repository
- Build Brite
- Build AMuSt-libdash
- Build ns-3 with AMuSt-ndnSIM
# install pre-requesits for ndn-cxx, ns-3, pybindgen, etc...
sudo apt-get install git
sudo apt-get install python-dev python-pygraphviz python-kiwi
sudo apt-get install python-pygoocanvas python-gnome2
sudo apt-get install python-rsvg ipython
sudo apt-get install build-essential gccxml
sudo apt-get install libsqlite3-dev libcrypto++-dev
sudo apt-get install libboost-all-dev
# install pre-requesits for libdash
sudo apt-get install git-core cmake libxml2-dev libcurl4-openssl-dev
# install mercurial for BRITE
sudo apt-get install mercurial
mkdir ndnSIM
cd ndnSIM
# clone git repositories for ndn/ndnSIM
git clone https://github.com/named-data-ndnSIM/ns-3-dev.git ns-3
git clone https://github.com/named-data-ndnSIM/pybindgen.git pybindgen
git clone --recursive https://github.com/ChristianKreuzberger/AMuSt-ndnSIM.git ns-3/src/ndnSIM
git clone https://github.com/ChristianKreuzberger/AMuSt-libdash.git
# download and built BRITE
hg clone http://code.nsnam.org/BRITE
ls -la
cd BRITE
make
cd ..
# build libdash
cd AMuSt-libdash/libdash
mkdir build
cd build
cmake ../
make dash # only build dash, no need to build the network stuff
cd ../../../
# build ns-3/ndnSIM with brite and dash enabled
cd ns-3
./waf configure -d optimized --with-pybindgen=../pybindgen
./wafThe result should be something like this:
---- Summary of optional NS-3 features:
Build profile : optimized
Build directory : /home/ckreuz/ndnSIM/ns-3/build
Python Bindings : enabled
Python API Scanning Support : not enabled (Missing 'pygccxml' Python module)
BRITE Integration : enabled
NS-3 Click Integration : not enabled (nsclick not enabled (see option --with-nsclick))
GtkConfigStore : not enabled (library 'gtk+-2.0 >= 2.12' not found)
XmlIo : enabled
Threading Primitives : enabled
Real Time Simulator : enabled
Emulated Net Device : enabled
File descriptor NetDevice : enabled
Tap FdNetDevice : enabled
Emulation FdNetDevice : enabled
PlanetLab FdNetDevice : not enabled (PlanetLab operating system not detected (see option --force-planetlab))
Network Simulation Cradle : not enabled (NSC not found (see option --with-nsc))
MPI Support : not enabled (option --enable-mpi not selected)
LIBDASH Integration : enabled
ndnSIM : enabled
NS-3 OpenFlow Integration : not enabled (OpenFlow not enabled (see option --with-openflow))
SQlite stats data output : enabled
Tap Bridge : enabled
PyViz visualizer : enabled
Use sudo to set suid bit : not enabled (option --enable-sudo not selected)
Build tests : not enabled (defaults to disabled)
Build examples : not enabled (defaults to disabled)
GNU Scientific Library (GSL) : not enabled (GSL not found)
Now install it and run a scenario to test it:
# build
./waf
# run a scenario
./waf --run ndn-file-cbr
Please take a look at the AMuSt-ndnSIM tutorial and AMuSt-libdash information.
We are using a custom version of libdash AMuSt-libdash, so please make sure you use the version provided in the tutorial above.
MPEG-DASH (ISO/IEC 23009-1:2012) is a standard for adaptive multimedia streaming over HTTP connections, which is adapted for NDN file-transfers in this project. For more information about MPEG-DASH, please consult the following links:
We are currently working on a technical report/paper. For now, you can cite it by using the following text:
Christian Kreuzberger, Daniel Posch, Hermann Hellwagner "AMuSt Framework - Adaptive Multimedia Streaming Simulation Framework for ns-3 and ndnSIM", https://github.com/ChristianKreuzberger/AMust-Simulator/
Bibtex:
@misc{kreuzberger2016amust,
title={AMuSt Framework - Adaptive Multimedia Streaming Simulation Framework for ns-3 and ndnSIM},
author={Kreuzberger, Christian and Posch, Daniel and Hellwagner, Hermann},
journal={https://github.com/ChristianKreuzberger/amust-simulator},
year={2016}
}
This work was partially funded by the Austrian Science Fund (FWF) under the CHIST-ERA project CONCERT (A Context-Adaptive Content Ecosystem Under Uncertainty), project number I1402.