BRITE integration with ns-3BRITE integration with ns-3

Joshua Pelkey and Dr. George Riley

Wns3 March 25, 2011

2

OverviewOverview

• 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 GoalsProject 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 OverviewImplementation 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 DemoUsage 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

RTWaxman5RTWaxman5

Figure 1. RTWaxman5 (5 nodes, 7 edges)

7

RTWaxman20RTWaxman20

Figure 2. RTWaxman20 (20 nodes, 40 edges)

8

RTBarabasiRTBarabasi

Figure 3. RTBarabasi (100 nodes, 197 edges)

9

ASWaxmanASWaxman

Figure 4. ASWaxman (1000 nodes, 2000 edges)

10

Project Goals: statusProject 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 InformationMore Information

• BRITE website: http://www.cs.bu.edu/brite/

• Ns-3 BRITE integration wiki with instructions to get the code, build, and use: http://www.nsnam.org/wiki/index.php/Ns3_BRITE_Integration

or just search for “ns-3 BRITE” in Google