-
Notifications
You must be signed in to change notification settings - Fork 6
/
Copy pathREADME
143 lines (109 loc) · 5.67 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
ll-simple-wireless has the following contents:
==============================================
ll-simple-wireless/:
/doc
/examples
/model
wscript
README
ll-simple-wireless/doc:
simple-wireless.rst
ll-simple-wireless/examples:
directional_test.cc
error_model_test.cc
fixed_contention_test.cc
mixed_directional_network.cc
multiple_interface_example.cc
queue_test.cc
wscript
ll-simple-wireless/model:
drop-head-queue.cc
drop-head-queue.h
priority-queue.cc
priority-queue.h
simple-wireless-channel.cc
simple-wireless-channel.h
simple-wireless-net-device.cc
simple-wireless-net-device.h
*** Please refer to the file simple-wireless.rst in the /doc folder for more information about this model.
Installation Instructions
============================================================
(assumes NS3 is already installed; see below for NS3/DCE installation instructions)
1. Modify the NS3 wscript file to include simple-wireless in the build
For example, if using DCE add the following line at ~line 96 in dce/source/ns-3-dce/wscript
ns3waf.check_modules(conf, ['simple-wireless'], mandatory = False)
2. Install the simple wireless in NS3 source using one of these methods:
a) Copy the files directly to the NS3 directory: /src/simple-wireless
OR
b) Use a softlink to your location of ll-simple-wireless to create the NS3 directory /src/simple-wireless
NOTE: the directory from the tar file is named ll_simple_wireless but it is installed in NS3 as simple-wireless
3. Add the simple-wireless as a module in the wscript used to build your NS3 scenario.
For example:
def configure(conf):
ns3waf.check_modules(conf, ['core', 'internet', 'simple-wireless'], mandatory = True)
def build(bld):
bld.build_a_script('dce', needed = ['core', 'internet', 'dce', 'mobility', 'simple-wireless'],
target='bin/my_test_script',
cxxflags=['-std=c++0x'],
source=[ my_test_script.cc'] )
4. Rebuild NS3 being sure to enable examples if you want to run the example models provided with the Simple Wireless model
Miscellaneous Notes
===========================================================
* The Simple Wireless model has been run with NS3.22/DCE1.5, NS3.21/DCE1.4 and NS3.20/DCE1.3
* The PriorityQueue uses libpcap to classify control packets so this must be installed to use priority queues.
Installation Instructions for NS3/DCE
============================================================
The Simple Wireless model works in NS3.20/DCE1.3, NS3.21/DCE1.4 and NS3.22/DCE1.5.
If you have any of these versions currently installed you do not need to install a different version.
The instructions below are for installing NS3.22 and DCE1.5 release but it is not necessary to install
these if you have an earlier, compatible version already installed.
NOTE: It is assumed that DCE will be installed at ~/dce
1. Install Bake from your home directory
hg clone http://code.nsnam.org/bake bake
2. Set path variables
Add the following lines to .profile:
BAKE_HOME="$HOME/bake"
PATH="$PATH:$BAKE_HOME"
PYTHONPATH="/usr/lib/python2.7:$BAKE_HOME"
Execute the .profile:
. .profile
3. Increase file descriptor limit to 2048
To check the current value: $ ulimit –n
To change the current value: $ ulimit –n 2048
4. Create a directory for DCE
mkdir dce
5. Configure, download and build DCE 1.5 (note: this automatically includes ns3.22)
cd dce
bake.py configure -e dce-ns3-1.5
bake.py download [See note below]
bake.py build
During download and build, you may run into missing packages. If so, install them using
sudo apt-get install xxxx (where xxxx is the name of the missing package)
Then after installing re-run the download or build command before proceeding to the next step.
If the gccxml package is missing, the build may complain about pybindgen instead. Install gccxml and the pybindgen problem will probably go away.
To diagnose a build failure, you may need to use the –vvv flag to get more information:
bake.py build -vvv
NOTE: Some of the package names may not match what the dce install says is missing. Examples:
DCE name Actual Install Name
-------------------- -------------------
pybindgen-0.17.0.868 bzr
qt4 qt4-dev-tools
lib_debug libc6-dbg
pygraphviz python-pygraphviz
pygoocanvas python-pygoocanvas
**********************************************************************************************************************************
Distribution Statement
----------------------
Copyright (C) 2015 Massachusetts Institute of Technology
All rights reserved.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2 as
published by the Free Software Foundation;
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
**********************************************************************************************************************************