ubuntu13.04下安装ns-3.17，以及openflow模块的安装

最近使用ns3，看到别人写的帖子，是两篇文章，按我的实际经历，总结一下，不过是将两篇文章整合到一起，省去冗余步骤。。。

安装NS3之前，需要在Ubuntu中进行NS3环境设置，安装必须的开发环境如C++环境，gcc，g++等，安装步骤参考：http://www.nsnam.org/wiki/index.php/Installation，具体如下：

一. NS3安装预先设置Ubuntu环境如下(Prerequisites for Ubuntu12.04)

C++和python安装，必装

sudo apt-get install gcc g++ python

sudo apt-get install gcc g++ python python-dev

NS3代码维护使用的源码版本控制管理系统

sudo apt-get install mercurial

运行python绑定ns-3-dev需要bazaar这个组件

sudo apt-get install bzr

调试工具

sudo apt-get install gdb valgrind

支持更多精确WIFI模块的GNU Scientific Library (GSL) 

sudo apt-get install gsl-bin libgsl0-dev libgsl0ldbl

仿真必需的词法分析器和语法分析生成器，必装

sudo apt-get install flex bison libfl-dev

一些Network Simulation Cradle (nsc) stacks需要gcc-3.4

sudo apt-get install g++-3.4 gcc-3.4

读取pcap的packet traces，即包嗅探器

sudo apt-get install tcpdump

支持统计特性的数据库软件

sudo apt-get install sqlite sqlite3 libsqlite3-dev

xml的配置存储软件(requires libxml2 >= version 2.7)

sudo apt-get install libxml2 libxml2-dev

基于GTK的配置系统

sudo apt-get install libgtk2.0-0 libgtk2.0-dev

在虚拟机and ns-3上测试

sudo apt-get install vtun lxc

支持utils/check-style.py 代码风格检查程序

sudo apt-get install uncrustify

文档生成器，从源代码中生成说明文档（很大，我没有装）

sudo apt-get install doxygen graphviz imagemagick
sudo apt-get install texlive texlive-extra-utils texlive-latex-extra

The ns-3 manual and tutorial are written in reStructuredText for Sphinx (doc/tutorial, doc/manual, doc/models), and figures typically in dia:

sudo apt-get install python-sphinx dia

Note: Sphinx version >= 1.12 required for ns-3.15. To check your version, type "sphinx-build". To fetch this package alone, outside of the Ubuntu package system, try "sudo easy_install -U Sphinx".
Gustavo's ns-3-pyviz的可视化软件（没装）

sudo apt-get install python-pygraphviz python-kiwi python-pygoocanvas libgoocanvas-dev

支持openflow 模块(requires some boost libraries)

sudo apt-get install libboost-signals-dev libboost-filesystem-dev

支持基于 MPI的分布式仿真

sudo apt-get install openmpi*

------------------------------------------------------------
二、NS3下载

我是直接从网站下载源码 http://www.nsnam.org/ns-3-17/，然后进行解压

tar xjf ns-allinone-3.17.tar.bz2

下面是之前blog的办法：

(1)使用Mercurial下载 (下载dev版本)

cd
 mkdir repos
 cd repos
 hg clone http://code.nsnam.org/ns-3-allinone[/code]  

---------------------------------------------------------

./download.py -n ns-3-dev

 

(2)下载 realse tarball

cd
 mkdir tarballs
 cd tarballs
 wget http://www.nsnam.org/release/ns-allinone-3.17.tar.bz2(此处根据版本号作相应修改，如ns-allinone-3.16.tar.bz2)
 tar xjf ns-allinone-3.17.tar.bz2


------------------------------------------------------------

三、编译NS3

因为编译要得时间比较长，而加入openflow模块要重新编译构建ns3，所以在这里先不编译，如果不需要这个模块，可以按下面的步骤直接编译。

需要加入openflow模块的按 http://blog.csdn.net/roger__king/article/details/9272141 执行即可。

进入ns-allinone-3.17目录，在终端shell中执行

./build.py --enable-examples --enable-tests


一轮长时间的等待，

最终执行完后看到
".Waf: Leaving directory `/path/to/workspace/ns-allinone-3.17/ns-3.17/build'

'build' finished successfully (6m25.032s)

Modules built:

antenna                    aodv                       applications

bridge                     buildings                  config-store

core                       csma                       csma-layout

dsdv                       dsr                        emu

energy                     fd-net-device              flow-monitor

internet                   lte                        mesh

mobility                   mpi                        netanim (no Python)

network                    nix-vector-routing         olsr

point-to-point             point-to-point-layout      propagation

spectrum                   stats                      tap-bridge

test (no Python)           tools                      topology-read

uan                        virtual-net-device         wifi

wimax                     visualizer

Modules not built (see ns-3 tutorial for explanation):

brite                      click                      openflow
Leaving directory `./ns-3.17`."

也可以使用waf构建(Building with Waf)

进入ns-3.17文件目录：

./wafclean
./waf-d optimized --enable-examples --enable-tests configure


最终看到：Checking for program g++ : ok /usr/bin/g++

Checking for program cpp : ok /usr/bin/cpp

Checking for program ar : ok /usr/bin/ar

Checking for program ranlib : ok /usr/bin/ranlib

Checking for g++ : ok

Checking for program pkg-config : ok /usr/bin/pkg-config

Checking for -Wno-error=deprecated-declarations support : yes

Checking for -Wl,--soname=foo support : yes

Checking for header stdlib.h : ok

Checking for header signal.h : ok

Checking for header pthread.h : ok

Checking for high precision time implementation : 128-bit integer

Checking for header stdint.h : ok

Checking for header inttypes.h : ok

Checking for header sys/inttypes.h : not found

Checking for library rt : ok

Checking for header netpacket/packet.h : ok

Checking for pkg-config flags for GSL : ok

Checking for header linux/if_tun.h : ok

Checking for pkg-config flags for GTK_CONFIG_STORE : ok

Checking for pkg-config flags for LIBXML2 : ok

Checking for library sqlite3 : ok

Checking for NSC location : ok ../nsc (guessed)

Checking for library dl : ok

Checking for NSC supported architecture x86_64 : ok

Checking for program python : ok /usr/bin/python

Checking for Python version >= 2.3 : ok 2.5.2

Checking for library python2.5 : ok

Checking for program python2.5-config : ok /usr/bin/python2.5-config

Checking for header Python.h : ok

Checking for -fvisibility=hidden support : yes

Checking for pybindgen location : ok ../pybindgen (guessed)

Checking for Python module pybindgen : ok

Checking for pybindgen version : ok 0.10.0.640

Checking for Python module pygccxml : ok

Checking for pygccxml version : ok 0.9.5

Checking for program gccxml : ok /usr/local/bin/gccxml

Checking for gccxml version : ok 0.9.0

Checking for program sudo : ok /usr/bin/sudo

Checking for program hg : ok /usr/bin/hg

Checking for program valgrind : ok /usr/bin/valgrind

---- Summary of optional NS-3 features:
Python Bindings :                          enabled
Python API Scanning Support :   not enabled (Missing 'pygccxml' Python module)
BRITE Integration :                        not enabled (BRITE not enabled (see option --with-brite))
NS-3 Click Integration :                 not enabled (nsclick not enabled (see option --with-nsclick))
GtkConfigStore :                             enabled
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)
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 :                enabled
Build tests :                                        enabled
Build examples :                                enabled
GNU Scientific Library (GSL) :         enabled
'configure' finished successfully (4.768s)

PS：此次出现很多“Not enable“ 暂时还不清楚怎么使其”enable“

./wafclean
./waf-d debug --enable-examples --enable-tests configure


最终看到"...finished successfully (s)"
./waf


又将是一轮长时间的等待

Enable something
./wafconfigure -d debug --enable-sudo --enable-examples --enable-tests


Help
./waf--help


四、测试NS3

./test.py -c core


出现Waf: Leaving directory `/home/rogerking/ns-allinone-3.17/ns-3.17/build'

'build' finished successfully (6m1.803s)

Modules built:

antenna                      aodv                              applications

bridge                         buildings                      config-store

core                             csma                             csma-layout

dsdv                            dsr                                  emu

energy                         fd-net-device                flow-monitor

internet                        lte                                   mesh

mobility                       mpi                                 netanim (no Python)

network                       nix-vector-routing         olsr

point-to-point             point-to-point-layout     propagation

spectrum                   stats                                tap-bridge

test (no Python)        tools                                topology-read

uan                              virtual-net-device         visualizer

wifi                               wimax

Modules not built (see ns-3 tutorial for explanation):

brite                           click                                openflow

PASS: TestSuite attributes

PASS: TestSuite callback

PASS: TestSuite command-line

PASS: TestSuite config

PASS: TestSuite global-value

PASS: TestSuite int64x64

PASS: TestSuite object-name-service

PASS: TestSuite object

PASS: TestSuite ptr

PASS: TestSuite basic-random-number

PASS: TestSuite sample

PASS: TestSuite simulator

PASS: TestSuite time

PASS: TestSuite timer

PASS: TestSuite traced-callback

PASS: TestSuite type-traits

PASS: TestSuite watchdog

PASS: TestSuite threaded-simulator

PASS: TestSuite random-number-generators

...

PASS: TestSuite static-routing

PASS: TestSuite mobility

PASS: TestSuite ns3-wifi-interference

PASS: TestSuite ns3-wifi-msdu-aggregator

SKIP: TestSuite ns3-tcp-cwnd

SKIP: TestSuite ns3-tcp-interoperability

PASS: TestSuite ns3-tcp-loss

PASS: TestSuite ns3-tcp-no-delay

PASS: TestSuite ns3-tcp-socket

PASS: TestSuite ns3-tcp-state

SKIP: TestSuite nsc-tcp-loss

153 of 156 tests passed (153 passed, 3 skipped, 0 failed, 0 crashed, 0 valgrind errors)
说明安装成功，这个信息非常重要

./waf--run hello-simulator


出现"Hello Simulator"信息，恭喜你现在正式成为ns3的用户(若没有出现"Hello Simulator"，请确定waf构建是否使用-d debug)