An Example of network simulation using NS
NS-3 Appears to have a staggeringly steep learning curve so I hope these posts help out someone else (or me, when i forget all this in a month).
Running off a virtualised Ubuntu 9.10 system, the prerequisites I installed were all the ones listed here. (And i removed some out of date packages)
sudo apt-get install bison bzr dia doxygen flex g++ gcc gdb graphviz imagemagick libgoocanvas-dev libgtk2.0-0 libgtk2.0-dev libsqlite3-dev libxml2 libxml2-dev mercurial python python-dev python-kiwi python-pygoocanvas python-pygraphviz sqlite sqlite3 tcpdump texi2html texinfo texlive texlive-extra-utils texlive-generic-extra texlive-generic-recommended texlive-latex-extra valgrind
That will take a while to install so go get coffee.
Once thats all finished, grab the source using Mercurial (it was installed in the command above). For tidyness, I do all of this under ~/src (If this was a multi-user system I would suggest working under /usr/src and performing the relevant steps as root or under sudo)
If you havent used Mercurial before, check my post on the subject.
$ hg clone http://code.nsnam.org/ns-3-allinone destination directory: ns-3.7 requesting all changes adding changesets adding manifests adding file changes added 31 changesets with 45 changes to 7 files updating working directory 7 files updated, 0 files merged, 0 files removed, 0 files unresolved
Thats the easy bit done, what you’ve downloaded is basically the instructions for downloading everything else about NS-3, all in python scripts.
The download.py script also allows the inclusion (-r) of NS’s regression testing framework so we’re sure that everything works.
For safety I am not using the dev branch;
$ ./download.py -n ns-3.7 -r ns-3.7-ref-traces
And that will output a whole pile of stuff that isnt too salient. Unless you’re really bored…
After which there is a python script that looks after the actual build process, so fire it off with a simple;
$ ./build.py
And, again, lots of waiting (seriously, get coffee, on my VM it took just under 15 minutes) and lots of output.
It is not made clear on the project wiki but this script also fires off the python WAF script so its a complete end to end builder. What isn’t included in the build script is the (very tidy) automated regression test suite, so just for completeness…
$ cd ns-3.7 $./test.py [...] 104 of 104 tests passed (104 passed, 0 skipped, 0 failed, 0 crashed, 0 valgrind errors)
Tags: code, linux, networking, programming, simulation, software, Ubuntu, workstation
