BRITE integration with ns-3 Joshua Pelkey and Dr. George Riley Wns3 March 25, 2011

2 Overview The Boston University Representative Internet Topology gEnerator (BRITE) –Topology generation framework Integrating with ns-3 –Leverage the power of BRITE, i.e. let BRITE create the topologies and ns-3 run the simulations

3 Project Goals Easily leverage the power of BRITE within ns-3, to create large-scale Internet topologies Provide example ns-3 script to show use Code documentation, including doxygen Manual section Use download.py to completely modularize BRITE in ns-3

4 Implementation Overview Original BRITE C++ code is (very) slightly modified and maintained in a mercurial repo on the ns-3 code server This repo is pulled down and built with the included Makefile. A library, libbrite.so is built This library is linked with ns-3 during the./waf build process in ns-3 Helper class, BriteTopologyHelper, exists to interface with the original BRITE code which builds the topology. Finally, the helper creates an identical ns-3 topology and can be used to set up simulations

5 Usage and Demo After linking BRITE, try some of these to see it in action -- make sure python bindings are enabled if you want to use the visualizer: –./waf --run ‘brite-generic-example’ --visualize –./waf --run ‘brite-generic-example --confFile=../BRITE/conf_files/RTBarabasi20.conf’ --visualize –./waf --run ‘brite-generic-example --confFile=../BRITE/conf_files/RTBarabasi.conf’ –visualize To randomize the topology node placement and link bandwidths and delays, pass in a new seed file: –./waf --run ‘brite-generic-example --newseedFile=../BRITE/seed_file’ --visualize

6 RTWaxman5 Figure 1. RTWaxman5 (5 nodes, 7 edges)

7 RTWaxman20 Figure 2. RTWaxman20 (20 nodes, 40 edges)

8 RTBarabasi Figure 3. RTBarabasi (100 nodes, 197 edges)

9 ASWaxman Figure 4. ASWaxman (1000 nodes, 2000 edges)

10 Project Goals: status Easily leverage the power of BRITE within ns-3, to create large-scale Internet topologies Provide example ns-3 script to show use Code documentation, including doxygen Manual section Use download.py for BRITE in ns-3

11 More Information BRITE website: Ns-3 BRITE integration wiki with instructions to get the code, build, and use: or just search for “ns-3 BRITE” in Google